2.4 KiB
👤 Author: Nick Yeoman.
Docker Compose file collection reference with the intent of running in production.
Requirements and Support
I'm only one guy, I tested with
| Software | Version |
|---|---|
| Debian | 13 |
| Docker Engine | 29.2.1 |
| Dockhand | 1.0.18 |
🤔 Assumptions
These compose files make a few assumptions:
- You are running dockhand.
- You are using Nginx Proxy Manager (although most have redundant port access).
📚 Workflow
The intended workflow is as follows:
- Add the repository
https://github.com/nickyeoman/docker-compose-cookbooks.gitto your dockhand Git repositories (in settings) - Create the stack in dockhand
You may have to use multiple containers, such as Maria or postgres for db.
🛠 Project Directory Structure
Directories ending with _dev contain projects that are still under development or experimental. These are not yet considered production-ready.
Directories ending with _notes contain projects that usually don’t require a full Docker Compose file. They may include notes, example commands, or minimal Compose files just to illustrate setup. For example, the ollama project has a docker-compose.yml showing CPU vs GPU usage.
Test a container
Make sure you have a /data created first on your system.
docker compose --env-file sample.env up -d
# then down
docker compose --env-file sample.env down
Decisions
container_name
container_name has been left out of the template intentionally.
Paths
I use 3 Paths strategies, they are all considered private:
- VOL_PATH, usually ./data is a data directory that is not in git, backed up externally.
- CONFIG_PATH usually ./config is stored in git (text files)
- LOG_PATH, usually ./logs is not stored in git or backed up.
Prefered Containers
- UptimeKuma - I prefer Gatus over UptimeKuma and have remove UptimeKuma.
Similar Projects
- Awesome Compose - A starting point for integrating different services using a Compose file.
- Docker compose collection Deploy multiple services easily and quickly.
- hotio.dev - These are images not compose files, but very useful.