Files
notes/docs/home-server/portainer.md
T

3.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
deployment
configuration-state
private-infrastructure 2026-10-16
kind reference
owner-report Deployed container, ~/portainer_start.sh and updated Backrest plan, 2026-10-06
kind reference
owner-report GitHub main/PAT access, Portainer environment values, manual redeployment and container inspection, 2026-10-06
kind reference
owner-report Authentik fully deployed with all listed app integrations, including Portainer, 2026-10-16
kind repository revision paths
repository jupiter-stacks d09df456ad331b8beb9a40615114ea8aae2dced5
stacks/portainer/portainer_start.sh
stacks/authentik/blueprints/jupiter.yaml
home-server.reference
home-server.storage
home-server.authentication
home-server.backups
home-server.deployment
script-change
portainer-upgrade
state-migration
backup-plan-change
local-hostname-dns-resolution
successful-state-and-secret-restore

Portainer

Deployment

Managed by handwritten ~/portainer_start.sh, not a Compose stack. Reference script: portainer_start.sh.

Setting Deployed value
Image portainer/portainer-ce:2.45.1
Container portainer
Restart policy always
Network External Docker network traefik
State Host /data/portainer -> container /data
Docker API /var/run/docker.sock bind mount
Host publication TCP 9123 -> container 9000
HTTPS routers portainer.umbra.mom, portainer.local.umbra.mom
Traefik backend HTTP; container port 9000
TLS https entrypoint; letsencrypt resolver

Script stops/removes the existing container, then recreates it; bind-mounted state persists. Requires Docker, the traefik network, and mounted /data. Supplied routers attach no forward-auth middleware. Local router does not establish local DNS resolution.

Authentication

Native OIDC through Authentik; client ID portainer; issuer https://auth.umbra.mom/application/o/portainer/. Both public and local HTTPS hostnames are registered as strict callbacks. Application access requires Authentik group development (owner's Developers category); this does not itself assign Portainer administrator permissions.

OAuth configuration is database/UI state, not configured by the container startup script. The owner reports the integration complete; local-login and account-linking settings were not supplied. Preserve /data/portainer for both stack management and authentication configuration.

Stack management

Portainer fetches https://github.com/jayo60013/jupiter-stacks, branch main, using a GitHub PAT. Stack environment values/secrets are managed in Portainer. Repository changes are pulled/redeployed manually; committing alone does not update containers. See deployment.

Backups

Daily 03:00 UTC; Google Drive; last four snapshots. Backrest reads /userdata/portainer from host /data/portainer.

  • Before snapshot: stop portainer; timeout 120s; errors fatal.
  • Snapshot end/error: start portainer; restart errors ignored.
  • Restore remains untested; script itself is outside the listed backup paths.

The former portainer_data named volume is not used by the deployed container.