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

3.5 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. The updated Authentik blueprint grants jay direct access, with other users assigned manually per application instead of through the retired development group. Deployment of this access-policy migration is unconfirmed. Admission 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.