Deploy and manage Immich self-hosted photo/video management behind Traefik reverse proxy with SSL
Manage Immich self-hosted photo and video management deployment using Docker Compose with Traefik reverse proxy integration.
This skill helps you deploy, configure, and maintain an Immich photo/video management system running in Docker containers behind a Traefik reverse proxy with SSL termination. It handles environment setup, service orchestration, troubleshooting, and performance optimization.
1. **Verify Environment File**
- Check for `.env` file existence
- If missing, create from `.env.example`: `cp .env.example .env`
- Verify required variables are set:
- `UPLOAD_LOCATION`: Photo/video storage path
- `DB_DATA_LOCATION`: PostgreSQL data path
- `DB_PASSWORD`: Database password (must be changed from default)
- `TZ`: Timezone setting
- `IMMICH_VERSION`: Version tag (default: release)
2. **Verify External Network**
- Confirm `traefik` external network exists
- If not, create it: `docker network create traefik`
3. **Check Traefik Configuration**
- Verify Traefik labels in `docker-compose.yml`
- Confirm domain configuration (`photos.waugze.com`)
- Ensure SSL resolver is configured
**Start Services**
```bash
docker-compose up -d
```
**Stop Services**
```bash
docker-compose down
```
**Update to Latest Version**
```bash
docker-compose pull
docker-compose up -d
```
**Restart Specific Service**
```bash
docker-compose restart immich-server
```
**Check Service Status**
```bash
docker-compose ps
```
**View All Logs (Follow Mode)**
```bash
docker-compose logs -f
```
**View Specific Service Logs**
```bash
docker-compose logs -f immich-server
docker-compose logs -f immich-machine-learning
docker-compose logs -f database
```
**Check Last 100 Lines**
```bash
docker-compose logs --tail=100 immich-server
```
**Database Connection Issues**
**ML Processing Slow or Failing**
**Upload Failures**
**Container Won't Start**
**For Multi-Core Systems**
**Storage Optimization**
**Cache Management**
**Required Actions**
**Access Control**
**Backup Database**
```bash
docker-compose exec database pg_dump -U postgres immich > backup.sql
```
**Backup Photos**
**Check Disk Usage**
```bash
du -sh $UPLOAD_LOCATION
du -sh $DB_DATA_LOCATION
```
**"Network traefik not found"**
**"Permission denied" errors**
**SSL certificate issues**
**High memory usage**
**docker-compose.yml**: Service definitions, networks, volumes
**.env**: Environment variables (create from `.env.example`)
**.env.example**: Template with all available configuration options
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/immich-docker-deployment-with-traefik/raw