PLANKA

A Kanban-style project management tool for everyone

Zugang

Öffnen Sie Ihren Browser und besuchen Sie: https://<SERVER_IP>

A browser SSL warning is expected due to the self-signed certificate.

Create an admin user by running the following command on the server:

cd /opt/planka && docker compose run --rm planka npm run db:create-admin-user

Log in using the newly created admin account.

Wichtige Dateien und Verzeichnisse

  • Installationsverzeichnis: /opt/planka
  • Docker Compose-Datei: /opt/planka/docker-compose.yml
  • App data volume: /var/lib/docker/volumes/planka_data/_data
  • PostgreSQL-Datenvolumen: /var/lib/docker/volumes/planka_db-data/_data
  • Custom terms directory: /opt/planka/terms
  • Nginx-Konfiguration: /etc/nginx/sites-available/planka
  • Aktivierte Website: /etc/nginx/sites-enabled/planka
  • SSL-Zertifikate: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem

Common Management Commands

cd /opt/planka

# Check running containers
docker ps

# Logs (live)
docker compose logs -f

# Restart services
docker compose restart

# Stop stack
docker compose down

# Start stack
docker compose up -d

SSL mit einer Domain aktivieren

1. Richten Sie Ihre Domain auf die Server-IP aus.

2. Bearbeiten docker-compose.yml um Ihre Domain als BASE_URL: BASE_URL=https://yourdomain.com

3. Restart PLANKA services:

cd /opt/planka/
docker compose up -d

4. Bearbeiten Sie die Nginx-Konfiguration und ersetzen Sie beide server_name <IP>; mit Ihrer Domain (<yourdomain.com>) sowohl für HTTP- (Port 80) als auch für HTTPS-Blöcke (Port 443):

vim /etc/nginx/sites-available/planka

5. Certbot installieren:

apt install -y certbot python3-certbot-nginx

6. Führen Sie den folgenden Befehl aus, um ein gültiges Let’s Encrypt-Zertifikat zu generieren:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

7. Ersetzen Sie die SSL-Pfade in der Nginx-Konfiguration:

vim /etc/nginx/sites-available/planka
# Before:
    # ssl_certificate /etc/nginx/ssl/fullchain.pem;
    # ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

8. Starten Sie Nginx neu, um die Änderungen zu übernehmen:

systemctl restart nginx

9. Öffnen Sie Ihren Browser und besuchen Sie: https://yourdomain.com

Anwendungsdetails