172 lines
4.2 KiB
Markdown
172 lines
4.2 KiB
Markdown
# 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)
|