docs: Docker installation guide using official synetics images#1306
Merged
Conversation
New page documenting the Docker Compose deployment of i-doit Pro with the official container images from registry.on.ops.docupike.net. Covers prerequisites, Docker install, compose.yaml / .env / nginx / TLS certificate, first login, mandatory Pro-mode activation, licensing, update, backup, uninstall and troubleshooting (including the IDOIT_APP_URL one-shot persistence, the tmpfs/temp add-on install bug, and Apache directory-slash redirects behind nginx). The existing index.md is extended to present both installation paths side by side: the new compose-based one and the existing custom build on Debian / Ubuntu. The new page is registered in the German nav of config/de/mkdocs.yml. An English translation will follow in a separate pull request. Verified end-to-end on Debian 13 from a clean snapshot: stack starts healthy, HTTP redirects to HTTPS, login + logout via reverse proxy, add-on install from the Subscription Center works after the Pro-mode step, lifecycle (restart, down/up) preserves data. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3 tasks
MichaelOv
approved these changes
May 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/de/installation/docker-installation/compose.mddescribing how to deploy i-doit Pro with the official synetics container images (registry.on.ops.docupike.net/i-doit/app:38,db:38) via Docker Compose, including an optional nginx-based TLS reverse proxy.config/de/mkdocs.yml).Why
i-doit now ships official, hardened container images from the synetics tech-ops registry. They are simpler to deploy than the custom Apache/PHP build the existing Docker articles describe, but the entrypoint has a few sharp edges that aren't obvious from the upstream
compose.yamlsnippet alone:IDOIT_VERSION/IDOIT_SYSTEM_SETTINGSin the.envcrashes the app container immediately (set -uin the entrypoint).tmpfsmount on/var/www/html/tempthat appears in some templates collides with the add-on installer'srmdirof that directory.idoit:feature-manager --unset-cloud/--noncloudable --enable allstep plus toggling$g_is_cloudinconfig.inc.php.IDOIT_APP_URLis only persisted on the very first container start, so a wrong value (e.g.http://localhost:8080) needs theidoit:set-env-varconsole command to fix.http://...:8080/URLs that the proxy has to rewrite (proxy_redirect).All of these are documented in dedicated troubleshooting sections so users don't have to rediscover them.
Test plan
Verified end-to-end on a clean Debian 13 (Trixie) VM, two independent runs from a fresh snapshot:
docker compose pull && docker compose up -dbrings the stack tohealthywithin ~30 s.curl http(s)://.../healthreturns{"status":"ready","version":"38"}.localhost:8080redirect).proxy_redirectrewrite verified).rmdir: Device or resource busy).docker compose restartanddocker compose down(without-v) followed byup -dpreserveappanddbvolumes; stack returns to healthy.Follow-up
An English translation of
compose.mdand the correspondingconfig/en/mkdocs.ymlupdate will follow in a separate pull request.🤖 Generated with Claude Code