WIP: docs(docker): Big refactor with better structuring, simplified examples, and other improvements #1594

Draft
stratself wants to merge 14 commits from stratself/continuwuity:stratself/docs-docker-improvements into main

14 commits

Author SHA1 Message Date
b11e267094 docs(docker): Revert to mounting /etc/resolv.conf as configs: won't work
All checks were successful
Check Changelog / Check for changelog (pull_request_target) Successful in 21s
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 2m59s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 12m58s
* Fix wording to make mounting resolv.conf more imperative
* Linting and other changes
2026-04-04 07:03:12 +00:00
6fdcf8001a docs(docker): Update links for DNS tuning guide
Some checks failed
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Check Changelog / Check for changelog (pull_request_target) Successful in 16s
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 3m4s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 12m51s
2026-04-01 10:02:35 +00:00
cecf96df1d fix(docs): exclude local .yml URLs from dead link checking
Some checks failed
Check Changelog / Check for changelog (pull_request_target) Successful in 11s
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 2m52s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 13m51s
2026-03-31 20:43:37 +00:00
c4a409e3b8 chore: Add changelog for #1594
Some checks failed
Check Changelog / Check for changelog (pull_request_target) Successful in 13s
Documentation / Build and Deploy Documentation (pull_request) Has been skipped
Checks / Prek / Pre-commit & Formatting (pull_request) Failing after 2m51s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 14m57s
2026-03-31 19:44:32 +00:00
6166417afd docs(docker): Rewrite Docker DNS workaround with custom resolv.conf
Instead of /etc/resolv.conf on host. This works around the
systemd-resolved footgunning issue and provide an inline way to
configure resolvers, separate from that of the host system.
2026-03-31 19:44:32 +00:00
5350e5ddeb docs(docker): Document the new initial registration flow
* Also add a note disclaiming that Docker is for demo purposes only
* Use port 8008 for Docker Quick Run instructions
* Remove the steps to create first admin user

I do believe "Docker - Quick Run" should be moved to after Docker
Compose section, but will want to discuss this before advancing
2026-03-31 19:44:32 +00:00
3f467edb16 docs(docker): Make example ymls raw-viewable and other copyedit fixes
* Move all *.yml files to docs/public/deploying so they can be viewable
  as raw files on the webpage
* Link to those files with "(view raw)"
* Move minimal environment variables to Docker Compose section
* Unheading the Docker Quick Run stuff to prepare deprioritizing them
* Remove redundant Registry column in Image table
* Rename reverse proxy subsections to have software name as first word
2026-03-31 19:44:32 +00:00
24284b09cc docs(docker): Remove dynamic.yml file and related config lines
The file defines an HSTS middleware and cipher suite prefs, which
should not be needed for a simple deployment
2026-03-31 19:44:32 +00:00
f03efc4a75 docs(docker): Add Caddy via Caddyfile deployment and prioritise them
* Add compose and included Caddyfile using caddy:latest official image
* Rename old Caddy files as caddy-labels.yml and new one as caddy.yml
* Remove external: true network in caddy-labels.yml to simplify docs
* Move all Caddy selections to top, unprioritize Traefik and other RPs
2026-03-31 19:44:32 +00:00
d46312546a docs(docker): Consistencize all domains to example.com and port to 8008
Included some additional comments. .well-known Delegation seems to be
much more convenient for traefik + caddy. How they're documented can be
decided in a future commit.
2026-03-31 19:44:32 +00:00
6bef916f37 docs(docker): Remove unnecessary parts from all current compose files
* Remove unnecessary c10y env vars
* Remove unnecessary comment about image build and vim
* Remove references to Element-Web

Other changes like unified port and domain names will be in a future
commit
2026-03-31 19:44:32 +00:00
e0fe23b54a docs(docker): Merge Prerequisites and Images into "Preparation" section
* docs: Remove Matrix Federation Requirements for simpler deployments
* docs: Remove redundant env vars in Docker - Quick Run
2026-03-31 19:44:32 +00:00
6723a9f43a docs(docker): Upsection headings by one level
* docs: "Docker - Quick Run" and "Docker Compose" are now two top-level
  sections
* docs: Mark building your images as "(Optional)"
* docs: Move calls to "Next step" section
2026-03-31 19:44:32 +00:00
e0c3bf16d9 docs(docker): Rework section on available images
* docs: Make "Available Images" a top-level option, to be followed by
  Docker and Docker Compose sections in a future commit
* docs: Make "Mirrors" a subsection of "Available images", and add
  links to the mirrors themselves
* docs: Use indirect linkages to URLs for better maintainability
* docs: Remove initial sentence and its reference to the (advanced)
  building your image flow
* docs: Recommend `latest` OCI tag and include link to
2026-03-31 19:44:32 +00:00