mirror of
https://github.com/casjaysdevdocker/.github
synced 2026-07-25 08:11:39 -04:00
📝 Add org profile README 📝
Creates the GitHub organisation profile page shown at github.com/casjaysdevdocker. - profile/README.md: org-level README with container catalogue, quick-start, common env vars, registry locations, and maintainer info profile/
This commit is contained in:
@@ -0,0 +1,87 @@
|
||||
# 🐳 CasjaysDevDocker
|
||||
|
||||
A curated collection of self-hostable Docker containers — all built on a standardised Alpine-based foundation, 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:
|
||||
|
||||
- **Stage 1** — Alpine bootstrap: install `bash`, `ca-certificates`, and update trust store
|
||||
- **Stage 2** — `FROM scratch`: copy the full Alpine 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.
|
||||
Reference in New Issue
Block a user