From 90dfc9ec8a6f5b3403d2492893dd3c93290a13a9 Mon Sep 17 00:00:00 2001
From: Damien Arnodo <damien@noreply.localhost>
Date: Sun, 4 Jan 2026 12:30:08 +0000
Subject: [PATCH] docs(seedbox): add README for Portainer stack

---
 seedbox/stacks/portainer/README.md | 52 ++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 seedbox/stacks/portainer/README.md

diff --git a/seedbox/stacks/portainer/README.md b/seedbox/stacks/portainer/README.md
new file mode 100644
index 0000000..fa3ae58
--- /dev/null
+++ b/seedbox/stacks/portainer/README.md
@@ -0,0 +1,52 @@
+# Portainer Stack
+
+Docker management UI, accessible via Tailscale.
+
+## Access
+
+- **URL**: https://portainer.taila5ad8.ts.net
+- **Initial setup**: Create admin account on first access
+
+## Ports
+
+| Port | Protocol | Exposure | Description |
+|------|----------|----------|-------------|
+| 9000 | TCP | Tailscale only | WebUI |
+
+## Features
+
+- View and manage all Docker containers
+- View logs in real-time
+- Execute commands in containers
+- Manage Docker networks and volumes
+- Deploy stacks from templates
+
+## First Setup
+
+1. Access https://portainer.taila5ad8.ts.net
+2. Create an admin account
+3. Select "Docker" as environment type
+4. Connect to local Docker socket
+
+## Troubleshooting
+
+```bash
+# Check logs
+docker logs portainer
+
+# Check Tailscale sidecar
+docker exec ts-portainer tailscale status
+
+# Restart stack
+cd /srv/seedbox/stacks/portainer
+docker compose restart
+```
+
+## Note
+
+Portainer is optional and mainly useful for:
+- Visual monitoring of containers
+- Quick access to logs
+- Emergency container management
+
+All deployments should still go through Gitea Actions for proper version control.