From 084fdc40253aeb20694178fd85e438dd4364e945 Mon Sep 17 00:00:00 2001 From: Jeremy Lin Date: Mon, 6 Jul 2020 22:38:09 -0700 Subject: [PATCH] add section on customizing container startup --- Starting-a-Container.md | 31 ++++++++++++++++++++++++++++++- 1 file changed, 30 insertions(+), 1 deletion(-) diff --git a/Starting-a-Container.md b/Starting-a-Container.md index 1c3d0dd..166aba9 100644 --- a/Starting-a-Container.md +++ b/Starting-a-Container.md @@ -32,4 +32,33 @@ docker run -d --name bitwarden -v /bw-data/:/data/ -p 192.168.0.2:80:80 bitwarde If the container has been stopped by `docker stop bitwarden`, a reboot or any other reason you can just start it up again by using ``` docker start bitwarden -``` \ No newline at end of file +``` + +# Customizing container startup + +If you have custom startup script(s) you want to run when the container starts, you can mount a single script into the container as `/etc/bitwarden_rs.sh` and/or a directory of scripts as `/etc/bitwarden_rs.d`. In the latter case, only files with an `.sh` extension are run, so files with other extensions (e.g., data/config files) can reside in the same dir. (See [start.sh](https://github.com/dani-garcia/bitwarden_rs/blob/master/docker/start.sh) for details on exactly how it works.) + +A custom startup script can be useful for patching web vault files or installing additional packages, CA certificates, etc. without having to build and maintain your own Docker image. + +## Example + +Suppose your script is named `init.sh` and contains the following: +``` +echo "starting up" +``` + +You can run the script on startup like this: +``` +docker run -d --name bitwarden -v $(pwd)/init.sh:/etc/bitwarden_rs.sh bitwardenrs/server:latest +``` + +If you run `docker logs bitwarden`, you should now see `starting up` as the first line of the output. + +Note that the init scripts are run each time the container starts (not just the first time), so these scripts should generally be idempotent (i.e., you can run the scripts more than once without undesirable/erroneous behavior). If your scripts don't naturally have this property, you can do something like this: +``` +if [ ! -e /.init ]; then + touch /.init + + # run your init steps... +fi +```