--- schema_version: 1 id: home-server.portainer type: reference scope: [jupiter, portainer, configuration-state] sensitivity: private-infrastructure last_reviewed: "2026-10-27" sources: - kind: live-inspection reference: "Image 2.45.3, mounts, publication, restart policy and routers inspected 2026-10-27" - kind: repository repository: jupiter-stacks revision: working-tree base_revision: 12fb1b96e01fc062fdce4c216f11eb5d7ce716ed reference: "Image correction 2.45.1 -> 2.45.3 uncommitted at review" paths: [stacks/portainer/portainer_start.sh] related: [home-server.authentication, home-server.deployment, home-server.backups] update_triggers: [script-change, portainer-upgrade, state-migration] unknowns: [local-hostname-dns-resolution, host-script-and-boot-invocation, successful-state-restore] --- # Portainer ## Deployment - Standalone shell script, **not Compose**: `stacks/portainer/portainer_start.sh`; supplied host copy `~/portainer_start.sh`. - Working tree pins **2.45.3**, matching live; committed `12fb1b9` still pins **2.45.1**. Correct before using a fresh clone. - Script stops/removes then recreates the container. Host copy/boot invocation not revalidated. | Setting | Deployed value | | --- | --- | | Image / container | `portainer/portainer-ce:2.45.3` / `portainer` | | Restart / network | `always` / external `traefik` | | State | `/data/portainer:/data`; not old `portainer_data` volume | | Docker API | `/var/run/docker.sock` bind | | Direct port | `9123:9000`; bypasses Traefik middleware | | Public router | `portainer.umbra.mom`; `https,wireguard`; no router TLS labels | | Local router | `portainer.local.umbra.mom`; HTTPS-only, explicit TLS/`letsencrypt` | | Backend | HTTP `9000`; no forward-auth middleware | - Replace from independent SSH, not Portainer's UI; require mounted `/data`, Docker and `traefik`. - Back up state first; preserve image/mounts/network/restart/port. Never run two instances against the same state; a stopped container is not a DB backup. - Shared routing convention: [Networking](networking.md#listener-and-trust-boundaries). ## Persisted state - `/data/portainer` holds stack management, environment secrets, Git credentials and database/UI OAuth settings. - Native OIDC/callbacks and access policy: [Authentication](authentication.md#native-oidc). - Git pull/redeploy workflow: [Deployment](deployment.md). - Backup schedule, hooks and restore limits: [Backups](backups.md).