ldap/README.md

39 lines
845 B
Markdown
Raw Normal View History

2017-09-09 17:54:45 +02:00
## slapd
Slapd offers a LDAP server, which we mostly use for authentication of various
services.
Therefore, a lot of services have a direct (or indirect) dependency on this
image.
### Building slapd
```
2019-04-18 20:59:51 +02:00
docker build -t zombi/ldap .
2017-09-09 17:54:45 +02:00
```
### Running slapd
2019-04-18 20:59:51 +02:00
Copy over example configuration
```bash
cp docker-compose.yml{.example,}
```
run the service
2017-09-09 17:54:45 +02:00
```
2019-04-18 20:59:51 +02:00
docker-compose up -d
2017-09-09 17:54:45 +02:00
```
### Backing up data
Data in this container is considered essential, since it influences almost
all other services we run.
We recently discovered that **simply copying all the data from `data` DOES
NOT WORK**, therefore we included scripts for backing up the slapd database
into a compact .ldif format.
running `tools/create-ldap-backup.sh` will create two files:
* `conf.ldif` is a backup of the configuration.
* `data.ldif` contains all the saved datasets.