|  | @@ -5,12 +5,12 @@
 | 
	
		
			
				|  |  |  [](http://microbadger.com/images/osixia/openldap "Get your own image badge on microbadger.com")
 | 
	
		
			
				|  |  |  [hub]: https://hub.docker.com/r/osixia/openldap/
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -Latest release: 1.1.6 - OpenLDAP 2.4.40 -  [Changelog](CHANGELOG.md) | [Docker Hub](https://hub.docker.com/r/osixia/openldap/) 
 | 
	
		
			
				|  |  | +Latest release: 1.1.7 - OpenLDAP 2.4.40 -  [Changelog](CHANGELOG.md) | [Docker Hub](https://hub.docker.com/r/osixia/openldap/) 
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  **A docker image to run OpenLDAP.**
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -Note: 
 | 
	
		
			
				|  |  | - - In the latest release 1.1.6 files `*.yaml.startup` have been renamed to `*.startup.yaml`
 | 
	
		
			
				|  |  | +Note:
 | 
	
		
			
				|  |  | + - In the release 1.1.6 files `*.yaml.startup` have been renamed to `*.startup.yaml`
 | 
	
		
			
				|  |  |   - Due to issues #44 and #73 versions before 1.1.6 are not considered as stable and tags will be removed from docker hub.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  > OpenLDAP website : [www.openldap.org](http://www.openldap.org/)
 | 
	
	
		
			
				|  | @@ -39,7 +39,7 @@ Note:
 | 
	
		
			
				|  |  |  		- [Link environment file](#link-environment-file)
 | 
	
		
			
				|  |  |  		- [Make your own image or extend this image](#make-your-own-image-or-extend-this-image)
 | 
	
		
			
				|  |  |  - [Advanced User Guide](#advanced-user-guide)
 | 
	
		
			
				|  |  | -	- [Extend osixia/openldap:1.1.6 image](#extend-osixiaopenldap116-image)
 | 
	
		
			
				|  |  | +	- [Extend osixia/openldap:1.1.7 image](#extend-osixiaopenldap117-image)
 | 
	
		
			
				|  |  |  	- [Make your own openldap image](#make-your-own-openldap-image)
 | 
	
		
			
				|  |  |  	- [Tests](#tests)
 | 
	
		
			
				|  |  |  	- [Kubernetes](#kubernetes)
 | 
	
	
		
			
				|  | @@ -57,7 +57,7 @@ If you find this image useful here's how you can help:
 | 
	
		
			
				|  |  |  ## Quick Start
 | 
	
		
			
				|  |  |  Run OpenLDAP docker image:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -	docker run --name my-openldap-container --detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	docker run --name my-openldap-container --detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  This start a new container with OpenLDAP running inside. Let's make the first search in our LDAP container:
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -93,7 +93,7 @@ It will create an empty ldap for the company **Example Inc.** and the domain **e
 | 
	
		
			
				|  |  |  By default the admin has the password **admin**. All those default settings can be changed at the docker command line, for example:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	docker run --env LDAP_ORGANISATION="My Company" --env LDAP_DOMAIN="my-company.com" \
 | 
	
		
			
				|  |  | -	--env LDAP_ADMIN_PASSWORD="JonSn0w" --detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	--env LDAP_ADMIN_PASSWORD="JonSn0w" --detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  #### Data persistence
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -118,7 +118,7 @@ simply mount this directories as a volume to `/var/lib/ldap` and `/etc/ldap/slap
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	docker run --volume /data/slapd/database:/var/lib/ldap \
 | 
	
		
			
				|  |  |  	--volume /data/slapd/config:/etc/ldap/slapd.d
 | 
	
		
			
				|  |  | -	--detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	--detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  You can also use data volume containers. Please refer to:
 | 
	
		
			
				|  |  |  > [https://docs.docker.com/userguide/dockervolumes/](https://docs.docker.com/userguide/dockervolumes/)
 | 
	
	
		
			
				|  | @@ -138,7 +138,7 @@ If you are looking for a simple solution to administrate your ldap server you ca
 | 
	
		
			
				|  |  |  #### Use auto-generated certificate
 | 
	
		
			
				|  |  |  By default TLS is enable, a certificate is created with the container hostname (it can be set by docker run --hostname option eg: ldap.example.org).
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -	docker run --hostname ldap.my-company.com --detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	docker run --hostname ldap.my-company.com --detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  #### Use your own certificate
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -148,24 +148,24 @@ You can set your custom certificate at run time, by mounting a directory contain
 | 
	
		
			
				|  |  |  	--env LDAP_TLS_CRT_FILENAME=my-ldap.crt \
 | 
	
		
			
				|  |  |  	--env LDAP_TLS_KEY_FILENAME=my-ldap.key \
 | 
	
		
			
				|  |  |  	--env LDAP_TLS_CA_CRT_FILENAME=the-ca.crt \
 | 
	
		
			
				|  |  | -	--detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	--detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Other solutions are available please refer to the [Advanced User Guide](#advanced-user-guide)
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  #### Disable TLS
 | 
	
		
			
				|  |  |  Add --env LDAP_TLS=false to the run command:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -	docker run --env LDAP_TLS=false --detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	docker run --env LDAP_TLS=false --detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  ### Multi master replication
 | 
	
		
			
				|  |  |  Quick example, with the default config.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	#Create the first ldap server, save the container id in LDAP_CID and get its IP:
 | 
	
		
			
				|  |  | -	LDAP_CID=$(docker run --hostname ldap.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.1.6)
 | 
	
		
			
				|  |  | +	LDAP_CID=$(docker run --hostname ldap.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.1.7)
 | 
	
		
			
				|  |  |  	LDAP_IP=$(docker inspect -f "{{ .NetworkSettings.IPAddress }}" $LDAP_CID)
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	#Create the second ldap server, save the container id in LDAP2_CID and get its IP:
 | 
	
		
			
				|  |  | -	LDAP2_CID=$(docker run --hostname ldap2.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.1.6)
 | 
	
		
			
				|  |  | +	LDAP2_CID=$(docker run --hostname ldap2.example.org --env LDAP_REPLICATION=true --detach osixia/openldap:1.1.7)
 | 
	
		
			
				|  |  |  	LDAP2_IP=$(docker inspect -f "{{ .NetworkSettings.IPAddress }}" $LDAP2_CID)
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	#Add the pair "ip hostname" to /etc/hosts on each containers,
 | 
	
	
		
			
				|  | @@ -201,7 +201,7 @@ You may have some problems with mounted files on some systems. The startup scrip
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  To fix that run the container with `--copy-service` argument :
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -		docker run [your options] osixia/openldap:1.1.6 --copy-service
 | 
	
		
			
				|  |  | +		docker run [your options] osixia/openldap:1.1.7 --copy-service
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  ### Debug
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -210,11 +210,11 @@ Available levels are: `none`, `error`, `warning`, `info`, `debug` and `trace`.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Example command to run the container in `debug` mode:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -	docker run --detach osixia/openldap:1.1.6 --loglevel debug
 | 
	
		
			
				|  |  | +	docker run --detach osixia/openldap:1.1.7 --loglevel debug
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  See all command line options:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -	docker run osixia/openldap:1.1.6 --help
 | 
	
		
			
				|  |  | +	docker run osixia/openldap:1.1.7 --help
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  ## Environment Variables
 | 
	
	
		
			
				|  | @@ -252,11 +252,11 @@ Backend:
 | 
	
		
			
				|  |  |  	Help: http://www.openldap.org/doc/admin24/backends.html
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  TLS options:
 | 
	
		
			
				|  |  | -- **LDAP_TLS**: Add openldap TLS capabilities. Can't be removed once set to true. Defaults to `true`. 
 | 
	
		
			
				|  |  | +- **LDAP_TLS**: Add openldap TLS capabilities. Can't be removed once set to true. Defaults to `true`.
 | 
	
		
			
				|  |  |  - **LDAP_TLS_CRT_FILENAME**: Ldap ssl certificate filename. Defaults to `ldap.crt`
 | 
	
		
			
				|  |  |  - **LDAP_TLS_KEY_FILENAME**: Ldap ssl certificate private key filename. Defaults to `ldap.key`
 | 
	
		
			
				|  |  |  - **LDAP_TLS_CA_CRT_FILENAME**: Ldap ssl CA certificate  filename. Defaults to `ca.crt`
 | 
	
		
			
				|  |  | -- **LDAP_TLS_ENFORCE**: Enforce TLS. Can't be disabled once set to true. Defaults to `false`. 
 | 
	
		
			
				|  |  | +- **LDAP_TLS_ENFORCE**: Enforce TLS. Can't be disabled once set to true. Defaults to `false`.
 | 
	
		
			
				|  |  |  - **LDAP_TLS_CIPHER_SUITE**: TLS cipher suite. Defaults to `SECURE256:+SECURE128:-VERS-TLS-ALL:+VERS-TLS1.2:-RSA:-DHE-DSS:-CAMELLIA-128-CBC:-CAMELLIA-256-CBC`, based on Red Hat's [TLS hardening guide](https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Security_Guide/sec-Hardening_TLS_Configuration.html)
 | 
	
		
			
				|  |  |  - **LDAP_TLS_VERIFY_CLIENT**: TLS verify client. Defaults to `demand`
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -277,7 +277,7 @@ Replication options:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	If you want to set this variable at docker run command add the tag `#PYTHON2BASH:` and convert the yaml in python:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -		docker run --env LDAP_REPLICATION_HOSTS="#PYTHON2BASH:['ldap://ldap.example.org','ldap://ldap2.example.org']" --detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +		docker run --env LDAP_REPLICATION_HOSTS="#PYTHON2BASH:['ldap://ldap.example.org','ldap://ldap2.example.org']" --detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	To convert yaml to python online: http://yaml-online-parser.appspot.com/
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -292,7 +292,7 @@ Other environment variables:
 | 
	
		
			
				|  |  |  Environment variables can be set by adding the --env argument in the command line, for example:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	docker run --env LDAP_ORGANISATION="My company" --env LDAP_DOMAIN="my-company.com" \
 | 
	
		
			
				|  |  | -	--env LDAP_ADMIN_PASSWORD="JonSn0w" --detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	--env LDAP_ADMIN_PASSWORD="JonSn0w" --detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Be aware that environment variable added in command line will be available at any time
 | 
	
		
			
				|  |  |  in the container. In this example if someone manage to open a terminal in this container
 | 
	
	
		
			
				|  | @@ -303,14 +303,14 @@ he will be able to read the admin password in clear text from environment variab
 | 
	
		
			
				|  |  |  For example if your environment files **my-env.yaml** and **my-env.startup.yaml** are in /data/ldap/environment
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	docker run --volume /data/ldap/environment:/container/environment/01-custom \
 | 
	
		
			
				|  |  | -	--detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	--detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Take care to link your environment files folder to `/container/environment/XX-somedir` (with XX < 99 so they will be processed before default environment files) and not  directly to `/container/environment` because this directory contains predefined baseimage environment files to fix container environment (INITRD, LANG, LANGUAGE and LC_CTYPE).
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Note: the container will try to delete the **\*.startup.yaml** file after the end of startup files so the file will also be deleted on the docker host. To prevent that : use --volume /data/ldap/environment:/container/environment/01-custom**:ro** or set all variables in **\*.yaml** file and don't use **\*.startup.yaml**:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	docker run --volume /data/ldap/environment/my-env.yaml:/container/environment/01-custom/env.yaml \
 | 
	
		
			
				|  |  | -	--detach osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	--detach osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  #### Make your own image or extend this image
 | 
	
		
			
				|  |  |  
 | 
	
	
		
			
				|  | @@ -318,13 +318,13 @@ This is the best solution if you have a private registry. Please refer to the [A
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  ## Advanced User Guide
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -### Extend osixia/openldap:1.1.6 image
 | 
	
		
			
				|  |  | +### Extend osixia/openldap:1.1.7 image
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  If you need to add your custom TLS certificate, bootstrap config or environment files the easiest way is to extends this image.
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  Dockerfile example:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  | -	FROM osixia/openldap:1.1.6
 | 
	
		
			
				|  |  | +	FROM osixia/openldap:1.1.7
 | 
	
		
			
				|  |  |  	MAINTAINER Your Name <[email protected]>
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	ADD bootstrap /container/service/slapd/assets/config/bootstrap
 | 
	
	
		
			
				|  | @@ -346,7 +346,7 @@ Clone this project:
 | 
	
		
			
				|  |  |  Adapt Makefile, set your image NAME and VERSION, for example:
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	NAME = osixia/openldap
 | 
	
		
			
				|  |  | -	VERSION = 1.1.6
 | 
	
		
			
				|  |  | +	VERSION = 1.1.7
 | 
	
		
			
				|  |  |  
 | 
	
		
			
				|  |  |  	become:
 | 
	
		
			
				|  |  |  	NAME = cool-guy/openldap
 |