mirror of
https://github.com/casjaysdevdocker/.github
synced 2026-07-25 14:11:36 -04:00
jason
14c1fc8988
Containers support multiple base distros, not just Alpine. - profile/README.md: broaden intro to mention Alpine, Debian, Ubuntu, RHEL-compatible, and other bases - profile/README.md: update two-stage build description to match profile/README.md
88 lines
2.8 KiB
Markdown
88 lines
2.8 KiB
Markdown
# 🐳 CasjaysDevDocker
|
|
|
|
A curated collection of self-hostable Docker containers — built on a standardised foundation supporting Alpine, Debian, Ubuntu, RHEL-compatible, and other base images, designed for simplicity, consistency, and easy self-hosting.
|
|
|
|
---
|
|
|
|
## 📦 What's Here
|
|
|
|
Every repository in this organisation is a single containerised application:
|
|
|
|
| Category | Containers |
|
|
|----------|-----------|
|
|
| **Web & Proxy** | nginx, lighttpd, caddy, traefik, cherokee |
|
|
| **Databases** | mariadb, mysql, postgres, mongodb, couchdb, redis, valkey, sqlite |
|
|
| **Git & Dev** | gitea, forgejo, soft-serve, code, neovim, vim |
|
|
| **Media** | ampache, navidrome, icecast, mpd, ympd |
|
|
| **Cloud & Storage** | nextcloud, opencloud |
|
|
| **Languages & Runtimes** | nodejs, bun, deno, python, php |
|
|
| **Mail** | postfix, mailman |
|
|
| **Networking** | bind, ddns, tor, i2pd, ifconfig |
|
|
| **Utilities** | ntfy, gotify, apprise, aria2, transmission, pastebin, wttr, ssl-ca, tftpd, proftpd |
|
|
| **AI & LLMs** | ollama |
|
|
| **Desktop** | xfce4 |
|
|
| **CMS & Web Apps** | wordpress, jekyll, enclosed, opengist, webmin |
|
|
| **Downloads** | youtube-dl |
|
|
|
|
---
|
|
|
|
## 🏗️ How Containers Are Built
|
|
|
|
All images follow the same two-stage pattern regardless of base distro:
|
|
|
|
- **Stage 1** — distro bootstrap (Alpine, Debian, Ubuntu, RHEL-compatible, etc.): install `bash`, `ca-certificates`, and update trust store
|
|
- **Stage 2** — `FROM scratch`: copy the full rootfs, layer in the application, and configure via environment variables
|
|
|
|
Every container is generated and maintained using the **[gen-dockerfile](https://github.com/casjay-dotfiles/scripts)** tool, which produces consistent Dockerfiles, entrypoint scaffolding, and CI workflows across all repositories.
|
|
|
|
---
|
|
|
|
## 🚀 Quick Start
|
|
|
|
```bash
|
|
docker pull casjaysdev/<image-name>
|
|
docker run -d \
|
|
-e TZ=America/New_York \
|
|
-p <port>:<port> \
|
|
--name <image-name> \
|
|
casjaysdev/<image-name>
|
|
```
|
|
|
|
Each repository's `README.md` documents the available environment variables, ports, and volume mounts.
|
|
|
|
---
|
|
|
|
## 🔧 Common Environment Variables
|
|
|
|
All containers share a consistent set of environment variables:
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `TZ` | `America/New_York` | Container timezone |
|
|
| `HOSTNAME` | `casjaysdev-<name>` | Container hostname |
|
|
| `PORT` | service-specific | Primary service port |
|
|
| `ENV_PORTS` | service-specific | Additional exposed ports |
|
|
| `SERVICE_NAME` | image name | Name used for config/log paths |
|
|
| `CONTAINER_NAME` | image name | Internal container identifier |
|
|
|
|
---
|
|
|
|
## 📂 Registry
|
|
|
|
Images are published to:
|
|
|
|
- **Docker Hub:** `docker.io/casjaysdev/<name>`
|
|
- **Gitea Registry:** `git.casjay.pro/casjaysdevdocker/<name>`
|
|
|
|
---
|
|
|
|
## 👤 Maintainer
|
|
|
|
🤖 **casjay** — [GitHub](https://github.com/casjay) · [Website](https://casjay.pro)
|
|
|
|
---
|
|
|
|
## 📄 License
|
|
|
|
MIT / WTFPL — use freely.
|