Kutt

Zugriff

• URL öffnen: https://<SERVER_IP>
• HTTPS verwendet ein selbstsigniertes Zertifikat.
• Beim ersten Zugriff ist eine Browserwarnung zu erwarten.
• Akzeptieren Sie die Zertifikatswarnung des Browsers.
• Sie werden weitergeleitet zu /create-admin beim ersten Zugriff.
• Erstellen Sie ein Administrator-Konto über die Weboberfläche.
• Melden Sie sich mit dem Administrator-Konto an.

Wichtige Dateien und Verzeichnisse

• Installationspfad: /root/kutt
• Compose-Datei: /root/kutt/docker-compose.yml
• Umgebungsdatei: /root/kutt/.env
• Nginx Konfiguration: /etc/nginx/sites-available/kutt
• SSL-Zertifikat: /etc/nginx/ssl/kutt.crt
• SSL-Privater Schlüssel: /etc/nginx/ssl/kutt.key
• PostgreSQL-Daten-Volume: /var/lib/docker/volumes/kutt_db_data_pg/_data
• Redis-Daten-Volume: /var/lib/docker/volumes/kutt_redis_data/_data
• Benutzerdefiniertes Daten-Volume: /var/lib/docker/volumes/kutt_custom/_data

Docker-Verwaltung

Status prüfen:

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

Logs ansehen:

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

Dienst neu starten:

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

Dienst beenden:

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

Service starten:

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

NGINX-Verwaltung

Testkonfiguration:

nginx -t

NGINX neu starten:

systemctl restart nginx

NGINX neu laden:

systemctl reload nginx

Status prüfen:

systemctl status nginx

SSL mit einer Domain aktivieren

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

2. Nginx-Konfiguration bearbeiten und beide ersetzen server_name _; mit Ihrer Domain (server_name <yourdomain.com>) für beide Blöcke HTTP (Port 80) und HTTPS (Port 443):

vim /etc/nginx/sites-available/kutt

3. Certbot installieren:

apt install -y certbot python3-certbot-nginx

4. 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

5. SSL-Pfade in der Nginx-Konfiguration ersetzen:

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. Laden Sie Nginx neu, um die Änderungen anzuwenden:

systemctl reload nginx

7. Bearbeiten Sie die /root/kutt/.env Datei, um deinen Domainnamen festzulegen: DEFAULT_DOMAIN=yourdomain.com

8. Dienste neu erstellen:

cd /root/kutt
docker compose up -d

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