Files
notes/docs/home-server/portainer.md
T
2026-10-27 12:21:10 +00:00

51 lines
2.4 KiB
Markdown

---
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).