51 lines
2.4 KiB
Markdown
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).
|