Config backup, a Docker dev/prod split, and a Gitea-built release image.
Added
- /settings -> General -> "Configuration backup": JSON export/import of the
panel's general settings + attribute definitions
(App\Services\ConfigBackupService); audited as config.export / config.import.
Export can leave out the attribute-encryption key. No AD data included.
- docker/compose.dev.yaml: live-reload dev stack that bind-mounts the working
tree. docker/php/Dockerfile is now multi-stage (base -> dev / prod).
- .github/workflows/release.yml: on every vX.Y.Z tag, builds the prod image and
pushes gitea.kzbikowski.pl/kzbkowski/adconsole:{X.Y.Z,X.Y,latest}.
Changed
- docker/compose.yaml: self-contained prod image (app code + composer install
--no-dev baked in via COPY); persistent state in docker/data/{app_storage,db};
defaults to the released image (ADCONSOLE_VERSION pins a tag, ADCONSOLE_IMAGE
replaces the ref). Apache now honours public/.htaccess (AllowOverride All).
Run from the repo root with --env-file .env.
- Repo root now holds only README.md; CHANGELOG / CONTRIBUTING / SECURITY /
CODE_OF_CONDUCT moved under docs/.
Upgrade notes: docs/upgrading.md#v110--docker-layout. Full log: docs/CHANGELOG.md.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JKT9p3bfP8RZesExdYCS52
1.4 KiB
1.4 KiB
ADconsole documentation
| Doc | Read it when you want to… |
|---|---|
| installation.md | Install on a bare-metal / VM host (Apache or nginx). |
| configuration.md | Understand every .env key and the in-app settings. |
| active-directory.md | Set up the service account, delegation, LDAPS and the login group. |
| architecture.md | Understand how the app is put together and why. |
| deployment.md | Run it in production — Docker/Traefik, HTTPS, caches, upgrades. |
| development.md | Hack on it: local setup, tests, code style, translations. |
| troubleshooting.md | Fix "the list is empty", "password reset fails", etc. |
| upgrading.md | Pull a new version safely. |
| publishing.md | Turn this tree into a clean shared/public repo. |
| CONTRIBUTING.md | Set up a dev loop and get a change merged. |
| CODE_OF_CONDUCT.md | Know the behaviour expected of contributors. |
| CHANGELOG.md | See what changed between releases. |
| SECURITY.md | Report a vulnerability; understand the security scope. |
Start with the project README for the 5-minute overview.
Security policy and vulnerability reporting: SECURITY.md.