Guide by Example
Go to file
DoTheEvo b1739f097b update 2024-03-29 02:34:29 +01:00
NUT-Network UPS Tools update 2023-07-30 23:05:14 +02:00
arch_linux_host_install update 2022-12-25 13:13:03 +01:00
arch_raspberry_pi update 2023-06-17 20:32:22 +02:00
audiobookshelf update 2023-06-18 14:31:32 +02:00
beginners-speedrun-selfhosting update 2024-03-29 02:34:29 +01:00
bookstack update 2023-06-24 20:11:52 +02:00
borg_backup update 2022-04-03 10:50:12 +02:00
caddy_v2 update 2023-11-11 20:07:58 +01:00
ddclient update 2020-05-22 00:06:39 +02:00
disk_NAS_bench_Fio update 2024-03-29 00:29:18 +01:00
dnsmasq update 2020-06-13 18:51:23 +02:00
docker-basics-and-troubleshoot update 2023-03-05 10:50:50 +01:00
esxi update 2023-04-23 22:34:31 +02:00
free_cloud_hosting_VPS update 2024-03-29 00:29:18 +01:00
frigate update 2024-03-24 14:10:21 +01:00
get_good_linux_terminal update 2024-03-29 00:29:18 +01:00
gotify-ntfy-signal update 2024-01-14 10:43:27 +01:00
home_assistant update 2024-03-05 00:29:47 +01:00
homer update 2020-05-22 18:22:45 +02:00
jellyfin update 2024-03-29 00:29:18 +01:00
kopia_backup update 2023-09-26 23:07:39 +02:00
lubelog update 2024-03-29 00:29:18 +01:00
mealie update 2023-03-13 00:46:50 +01:00
meshcrentral update 2023-01-21 21:48:29 +01:00
mikrotik update 2024-03-29 00:29:18 +01:00
minecraft update 2023-10-10 23:00:10 +02:00
mounting_network_share_linux update 2024-03-29 00:29:18 +01:00
network-knowledge-base update 2023-12-04 20:03:28 +01:00
nextcloud update 2023-02-19 11:40:28 +01:00
opnsense update 2023-12-14 21:57:49 +01:00
phpipam update 2021-12-31 01:35:58 +01:00
port_forwarding_guide update 2023-12-04 20:03:28 +01:00
portainer update 2023-04-01 00:43:34 +02:00
prometheus_grafana_loki update 2023-08-07 18:22:15 +02:00
proxmox update 2023-09-26 23:07:39 +02:00
qbittorrent update 2022-01-17 21:43:12 +01:00
rustdesk update 2023-03-12 09:47:19 +01:00
snipeit update 2022-09-10 00:26:47 +02:00
squid update 2023-08-07 19:16:36 +02:00
syncthing update 2023-07-10 16:53:47 +02:00
trueNASscale update 2023-08-07 18:19:22 +02:00
umami Added docker template for umami postgres 2023-08-05 16:17:38 +08:00
unifi update 2024-03-10 01:35:01 +01:00
uptime-kuma update 2024-01-25 23:53:11 +01:00
vaultwarden Fixed vaultvarden backup script naming 2023-08-03 17:06:18 +08:00
watchtower update 2020-05-22 18:22:45 +02:00
watchyourlan update 2023-10-31 14:30:37 +01:00
wg-easy update 2023-07-10 00:23:35 +02:00
windows_package_managers update 2023-12-04 20:03:28 +01:00
wireguard update 2023-05-14 09:57:59 +02:00
zammad update 2023-06-18 14:31:32 +02:00
README.md update 2024-03-29 00:29:18 +01:00

README.md

Selfhosted-Apps-Docker

guide-by-example

logo


Can also just check the directories listed at the top for work in progress

Check also StarWhiz / docker_deployment_notes
Repo documents self hosted apps in similar format and also uses caddy for reverse proxy



Core concepts

  • docker-compose.yml does not need any editing to get something up, changes are to be done in the .env file.
  • For persistent storage bind mount ./whatever_data is used. No volumes, nor static path somewhere... just relative path next to compose file.
  • No version declaration at the beginning of compose, as the practice was deprecated

Requirements

Basic linux and basic docker-compose knowledge. The shit here is pretty hand holding and detailed, but it still should not be your first time running a docker container.


Caddy reverse proxy

Kinda the heart of the setup is Caddy reverse proxy.
It's described in most details and all guides have reverse proxy section with Caddyfile config specific for them.
Caddy is really great at simplifying the mess of https certificates, where you don't really have to deal with anything, while having a one simple, readable config file.

But no problem if using traefik or nginx proxy manager. You just have to deal with proxy settings on your own, and 90% of the time its just sending traffic to port 80 and nothing else.


Docker network

You really want to create a custom named docker network and use it.

docker network create caddy_net

It can be named whatever, but what it does over default is that it provides automatic DNS resolution between containers. Meaning one can exec in to a container and ping another container by its hostname.
This makes config files simpler and cleaner.


.env

Often the .env file is used as env_file, which can be a bit difficult concept at a first glance.

env_file: .env

  • .env - actual name of a file that is used only by compose.
    It is used automatically just by being in the directory with the docker-compose.yml
    Variables in it are available during the building of a container, but unless named in the environment: option, they are not available once the container is running.
  • env_file - an option in compose that defines an existing external file.
    Variables in this file will be available in the running container, but not during building of the container.

So a compose file having env_file: .env mixes these two together.

Benefit is that you do not need to make changes at multiple places. Adding variables or changing a name in .env does not require you to also go in to compose to add/change it there... also the compose file looks much cleaner, less cramped.

Only issue is that all variables from the .env file are available in all containers that use this env_file: .env method.
That can lead to potential issues if a container picks up environment variable that is intended for a different container of the stack.

In the setups here it works and is tested, but if you start to use this everywhere without understanding it, you can encounter issues. So one of the troubleshooting steps might be abandoning .env and write out the variables directly in the compose file only under containers that want them.


Docker images latest tag

Most of the time the images are without any tag, which defaults to latest tag being used.
This is frowned upon, and you should put there the current tags once things are going. It will make updates easier when you know you can go back to a working version with backups and knowing image version.


Cloudflare

For managing DNS records. The free tier provides lot of management options and benefits. Like proxy between your domain and your server, so no one can get your public IP just from your domain name. Or 5 firewall rules that allow you to geoblock whole world except your country.

How to move to cloudflare.


ctop

official site

ctop-look

htop like utility for quick containers management.

It is absofuckinglutely amazing in how simple yet effective it is.

  • hardware use overview, so you know which container uses how much cpu, ram, bandwidth, IO,...
  • detailed info on a container, it's IP, published and exposed ports, when it was created,..
  • quick management, quick exec in to a container, check logs, stop it,...

Written in Go, so its super fast and installation is trivial when it is a single binary.
download linux-amd64 version; make it executable with chmod +x; move it to /usr/bin/; now you can ctop anywhere.


Brevo

Services often need ability to send emails, for notification, registration, password reset and such... Sendinblue is free, offers 300 mails a day and is easy to setup.

EMAIL_HOST=smtp-relay.brevo.com
EMAIL_PORT=587
EMAIL_HOST_USER=whoever_example@gmail.com
EMAIL_HOST_PASSWORD=xcmpwik-c31d9eykwef3342df2fwfj04-FKLzpHgMjGqP23
EMAIL_USE_TLS=1

Archlinux as a docker host

My go-to is archlinux as I know it the best. Usually in a virtual machine with snapshots before updates.

For Arch installation I had this notes on how to install and what to do afterwards.
But after archinstall script started to be included with arch ISO I switched to that.
For after the install setup I created Ansible-Arch repo that gets shit done in few minutes without danger of forgetting something.
Ansible is really easy to use and very easy to read and understand playbooks, so it might be worth the time to check out the concept to setup own ansible scripts.

The best aspect of having such repo is that it is a dedicated place where one can write solution to issues encountered, or enable freshly discovered feature for all future deployments.



For docker noobs

YouTube channels

Maybe list of some youtube channels to follow would not be bad idea.