summaryrefslogtreecommitdiff
path: root/docker/biboumi/README.md
diff options
context:
space:
mode:
authorlouiz’ <louiz@louiz.org>2017-04-21 11:49:23 +0200
committerlouiz’ <louiz@louiz.org>2017-04-21 11:49:23 +0200
commit3666f35e0e884068437fe520dbd5f087bea4d946 (patch)
tree951b20bbd3bbe56fadccf4b6eb8c51f23a9d8882 /docker/biboumi/README.md
parenteac144acdaca02f018bddde5f623fba3e8cd4ad9 (diff)
downloadbiboumi-3666f35e0e884068437fe520dbd5f087bea4d946.tar.gz
biboumi-3666f35e0e884068437fe520dbd5f087bea4d946.tar.bz2
biboumi-3666f35e0e884068437fe520dbd5f087bea4d946.tar.xz
biboumi-3666f35e0e884068437fe520dbd5f087bea4d946.zip
Use alpine for the docker image, and simplify the config + run stuff
Using env variable directly used by the process, it’s easier than calling sed on the configuration file before we start the process. Also we don’t need to start as root anymore, and it’s a lot cleaner.
Diffstat (limited to 'docker/biboumi/README.md')
-rw-r--r--docker/biboumi/README.md16
1 files changed, 11 insertions, 5 deletions
diff --git a/docker/biboumi/README.md b/docker/biboumi/README.md
index e69c1b0..4b9e1e5 100644
--- a/docker/biboumi/README.md
+++ b/docker/biboumi/README.md
@@ -32,14 +32,12 @@ docker run --network=host \
Variables
---------
-The configuration file inside the image is a template that is completed when the container is started, using the following environment variables:
+The configuration file inside the image contains only a few default values. To be able to run, biboumi needs additional configuration. Additional options can be passed using environment variables. Any configuration option can be customized this way (see biboumi’s doc), but the main are listed here for convenience:
* BIBOUMI_HOSTNAME: Sets the value of the *hostname* option.
-* BIBOUMI_SECRET: Sets the value of the *password* option.
+* BIBOUMI_PASSWORD: Sets the value of the *password* option.
* BIBOUMI_ADMIN: Sets the value of the *admin* option.
-* BIBOUMI_XMPP_SERVER_IP: Sets the value of the *xmpp_server_ip* option. The default is **xmpp**.
-
-All these variables are optional, but biboumi will probably fail to start if the hostname and secret are missing.
+* BIBOUMI_XMPP_SERVER_IP: Sets the value of the *xmpp_server_ip* option. The default value is **xmpp**.
You can also directly provide your own configuration file by mounting it inside the container using the -v option:
@@ -49,6 +47,8 @@ docker run --link prosody:xmpp \
biboumi
```
+If both a custom configuration file and custom environment variables are passed to the container, the environment variables will take precedence.
+
Linking with the XMPP server
----------------------------
@@ -60,3 +60,9 @@ Volumes
-------
The database is stored in the /var/lib/biboumi/ directory. If you don’t bind a local directory to it, the database will be lost when the container is stopped. If you want to keep your database between each run, bind it with the -v option, like this: **-v /srv/biboumi/:/var/lib/biboumi**.
+
+Note: Due to a limitation in Docker, to be able to read and write into this database, make sure this mounted directory is owned by UID and GID 1001:1001, on the host.
+
+```
+chown -R 1001:1001 database/
+```