dockerbunker
is a tool that helps configure, deploy and manage dockerized web-applications or static sites behind an nginx reverse proxy. Apps can easily be fully backed up or restored from a previous backup. The only requirement is docker.
-
Docker
-
Bash 4+
On macOS via homebrew
- Bash 4+ ->
brew install bash
- GNU grep ->
brew install grep --with-default-names
- GNU sed ->
brew install gnu-sed --default-names
- Bash 4+ ->
-
Get docker
- Most systems can install Docker by running
wget -qO- https://get.docker.com/ | sh
- Most systems can install Docker by running
-
Clone the master branch of this repository and run
./dockerbunker.sh
git clone https://github.com/chaosbunker/dockerbunker.git && cd dockerbunker
./dockerbunker.sh
-
Select a service and configure it (Set domain, etc..)
-
Set up the service. This will
- Create an internal network if necessary
- Create volumes
- Pull or buld images
- Run containers
- Obtain certificate from Let's Encrypt (if chosen during config)
That's it.
Now when selecting the same service again in the dockerbunker menu, there will be more options depending on the current state of the service. For example:
Nextcloud
1) Reconfigure service
2) Reinstall service
3) Obtain Let's Encrypt certificate (<-- only visible if using self-signed cert)
4) Restart container(s)
5) Stop container(s) (<- only visible when containers are running, otherwise offers "Start Containers"
6) Backup Service
7) Restore Service (<- only visible if backup(s) for service are found)
8) Upgrade Image(s)
9) Destroy "Nextcloud"
When destroying a service everything related to the service will be removed. Only Let's Encrypt certificates will be retained.
When configuring a service, a self-signed certificate is generated and stored in data/conf/nginx/ssl/${SERVICE_HOSTNAME}
. Please move your own trusted certificate and key in that directory as cert.pem
and key.pem
after configuration of the service is complete.
If you choose to use Let's Encrypt during setup, certificates will be automatically obtained via a Certbot container. Let's Encrypt data is stored in data/conf/nginx/ssl/letsencrypt
.
It is possible to add additional domains to the certificate before obtaining the certificate and these domains will also automatically be added to the corresponding nginx configuration.
When backing up a service, a timestamped directory will be created in data/backup/${SERVICE_NAME}
. The following things will get backed up into (or restored from) that directory:
- All volumes (will be compressed)
- nginx configuration if service is accessible via web (from data/conf/nginx/conf.d/${SERVICE_DOMAIN})
- other user-specific configuration files (from data/conf/${SERVICE_NAME})
- environment file(s) (from data/env/${SERVICE_NAME}*)
- ssl certificate" (from data/conf/nginx/ssl/${SERVICE_DOMAIN} and, if applicable data/conf/nginx/ssl/letsencrypt)
All credentials that are set by the user or that are automatically generated are stored in data/env/${SERVICE_NAME}.env.
Please refer to the documentation of each web-app (regarding default credentials, configuration etc.)
I know that it is not really ideal and recommended to do something like this with bash alone. dockerbunker
is an idea that went a bit out of control. It was inspired by @DFabric's DPlatform-DockerShip. You can read more about why I made dockerbunker here (tl;dr: I enjoyed the process)
Important: Please make sure you agree with the license(s) of the open source software you are installing via dockerbunker. Any part of dockerbunker itself is released under the MIT License.