Toegang

Open uw browser en ga naar: https://<SERVER_IP>
Er wordt een SSL-waarschuwing in de browser verwacht (zelfondertekend certificaat)

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
Wachtwoord

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

Belangrijke bestanden en mappen

Installatiemap: /root/healthchecks
Milieu-bestand: /root/healthchecks/.env
Docker Compose-bestand: /root/healthchecks/docker-compose.yml
SQLite database: /var/lib/docker/volumes/healthchecks_healthchecks-data/_data
Nginx-siteconfiguratie: /etc/nginx/sites-available/healthchecks
Ingeschakelde site: /etc/nginx/sites-enabled/healthchecks
SSL-certificaten: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem
Admin credentials: /root/.cloudzy-creds

Manage the Stack

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. Wijs uw domein naar het IP-adres van de server.

2. Bewerken .env om uw domein in te stellen als SITE_ROOT: SITE_ROOT=https://yourdomain.com

3. De diensten opnieuw creëren:

cd /root/healthchecks/
docker compose up -d

4. Bewerk de Nginx-configuratie en vervang beide server_name <IP>; met uw domein (<yourdomain.com>) voor zowel HTTP (poort 80) als HTTPS (poort 443) blokken:

vim /etc/nginx/sites-available/healthchecks

5. Certbot installeren:

apt install -y certbot python3-certbot-nginx

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

7. Vervang SSL-paden in Nginx-configuratie (TLS-sectie):

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. Start Nginx opnieuw op om de wijzigingen toe te passen:

systemctl restart nginx

9. Open uw browser en ga naar: https://yourdomain.com

Healthchecks

Details van de aanvraag