Skip to content

Latest commit

 

History

History
52 lines (39 loc) · 3.42 KB

README.md

File metadata and controls

52 lines (39 loc) · 3.42 KB

Repositories

Why use this container?

Simply put, this container has been written with simplicity and security in mind.

Many community containers run unnecessarily with root privileges by default and don't provide help for dropping unneeded CAPabilities either. On top of that, overly complex shell scripts, monolithic designs and unofficial base images make it harder to verify the source among other issues.

To remedy the situation, these images have been written with security, simplicity and overall quality in mind.

Requirement Status Details
Don't run as root Never run as root unless necessary.
Transparent build process For verifying that the container matches the code. See GitLab CI.
Official base image
Healthcheck configured
Drop extra CAPabilities See docker-compose.yml
No default passwords No static default passwords. That would make the container insecure by default.
Support secrets-files Support providing e.g. passwords via files instead of environment variables.
Handle signals properly
Simple Dockerfile No overextending container's responsibilities. Keep everything in the Dockerfile if reasonable.
Versioned tags Offer versioned tags for stability.

Running this container

This container only contains phpldapadmin and the necessary PHP (PHP-FPM) packages. In other words, this container only runs the PHP process and no HTTP server (which is how things should be).
You will therefore need an accompanying HTTP server. Luckily, the docker-compose.yml in the source repository contains a complete example of running this container with nginx and will work without additional steps.

Configuration

By default, the configuration files can be found on the named volume and is currently the only way to configure phpldapadmin. See Dockerfile and docker-compose.yml (https://github.com/kalaksi/docker-phpldapadmin) for more details.

Supported tags

See the Tags tab on Docker Hub for specifics. Basically you have:

  • The default latest tag that always has the latest changes.
  • Minor versioned tags (follow Semantic Versioning), e.g. 1.1 which would follow branch 1.1.x on GitHub.

Development

Contributing

See the repository on https://github.com/kalaksi/docker-phpldapadmin. All kinds of contributions are welcome!

License

Copyright (c) 2018 [email protected]. See LICENSE for license information.

As with all Docker images, the built image likely also contains other software which may be under other licenses (such as software from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.