Kutt

Toegang

• URL openen: https://<SERVER_IP>
• HTTPS gebruikt een zelfondertekend certificaat.
• Bij het eerste bezoek is een browserwaarschuwing te verwachten.
• Accepteer de certificaatwaarschuwing in de browser.
• Je wordt doorgestuurd naar /create-admin bij het eerste bezoek.
• Maak een beheerdersaccount aan via de webinterface.
• Log in met het beheerdersaccount.

Belangrijke bestanden en mappen

• Installatiepad: /root/kutt
• Compose-bestand: /root/kutt/docker-compose.yml
• Omgevingsbestand: /root/kutt/.env
• Nginx Configuratie: /etc/nginx/sites-available/kutt
• SSL-certificaat: /etc/nginx/ssl/kutt.crt
• SSL privésleutel: /etc/nginx/ssl/kutt.key
• PostgreSQL-datavolume: /var/lib/docker/volumes/kutt_db_data_pg/_data
• Redis-datavolume: /var/lib/docker/volumes/kutt_redis_data/_data
• Aangepast datavolume: /var/lib/docker/volumes/kutt_custom/_data

Docker-beheer

Status controleren:

docker compose -f /root/kutt/docker-compose.yml ps

Logs bekijken:

docker compose -f /root/kutt/docker-compose.yml logs -f

Service opnieuw starten:

docker compose -f /root/kutt/docker-compose.yml restart

Service stoppen:

docker compose -f /root/kutt/docker-compose.yml down

Service starten:

docker compose -f /root/kutt/docker-compose.yml up -d

NGINX-beheer

Testconfiguratie:

nginx -t

NGINX herstarten:

systemctl restart nginx

NGINX herladen:

systemctl reload nginx

Status controleren:

systemctl status nginx

SSL inschakelen met een domein

1. Wijs je domein naar het server-IP.

2. Pas de Nginx-config aan en vervang beide server_name _; met je domein (server_name <yourdomain.com>) voor zowel de HTTP-blokken (poort 80) als de HTTPS-blokken (poort 443):

vim /etc/nginx/sites-available/kutt

3. Installeer Certbot:

apt install -y certbot python3-certbot-nginx

4. Voer de volgende opdracht uit om een geldig Let's Encrypt-certificaat te genereren:

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

5. Vervang de SSL-paden in de Nginx-config:

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

6. Herlaad Nginx om de wijzigingen toe te passen:

systemctl reload nginx

7. Bewerk de /root/kutt/.env bestand om je domeinnaam in te stellen: DEFAULT_DOMAIN=yourdomain.com

8. De services opnieuw aanmaken:

cd /root/kutt
docker compose up -d

9. Open je browser en bezoek: https://yourdomain.com