unraid to swarm migration

stacks/apps/peertube/README.md

@@ -0,0 +1,171 @@
+# PeerTube Docker Swarm Setup
+
+## Prerequisites
+
+1. Traefik is running and configured
+2. PostgreSQL is running (`postgresSQL` service)
+3. The `homelab` network exists
+4. DNS record for `videos.frostlabs.me` points to your server
+
+## Setup Steps
+
+### 1. Create PeerTube Database
+
+Connect to your existing PostgreSQL instance and create the PeerTube database:
+
+```bash
+# Connect to PostgreSQL container
+docker exec -it $(docker ps -q -f name=postgresSQL) psql -U admin -d postgres
+
+# Create database (user 'admin' already exists with postgres-master secret)
+CREATE DATABASE peertube;
+GRANT ALL PRIVILEGES ON DATABASE peertube TO admin;
+\q
+```
+
+### 2. Create Docker Secret for PeerTube
+
+You already have the `postgres-master` secret for database access. You just need to create the PeerTube application secret:
+
+```bash
+# Generate and create the PeerTube secret
+echo "$(openssl rand -hex 32)" | docker secret create peertube-secret -
+
+# Verify the secret was created
+docker secret ls | grep peertube
+```
+
+**Note:** The stack uses your existing `postgres-master` secret for database authentication with the `admin` user.
+
+### 3. Verify Data Directory Permissions
+
+```bash
+# Check that the PeerTube appdata directory exists and has correct permissions
+ls -la /home/doc/projects/unraid-appdata/PeerTube
+
+# If needed, fix permissions (UID 999 is the PeerTube user)
+sudo chown -R 999:999 /home/doc/projects/unraid-appdata/PeerTube
+```
+
+### 4. Deploy the Stack
+
+```bash
+docker stack deploy -c stack.yml peertube
+```
+
+### 5. Monitor Deployment
+
+```bash
+# Watch the services
+docker service ls | grep peertube
+
+# Check logs
+docker service logs -f peertube_peertube
+
+# Check if healthy
+docker ps | grep peertube
+```
+
+### 6. Access PeerTube
+
+Once deployed, access PeerTube at: https://videos.frostlabs.me
+
+The first time you access it, you'll need to:
+1. Complete the setup wizard
+2. Create an admin account
+3. Configure additional settings in the admin panel
+
+## Configuration Notes
+
+### Database Connection
+- Host: `postgresSQL` (existing Postgres service)
+- Port: 5432 (internal)
+- Database: `peertube`
+- User: `admin`
+- Password: From `postgres-master` secret
+
+### Redis Connection
+- Host: `peertube-redis` (internal service)
+- Port: 6379 (default)
+
+### SMTP/Email
+- Host: `peertube-postfix` (internal service)
+- Port: 25
+- From: noreply@videos.frostlabs.me
+
+### Ports
+- **9000**: PeerTube HTTP (internal, proxied by Traefik)
+- **1935**: RTMP for live streaming (published on host)
+
+### Traefik Integration
+The stack is configured to use Traefik for:
+- SSL/TLS certificates (Let's Encrypt)
+- HTTPS on port 443
+- HTTP to HTTPS redirect
+- Domain: videos.frostlabs.me
+
+## Storage Layout
+
+All data is stored in `/home/doc/projects/unraid-appdata/PeerTube`:
+- Videos and media files
+- Thumbnails and previews
+- User uploads
+- Logs
+- Configuration
+
+## Troubleshooting
+
+### Check service status
+```bash
+docker service ps peertube_peertube --no-trunc
+```
+
+### View logs
+```bash
+docker service logs peertube_peertube
+docker service logs peertube_peertube-redis
+docker service logs peertube_peertube-postfix
+```
+
+### Database connection issues
+```bash
+# Test connection from PeerTube container
+docker exec -it $(docker ps -q -f name=peertube_peertube) sh
+nc -zv postgresSQL 5432
+```
+
+### Restart services
+```bash
+docker service update --force peertube_peertube
+```
+
+### Remove and redeploy
+```bash
+docker stack rm peertube
+# Wait for cleanup
+docker stack deploy -c stack.yml peertube
+```
+
+## Updating PeerTube
+
+```bash
+# Update the image
+docker service update --image chocobozzz/peertube:production-bookworm peertube_peertube
+
+# Or redeploy the stack
+docker stack deploy -c stack.yml peertube
+```
+
+## Security Considerations
+
+1. Change the default admin password after first login
+2. Keep PEERTUBE_SECRET secure and never commit it to version control
+3. Regularly update the PeerTube image for security patches
+4. Configure proper email settings for notifications
+5. Review and configure user registration settings in admin panel
+
+## Additional Resources
+
+- [PeerTube Documentation](https://docs.joinpeertube.org/)
+- [PeerTube Production Guide](https://docs.joinpeertube.org/install/docker)
+- [PeerTube Admin Documentation](https://docs.joinpeertube.org/admin/following-instances)