PLANKA

A Kanban-style project management tool for everyone

Accesso

Apri il browser e visita: 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.

File e directory importanti

  • Directory di installazione: /opt/planka
  • File Docker Compose: /opt/planka/docker-compose.yml
  • App data volume: /var/lib/docker/volumes/planka_data/_data
  • Volume dei dati PostgreSQL: /var/lib/docker/volumes/planka_db-data/_data
  • Custom terms directory: /opt/planka/terms
  • Nginx config: /etc/nginx/sites-available/planka
  • Enabled site: /etc/nginx/sites-enabled/planka
  • Certificati SSL: /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

Abilitazione SSL con un dominio

1. Indirizza il tuo dominio all'IP del server.

2. Edit docker-compose.yml to set your domain as BASE_URL: BASE_URL=https://yourdomain.com

3. Restart PLANKA services:

cd /opt/planka/
docker compose up -d

4. Modifica la configurazione di Nginx e sostituisci entrambi server_name <IP>; con il tuo dominio (<yourdomain.com>) sia per i blocchi HTTP (porta 80) che HTTPS (porta 443):

vim /etc/nginx/sites-available/planka

5. Installa Certbot:

apt install -y certbot python3-certbot-nginx

6. Esegui il seguente comando per generare un certificato Let's Encrypt valido:

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

7. Replace SSL paths in Nginx config:

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. Riavvia Nginx per applicare le modifiche:

systemctl restart nginx

9. Apri il browser e visita: https://yourdomain.com

Dettagli dell'applicazione