|
|
||
|---|---|---|
| .. | ||
| API.md | ||
| panel-api.py | ||
| panelctl.sh | ||
| README.md | ||
panelctl quickstart
This repository now includes a small helper command named panelctl for Phase 2.
Base directory:
- /home/reudy/containers
Generated structure:
- /home/reudy/containers/stacks//compose.yaml
- /home/reudy/containers/volumes//data
- /home/reudy/containers/routes/.caddy
- /home/reudy/containers/state/apps/.env
Quick workflow:
- Create a new app definition: panelctl init whoami whoami.srazka.com 18080 true
- Deploy it with Podman compose: panelctl deploy whoami
- If deploy says caddy reload needs root: sudo systemctl reload caddy
- List apps: panelctl list
- Inspect one app: panelctl show whoami
- 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.
API service:
- Nix now runs panel-api as a systemd service on 127.0.0.1:9911.
- Caddy proxies https://panel.srazka.com to panel-api with your existing forward_auth pattern.
- Open https://panel.srazka.com for the web UI.
- API docs are in panel/API.md.