You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

76 lines
2.4 KiB
Markdown

4 years ago
# Selfhosted-Apps-Docker
4 years ago
4 years ago
###### guide by example
4 years ago
4 years ago
---
4 years ago
![logo](https://i.imgur.com/u5LH0jI.png)
4 years ago
4 years ago
---
4 years ago
* [caddy_v2](caddy_v2/) - reverse proxy
4 years ago
* [bitwarden_rs](bitwarden_rs/) - password manager
* [bookstack](bookstack/) - notes and documentation
* [borg_backup](borg_backup/) - backup utility
* [ddclient](ddclient/) - automatic DNS update
4 years ago
* [dnsmasq](dnsmasq/) - DNS and DHCP server
4 years ago
* [homer](homer/) - homepage
* [nextcloud](nextcloud/) - file share & sync
4 years ago
* [portainer](portainer/) - docker management
4 years ago
* [prometheus_grafana](prometheus_grafana/) - monitoring
* [watchtower](watchtower/) - automatic docker images update
4 years ago
* [arch_linux_host_install](arch_linux_host_install)
4 years ago
4 years ago
The core of the setup is Caddy reverse proxy.</br>
It's described in most details.
4 years ago
# Some docker basics and some info
4 years ago
4 years ago
### Compose and environment variables
4 years ago
4 years ago
You **do not** need to fuck with `docker-compose.yml` to get something up,
simple copy paste should suffice.
4 years ago
You **do need** to fuck with `.env` file, that's where all the variables are.
4 years ago
Also sometimes the `.env` file is used as `env_file`
4 years ago
* `.env` - actual name of a file, used only by compose.</br>
It is used automatically just by being in the directory
4 years ago
with the `docker-compose.yml`</br>
Variables set there are only available during the building of the container.
* `env_file` - an option in compose that defines existing external file.</br>
Variables set in this file will be available in the running container,
but not in compose.
So to not have polluted huge ass compose file, or to not have multiple places
4 years ago
where changes need to be made when adding a variable... `env_file: .env` BAM.
4 years ago
4 years ago
Only issue is that all variables from `.env` are available in
containers that use this.</br>
4 years ago
That can lead to potential conflicts and clashes, looking at you nextcloud.
4 years ago
4 years ago
In those cases variables names are declared per container.
4 years ago
4 years ago
But `env_file: .env` is just easier, prettier... and mostly painless.
4 years ago
4 years ago
---
### Images latest tag
All images are without any tag, which defaults to `latest` tag being used.
This is [very frown uppon](https://vsupalov.com/docker-latest-tag/),
but feel free to choose a version and sticking with it.
4 years ago
---
4 years ago
### Bind mount
4 years ago
No volumes are used. Directories and files from host
are bind mounted in to containers.</br>
Don't feel like I know all of the aspects of this,
but I know its easier to edit a random file from bind mount,
4 years ago
or to back it up.