{"id":18289877,"url":"https://github.com/tiredofit/docker-fusiondirectory","last_synced_at":"2025-04-05T09:31:50.168Z","repository":{"id":47515016,"uuid":"101310779","full_name":"tiredofit/docker-fusiondirectory","owner":"tiredofit","description":"Dockerized web based LDAP manager","archived":false,"fork":false,"pushed_at":"2023-12-09T01:25:36.000Z","size":467,"stargazers_count":50,"open_issues_count":22,"forks_count":19,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-21T02:22:07.030Z","etag":null,"topics":["docker","fusiondirectory","ldap","ldap-authentication","openldap"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tiredofit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":["tiredofit"]}},"created_at":"2017-08-24T15:32:49.000Z","updated_at":"2025-01-11T05:59:00.000Z","dependencies_parsed_at":"2023-12-05T19:46:32.034Z","dependency_job_id":null,"html_url":"https://github.com/tiredofit/docker-fusiondirectory","commit_stats":null,"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-fusiondirectory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-fusiondirectory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-fusiondirectory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tiredofit%2Fdocker-fusiondirectory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tiredofit","download_url":"https://codeload.github.com/tiredofit/docker-fusiondirectory/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247318315,"owners_count":20919457,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","fusiondirectory","ldap","ldap-authentication","openldap"],"created_at":"2024-11-05T14:08:39.958Z","updated_at":"2025-04-05T09:31:48.957Z","avatar_url":"https://github.com/tiredofit.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/tiredofit","https://www.paypal.me/tiredofit"],"categories":[],"sub_categories":[],"readme":"# github.com/tiredofit/docker-fusiondirectory\n\n[![GitHub release](https://img.shields.io/github/v/tag/tiredofit/docker-fusiondirectory?style=flat-square)](https://github.com/tiredofit/docker-fusiondirectory/releases/latest)\n[![Build Status](https://img.shields.io/github/workflow/status/tiredofit/docker-fusiondirectory/build?style=flat-square)](https://github.com/tiredofit/docker-fusiondirectory/actions?query=workflow%3Abuild)\n[![Docker Stars](https://img.shields.io/docker/stars/tiredofit/fusiondirectory.svg?style=flat-square\u0026logo=docker)](https://hub.docker.com/r/tiredofit/fusiondirectory/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/tiredofit/fusiondirectory.svg?style=flat-square\u0026logo=docker)](https://hub.docker.com/r/tiredofit/fusiondirectory/)\n[![Become a sponsor](https://img.shields.io/badge/sponsor-tiredofit-181717.svg?logo=github\u0026style=flat-square)](https://github.com/sponsors/tiredofit)\n[![Paypal Donate](https://img.shields.io/badge/donate-paypal-00457c.svg?logo=paypal\u0026style=flat-square)](https://www.paypal.me/tiredofit)\n\n* * *\n\n\n## About\n\nThis will build a Docker Image for [Fusion Directory](https://www.fusiondirectory.org/) - an LDAP frontend.\n\n## Maintainer\n\n- [Dave Conroy](https://github.com/tiredofit)\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Authors](#authors)\n- [Table of Contents](#table-of-contents)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n  - [Quick Start](#quick-start)\n- [Configuration](#configuration)\n  - [Persistent Storage](#persistent-storage)\n  - [Environment Variables](#environment-variables)\n    - [Plugins](#plugins)\n  - [Networking](#networking)\n- [Maintenance](#maintenance)\n  - [Shell Access](#shell-access)\n- [References](#references)\n\n## Prerequisites and Assumptions\n\nYou must have use the accompanying  image with matching version number for the correct schema to operate!\n## Prerequisites and Assumptions\n*  Assumes you are using some sort of SSL terminating reverse proxy such as:\n   *  [Traefik](https://github.com/tiredofit/docker-traefik)\n   *  [Nginx](https://github.com/jc21/nginx-proxy-manager)\n   *  [Caddy](https://github.com/caddyserver/caddy)\n* Require - Access to an LDAP Server w/ necessary fusiondirectory schemas loaded. - See [openldap-fusiondirectory](https://tiredofit/openldap-fusiondirectory)\n* Optional - Access to a SMTP Server\n\n\n## Installation\n\n### Build from Source\nClone this repository and build the image with `docker build \u003carguments\u003e (imagename) .`\n\n### Prebuilt Images\nBuilds of the image are available on [Docker Hub](https://hub.docker.com/r/tiredofit/fusiondirectory) and is the recommended method of installation.\n\nThe following image tags are available along with their tagged release based on what's written in the [Changelog](CHANGELOG.md):\n\n| Version | Container OS | Tag       |\n| ------- | ------------ | --------- |\n| 1.3     | Alpine       | `:latest` |\n| 1.4-dev | Alpine       | `:1.4`    |\n\n#### Multi Archictecture\nImages are built primarily for `amd64` architecture, and may also include builds for `arm/v6`, `arm/v7`, `arm64` and others. These variants are all unsupported. Consider [sponsoring](https://github.com/sponsors/tiredofit) my work so that I can work with various hardware. To see if this image supports multiple architecures, type `docker manifest (image):(tag)`\n\n\n## Configuration\n\n### Quick Start\n\n* The quickest way to get started is using [docker-compose](https://docs.docker.com/compose/). See\nthe examples folder for a working [docker-compose.yml](examples/docker-compose.yml) that can be\nmodified for development or production use.\n\n* Set various [environment variables](#environment-variables) to understand the capabilities of this\nimage.\n* Map [persistent storage](#data-volumes) for access to configuration and data files for backup.\n### Persistent Storage\n\nIf you would like to add custom HTML such as themes into Fusiondirectory map your folder that follows the `/www/fusiondirectory/html` structure into `/assets/fusiondirectory` and the script will overwrite upon bootup.\n\nIf you have custom plugins, map a folder to `/assets/plugins-custom/` and they will be automatically added to the container upon startup.\n\n### Environment Variables\n#### Base Images used\n\nThis image relies on an [Alpine Linux](https://hub.docker.com/r/tiredofit/alpine) or [Debian Linux](https://hub.docker.com/r/tiredofit/debian) base image that relies on an [init system](https://github.com/just-containers/s6-overlay) for added capabilities. Outgoing SMTP capabilities are handlded via `msmtp`. Individual container performance monitoring is performed by [zabbix-agent](https://zabbix.org). Additional tools include: `bash`,`curl`,`less`,`logrotate`,`nano`,`vim`.\n\nBe sure to view the following repositories to understand all the customizable options:\n\n| Image                                                         | Description                            |\n| ------------------------------------------------------------- | -------------------------------------- |\n| [OS Base](https://github.com/tiredofit/docker-alpine/)        | Customized Image based on Alpine Linux |\n| [Nginx](https://github.com/tiredofit/docker-nginx/)           | Nginx webserver                        |\n| [PHP-FPM](https://github.com/tiredofit/docker-nginx-php-fpm/) | PHP Interpreter                        |\n\n\nYou can connect to multiple LDAP servers by setting the following environment variables. Simply Add as many LDAP(x) Variables for the amount of servers you wish to manage.\n\n| Parameter          | Description                                                                                                    | Default                     |\n| ------------------ | -------------------------------------------------------------------------------------------------------------- | --------------------------- |\n| `LDAP1_NAME`       | The instance Name e.g. `production`                                                                            |                             |\n| `LDAP1_HOST`       | Hostname with the openldap-fusiondirectory service running e.g. `openldap-fusiondirectory`                     |                             |\n| `LDAP1_TLS`        | (optional) Use TLS `TRUE` or `FALSE`                                                                           | `FALSE`                     |\n| `LDAP1_SSL`        | (optional) Use SSL (LDAPS) `TRUE` or `FALSE`                                                                   | `FALSE`                     |\n| `LDAP1_PORT`       | (optional) Port number                                                                                         | `389` unless SSL=TRUE `636` |\n| `LDAP1_ADMIN_PASS` | cn=admin,dc=example,dc=org Password e.g. `password`                                                            |                             |\n| `LDAP1_ADMIN_DN`   | The Primary DN to Manage e.g. `cn=admin,dc=example,dc=org`                                                     |                             |\n| `LDAP1_BASE_DN`    | The Primary Base DN to Manage e.g. `dc=example,dc=org`                                                         |                             |\n| `LDAP2_NAME`       | The Instance Name (e.g. `development`)                                                                         |                             |\n| `LDAP2_HOST`       | The Second Domain Hostname with the openldap-fusiondirectory service running (e.g. `openldap-fusiondirectory`) |                             |\n| `LDAP2_SSL`        | Use SSL (LDAPS) `TRUE` or `FALSE`                                                                              | `false`                     |\n| `LDAP2_TLS`        | (optional) Use TLS `TRUE` or `FALSE`                                                                           | `false`                     |\n| `LDAP2_PORT`       | (optional) Port number                                                                                         | `389` unless TLS=TRUE `636` |\n| `LDAP2_ADMIN_PASS` | cn=admin,dc=example,dc=org Password e.g. `password`                                                            |                             |\n| `LDAP2_ADMIN_DN`   | The second Admin DN e.g. `cn=admin,dc=example,dc=org`                                                          |                             |\n| `LDAP2_BASE_DN`    | The second BASE DN e.g. `dc=example,dc=org`                                                                    |                             |\n| `LDAP_DEFAULT`     | The Default Instance to show on Login Page e.g. `production` - Default `LDAP1_NAME`                            |                             |\n\n#### Plugins\n\nEnable various plugins. Please see the FusionDirectory Site for configuration options. Depending on the Plugin enabled, various dependent plugins will automatically be installed. **Note you must have the schema's installed on the LDAP server otherwise you will face errors!\n\n| Parameter                        | Description                                                              | Default     |\n| -------------------------------- | ------------------------------------------------------------------------ | ----------- |\n| `ENABLE_ARGONAUT`                | Enable Argonaut Server                                                   | `FALSE`     |\n| `ENABLE_AUDIT_LOG_CLEANUP`       | Enable scheduled Audit Log Cleanups - Default `TRUE` if plugin enabled   |             |\n| `ENABLE_USER_REMINDER`           | Enable scheduled User Reminder emails - Default `TRUE` if plugin enabled |             |\n| `AUDIT_LOG_CLEANUP_CRON_EXP`     | Cron expression for when to run Audit log cleanup                        | `0 0 * * *` |\n| `USER_REMINDER_CLEANUP_CRON_EXP` | Cron expression for when to send user reminder emails log cleanup        | `0 0 * * *` |\n| `PLUGIN_ALIAS`                   | Mail Aliases                                                             | `FALSE`     |\n| `PLUGIN_APPLICATIONS`            | Applications                                                             | `FALSE`     |\n| `PLUGIN_ARGONAUT`                | Argonaut                                                                 | `FALSE`     |\n| `PLUGIN_AUDIT`                   | Audit Trail                                                              | `FALSE`     |\n| `PLUGIN_AUTOFS`                  | AutoFS                                                                   | `FALSE`     |\n| `PLUGIN_CERTIFICATES`            | Manage Certificates                                                      | `FALSE`     |\n| `PLUGIN_COMMUNITY`               | Community Plugin                                                         | `FALSE`     |\n| `PLUGIN_CYRUS`                   | Cyrus IMAP                                                               | `FALSE`     |\n| `PLUGIN_DEBCONF`                 | Argonaut Debconf                                                         | `FALSE`     |\n| `PLUGIN_DEVELOPERS`              | Developers Plugin                                                        | `FALSE`     |\n| `PLUGIN_DHCP`                    | Manage DHCP                                                              | `FALSE`     |\n| `PLUGIN_DNS`                     | Manage DNS                                                               | `FALSE`     |\n| `PLUGIN_DOVECOT`                 | Dovecot IMAP                                                             | `FALSE`     |\n| `PLUGIN_DSA`                     | System Accounts                                                          | `FALSE`     |\n| `PLUGIN_EJBCA`                   | Unknown                                                                  | `FALSE`     |\n| `PLUGIN_FAI`                     | Unknown                                                                  | `FALSE`     |\n| `PLUGIN_FREERADIUS`              | FreeRadius Management                                                    | `FALSE`     |\n| `PLUGIN_FUSIONINVENTORY`         | Inventory Plugin                                                         | `FALSE`     |\n| `PLUGIN_GPG`                     | Manage GPG Keys                                                          | `FALSE`     |\n| `PLUGIN_IPMI`                    | IPMI Management                                                          | `FALSE`     |\n| `PLUGIN_Kopano`                  | Kopano Core Groupware Server                                             | `FALSE`     |\n| `PLUGIN_LDAPDUMP`                | LDAP Attribute Export                                                    | `FALSE`     |\n| `PLUGIN_LDAPMANAGER`             | Import/Export CSV/LDIF                                                   | `FALSE`     |\n| `PLUGIN_MAIL`                    | Mail Attributes                                                          | `FALSE`     |\n| `PLUGIN_MIXEDGROUPS`             | Unix/LDAP Groups                                                         | `FALSE`     |\n| `PLUGIN_NAGIOS`                  | Nagios Monitoring                                                        | `FALSE`     |\n| `PLUGIN_NETGROUPS`               | NIS                                                                      | `FALSE`     |\n| `PLUGIN_NEXTCLOUD`               | Nextcloud Server                                                         | `FALSE`     |\n| `PLUGIN_NEWSLETTER`              | Manage Newsletters                                                       | `FALSE`     |\n| `PLUGIN_OPSI`                    | Inventory                                                                | `FALSE`     |\n| `PLUGIN_PERSONAL`                | Personal Details                                                         | `FALSE`     |\n| `PLUGIN_POSIX`                   | Posix Groups                                                             | `FALSE`     |\n| `PLUGIN_POSTFIX`                 | Postfix SMTP                                                             | `FALSE`     |\n| `PLUGIN_PPOLICY`                 | Password Policy                                                          | `FALSE`     |\n| `PLUGIN_PUPPET`                  | Puppet CI                                                                | `FALSE`     |\n| `PLUGIN_PUREFTPD`                | FTP Server                                                               | `FALSE`     |\n| `PLUGIN_QUOTA`                   | Manage Quotas                                                            | `FALSE`     |\n| `PLUGIN_RENATER_PARTAGE`         | Unknown                                                                  | `FALSE`     |\n| `PLUGIN_REPOSITORY`              | Argonaut Deployment Registry                                             | `FALSE`     |\n| `PLUGIN_SAMBA`                   | File Sharing                                                             | `FALSE`     |\n| `PLUGIN_SEAFILE`                 | Seafile Server                                                           | `FALSE`     |\n| `PLUGIN_SOGO`                    | Groupware                                                                | `FALSE`     |\n| `PLUGIN_SPAMASSASSIN`            | Anti Spam                                                                | `FALSE`     |\n| `PLUGIN_SQUID`                   | Proxy                                                                    | `FALSE`     |\n| `PLUGIN_SSH`                     | Manage SSH Keys                                                          | `FALSE`     |\n| `PLUGIN_SUBCONTRACTING`          | Unknown                                                                  | `FALSE`     |\n| `PLUGIN_SUDO`                    | Manage SUDO on Hosts                                                     | `FALSE`     |\n| `PLUGIN_SUPANN`                  | SUPANN                                                                   | `FALSE`     |\n| `PLUGIN_SYMPA`                   | Sympa Mailing List                                                       | `FALSE`     |\n| `PLUGIN_SYSTEMS`                 | Systems Management                                                       | `FALSE`     |\n| `PLUGIN_USER_REMINDER`           | Password Expiry                                                          | `FALSE`     |\n| `PLUGIN_WEBLINK`                 | Display Weblink                                                          | `FALSE`     |\n\n### Networking\n\nThe following ports are exposed.\n\n| Port | Description |\n| ---- | ----------- |\n| `80` | HTTP        |\n\n\n* * *\n## Maintenance\n\n### Shell Access\n\nFor debugging and maintenance purposes you may want access the containers shell.\n\n``bash\ndocker exec -it (whatever your container name is) bash\n``\n## Support\n\nThese images were built to serve a specific need in a production environment and gradually have had more functionality added based on requests from the community.\n### Usage\n- The [Discussions board](../../discussions) is a great place for working with the community on tips and tricks of using this image.\n- Consider [sponsoring me](https://github.com/sponsors/tiredofit) personalized support.\n### Bugfixes\n- Please, submit a [Bug Report](issues/new) if something isn't working as expected. I'll do my best to issue a fix in short order.\n\n### Feature Requests\n- Feel free to submit a feature request, however there is no guarantee that it will be added, or at what timeline.\n- Consider [sponsoring me](https://github.com/sponsors/tiredofit) regarding development of features.\n\n### Updates\n- Best effort to track upstream changes, More priority if I am actively using the image in a production environment.\n- Consider [sponsoring me](https://github.com/sponsors/tiredofit) for up to date releases.\n\n## License\nMIT. See [LICENSE](LICENSE) for more details.## References\n\n\n## References\n\n* https://www.fusiondirectory.org/\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiredofit%2Fdocker-fusiondirectory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftiredofit%2Fdocker-fusiondirectory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftiredofit%2Fdocker-fusiondirectory/lists"}