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

2.4 KiB

schema_version, id, type, scope, sensitivity, last_reviewed, sources, related, update_triggers, unknowns
schema_version id type scope sensitivity last_reviewed sources related update_triggers unknowns
1 home-server.portainer reference
jupiter
portainer
configuration-state
private-infrastructure 2026-10-27
kind reference
live-inspection Image 2.45.3, mounts, publication, restart policy and routers inspected 2026-10-27
kind repository revision base_revision reference paths
repository jupiter-stacks working-tree 12fb1b96e01fc062fdce4c216f11eb5d7ce716ed Image correction 2.45.1 -> 2.45.3 uncommitted at review
stacks/portainer/portainer_start.sh
home-server.authentication
home-server.deployment
home-server.backups
script-change
portainer-upgrade
state-migration
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.

Persisted state

  • /data/portainer holds stack management, environment secrets, Git credentials and database/UI OAuth settings.
  • Native OIDC/callbacks and access policy: Authentication.
  • Git pull/redeploy workflow: Deployment.
  • Backup schedule, hooks and restore limits: Backups.