Zugang

Öffnen Sie Ihren Browser und besuchen Sie: https://<SERVER_IP>
Eine SSL-Warnung im Browser ist zu erwarten (selbstsigniertes Zertifikat).

Create Admin Account

Before logging in, you must create an admin account.

Run the following command:

docker exec -it healthchecks /opt/healthchecks/manage.py createsuperuser

Follow the prompts to enter:

Email address
Passwort

Once completed, you can log in using the newly created credentials.

Wichtige Dateien und Verzeichnisse

Installationsverzeichnis: /root/healthchecks
Umgebungsdatei: /root/healthchecks/.env
Docker Compose-Datei: /root/healthchecks/docker-compose.yml
SQLite database: /var/lib/docker/volumes/healthchecks_healthchecks-data/_data
Nginx-Website-Konfiguration: /etc/nginx/sites-available/healthchecks
Aktivierte Website: /etc/nginx/sites-enabled/healthchecks
SSL-Zertifikate: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem
Admin credentials: /root/.cloudzy-creds

Den Stack verwalten

cd /root/healthchecks

# Start services
docker compose up -d

# Stop services
docker compose down

# Restart services
docker compose restart

# View logs
docker compose logs -f

Email Settings Configuration (Optional)

Email configuration is required to enable notifications (e.g., alerts, reports).

Ensure SMTP connections are allowed on this server. Request SMTP access if it is currently disabled.

Edit the environment file:

nano /root/healthchecks/.env

Uncomment and configure the following variables with your SMTP provider details:

# DEFAULT_FROM_EMAIL=fixme-email-address-here
# EMAIL_HOST=fixme-smtp-host-here
# EMAIL_HOST_PASSWORD=fixme-smtp-password-here
# EMAIL_HOST_USER=fixme-smtp-username-here
# EMAIL_PORT=587
# EMAIL_USE_TLS=True

Apply the changes by restarting the service:

docker compose up -d

Enabling SSL with a Domain (Optional)

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

2. Bearbeiten .env um Ihre Domain als SITE_ROOT: SITE_ROOT=https://yourdomain.com

3. Die Dienste neu erstellen:

cd /root/healthchecks/
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/healthchecks

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 (TLS-Abschnitt):

vim /etc/nginx/sites-available/healthchecks
# 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

Healthchecks

Anwendungsdetails