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

81 lines
3.4 KiB
Markdown

---
schema_version: 1
id: home-server.portainer
type: reference
scope: [jupiter, portainer, deployment, configuration-state]
sensitivity: private-infrastructure
last_reviewed: "2026-10-16"
sources:
- kind: owner-report
reference: "Deployed container, ~/portainer_start.sh and updated Backrest plan, 2026-10-06"
- kind: owner-report
reference: "GitHub main/PAT access, Portainer environment values, manual redeployment and container inspection, 2026-10-06"
- kind: owner-report
reference: "Authentik fully deployed with all listed app integrations, including Portainer, 2026-10-16"
- kind: repository
repository: jupiter-stacks
revision: d09df456ad331b8beb9a40615114ea8aae2dced5
paths:
- stacks/portainer/portainer_start.sh
- stacks/authentik/blueprints/jupiter.yaml
related: [home-server.reference, home-server.storage, home-server.authentication, home-server.backups, home-server.deployment]
update_triggers: [script-change, portainer-upgrade, state-migration, backup-plan-change]
unknowns: [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](https://github.com/jayo60013/jupiter-stacks).
| 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](authentication.md); 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](deployment.md).
## 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.