# Citadel example stacks

Two independent applications in one Git repository demonstrate Citadel's
monorepo support. Register this repository once in **Git Repositories**, then
create a Git Stack for each application.

| Stack | Compose path | Working directory | Watch path |
| --- | --- | --- | --- |
| Voting app | `voting-app/compose.yaml` | `voting-app` | `voting-app/**` |
| WordPress | `wordpress/compose.yaml` | `wordpress` | `wordpress/**` |

Select `main` and use **Discover compose paths** to find both definitions.
Compose paths are relative to the repository root. Start with automatic updates
disabled and deploy each Stack explicitly. Updating one application's folder
should not mark the other Stack outdated.

The [Docker voting sample](https://github.com/dockersamples/example-voting-app)
demonstrates five services, separate networks, health checks, and a persistent
PostgreSQL volume. Its upstream images hardcode the `postgres` / `postgres`
sample database credentials. Use only disposable votes; never reuse these
credentials or expose the database port.

WordPress demonstrates a persistent website and MariaDB database. Bind
`WORDPRESS_DB_PASSWORD` to a Citadel Secret before deployment. Generate a separate
password in each environment; do not commit it to this repository. Complete
WordPress installation privately before exposing the site to visitors.

Set `WORDPRESS_PUBLIC_URL` to `https://demo.citadelplane.com/wordpress` or
`https://preview.citadelplane.com/wordpress` in the corresponding Citadel Stack.
WordPress lives under `/var/www/html/wordpress`, using the existing named volume,
so its public path and Apache's directory layout agree. The reverse proxy must
preserve `/wordpress/` and forward `X-Forwarded-Proto: https`. Site and admin URLs
are derived from this binding; use HTTPS and omit the trailing slash.

Web ports bind to loopback for access through a host reverse proxy or SSH
tunnel. Database ports are not published. Supply these non-secret variables in
each Stack to avoid host-port collisions:

| Variable | Preview | Demo |
| --- | --- | --- |
| `VOTE_PORT` | `18402` | `28402` |
| `RESULT_PORT` | `18403` | `28403` |
| `WORDPRESS_PORT` | `18404` | `28404` |

Each environment uses its own Docker engine, Forgejo repository instance, Stack
resources, networks, and volumes. Sharing these definitions does not share data.
Image tags are intentionally visible in the examples; operators should review
resolved images before enabling automatic updates.