PLANKA

A Kanban-style project management tool for everyone

Accès

Ouvrez votre navigateur et rendez-vous sur : 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.

Fichiers et répertoires importants

  • Répertoire d'installation : /opt/planka
  • Fichier Docker Compose : /opt/planka/docker-compose.yml
  • App data volume: /var/lib/docker/volumes/planka_data/_data
  • Volume de données PostgreSQL : /var/lib/docker/volumes/planka_db-data/_data
  • Custom terms directory: /opt/planka/terms
  • Configuration Nginx : /etc/nginx/sites-available/planka
  • Enabled site: /etc/nginx/sites-enabled/planka
  • Certificats 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

Activation du protocole SSL avec un domaine

1. Pointez votre domaine vers l'adresse IP du serveur.

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. Modifiez la configuration Nginx et remplacez les deux server_name <IP>; avec votre domaine (<yourdomain.com>) pour les blocs HTTP (port 80) et HTTPS (port 443) :

vim /etc/nginx/sites-available/planka

5. Installez Certbot :

apt install -y certbot python3-certbot-nginx

6. Exécutez la commande suivante pour générer un certificat Let's Encrypt valide :

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

7. Remplacer les chemins SSL dans la configuration Nginx :

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. Redémarrez Nginx pour appliquer les modifications :

systemctl restart nginx

9. Ouvrez votre navigateur et rendez-vous sur : https://yourdomain.com

Détails de la demande