Healthchecks

Open-source cron job and background task monitoring service, written in Python & Django.

Hozzáférés

  • Nyissa meg a böngészőjét, és látogasson el a következő weboldalra: https://<SERVER_IP>
  • A böngésző várhatóan SSL-figyelmeztetést jelenít meg (önaláírt tanúsítvány)

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
  • Jelszó

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

Fontos fájlok és könyvtárak

  • Telepítési könyvtár: /root/healthchecks
  • Környezeti fájl: /root/healthchecks/.env
  • Docker Compose fájl: /root/healthchecks/docker-compose.yml
  • SQLite database: /var/lib/docker/volumes/healthchecks_healthchecks-data/_data
  • Nginx webhely konfiguráció: /etc/nginx/sites-available/healthchecks
  • Engedélyezett webhely: /etc/nginx/sites-enabled/healthchecks
  • SSL tanúsítványok: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem
  • Admin credentials: /root/.cloudzy-creds

A verem kezelése

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. Irányítsa domainjét a szerver IP-címére.

2. Szerkesztés .env a domain beállításához SITE_ROOT: SITE_ROOT=https://yourdomain.com

3. A szolgáltatások újbóli létrehozása:

cd /root/healthchecks/
docker compose up -d

4. Szerkessze az Nginx konfigurációját, és cserélje ki mindkettőt server_name <IP>; a domainjével (<yourdomain.com>) mind a HTTP (80-as port), mind a HTTPS (443-as port) blokkok esetében:

vim /etc/nginx/sites-available/healthchecks

5. Telepítse a Certbotot:

apt install -y certbot python3-certbot-nginx

6. Futtassa a következő parancsot egy érvényes Let’s Encrypt tanúsítvány létrehozásához:

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

7. Cserélje ki az SSL útvonalakat az Nginx konfigurációban (TLS szakasz):

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. Indítsa újra az Nginx-et a változások alkalmazásához:

systemctl restart nginx

9. Nyissa meg a böngészőjét, és látogasson el a következő webhelyre: https://yourdomain.com

Az alkalmazás részletei