nixos/panel
2026-04-26 22:40:39 +02:00
..
API.md Enhance panel-api with compose functionality and update podman integration 2026-04-26 19:48:35 +02:00
panel-api.py Update paths in configuration files to use /var/lib/containers instead of /home/reudy/containers 2026-04-26 22:40:39 +02:00
panelctl.sh Update paths in configuration files to use /var/lib/containers instead of /home/reudy/containers 2026-04-26 22:40:39 +02:00
README.md Update paths in configuration files to use /var/lib/containers instead of /home/reudy/containers 2026-04-26 22:40:39 +02:00

panelctl quickstart

This repository now includes a small helper command named panelctl for Phase 2.

Base directory:

  • /var/lib/containers

Generated structure:

  • /var/lib/containers/stacks//compose.yaml
  • /var/lib/containers/volumes//data
  • /var/lib/containers/routes/.caddy
  • /var/lib/containers/state/apps/.env

Quick workflow:

  1. Create a new app definition: panelctl init whoami whoami.srazka.com 18080 true
  2. Deploy it with Podman compose: panelctl deploy whoami
  3. If deploy says caddy reload needs root: sudo systemctl reload caddy
  4. List apps: panelctl list
  5. Inspect one app: panelctl show whoami
  6. Remove app but keep data: panelctl remove whoami --keep-volumes

Notes:

  • The default compose file uses traefik/whoami for smoke testing.
  • Edit each generated compose.yaml before production use.
  • App names must be lowercase slugs.
  • If deploy reports XDG_RUNTIME_DIR missing, enable lingering for the runtime user: sudo loginctl enable-linger reudy

API service: