Affected Article
Suggested Improvements
The compose guide documents that the app and db volumes persist and how to back them up, but not which parts of the application tree are ephemeral, nor how to keep data i-doit writes into the webroot. On the official i-doit app image (version 38, PHP 8.4) these are lost on container recreate. Add a "Persistence" section covering:
- Add-ons: installing via the Subscription Center / UI unpacks into the ephemeral application tree (
src/classes/modules/…) and is lost on recreate. Persistent path: place the add-on ZIP into /data/data/addons-to-install/; the entrypoint installs it and moves it to /data/data/addons/ (symlink). Not documented today.
- Custom translations / renamings: i-doit writes
src/lang/<abbr>_custom.inc.php (see administration/multilingual-support.md) into the application tree, so it is lost on recreate. Persist via a derived image (COPY) or a bind-mount (must be writable by the web user, uid 33). A behavior fix to persist these automatically is planned.
Optional: Text Proposals
# Derived image: persist custom translations
COPY de_custom.inc.php /var/www/html/src/lang/de_custom.inc.php
# Add-ons: place the ZIP into the persistent /data/data/addons-to-install/ before start
Affected Article
docs/en/installation/docker-installation/compose.md)docs/de/installation/docker-installation/compose.md)administration/multilingual-support.md/mehrsprachigkeit-und-uebersetzungen.mdSuggested Improvements
The compose guide documents that the
appanddbvolumes persist and how to back them up, but not which parts of the application tree are ephemeral, nor how to keep data i-doit writes into the webroot. On the official i-doit app image (version 38, PHP 8.4) these are lost on container recreate. Add a "Persistence" section covering:src/classes/modules/…) and is lost on recreate. Persistent path: place the add-on ZIP into/data/data/addons-to-install/; the entrypoint installs it and moves it to/data/data/addons/(symlink). Not documented today.src/lang/<abbr>_custom.inc.php(seeadministration/multilingual-support.md) into the application tree, so it is lost on recreate. Persist via a derived image (COPY) or a bind-mount (must be writable by the web user, uid 33). A behavior fix to persist these automatically is planned.Optional: Text Proposals