dockerbunker

What is dockerbunker

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.

Currently included:

A - G	H - O	P - Z
Bitbucket	Hastebin	Padlock Cloud
cryptpad	IPsec VPN Server	Piwik
CS50 IDE	json-server	Rocket.Chat
Dillinger	Kanboard	Seafile Pro
Ghost Blog	Mailcow Dockerized	Searx
Gitea	Mailpile	Mozilla send
Gitlab CE	Mastodon (+ Glitch Edition)	sFTP Server
Gogs	Nextcloud	Wekan
	Open Project	Wordpress

How to get started:

1. Get docker

   • Most systems can install Docker by running wget -qO- https://get.docker.com/ | sh

2. Clone the master branch of this repository and run ./dockerbunker.sh

   • git clone https://github.com/chaosbunker/dockerbunker.git && cd dockerbunker
   • ./dockerbunker.sh

3. Select a service and configure it (Set domain, etc..)

4. 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.

SSL

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.

Backup & Restore

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)

Good to know:

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.)

Why I made this

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.