Healthchecks

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

Erişim

  • Tarayıcınızı açın ve şu adresi ziyaret edin: https://<SERVER_IP>
  • Tarayıcıda bir SSL uyarısı bekleniyor (kendi kendine imzalanmış sertifika)

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
  • Şifre

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

Önemli Dosyalar ve Dizinler

  • Yükleme dizini: /root/healthchecks
  • Çevre dosyası: /root/healthchecks/.env
  • Docker Compose dosyası: /root/healthchecks/docker-compose.yml
  • SQLite database: /var/lib/docker/volumes/healthchecks_healthchecks-data/_data
  • Nginx site yapılandırması: /etc/nginx/sites-available/healthchecks
  • Etkinleştirilmiş site: /etc/nginx/sites-enabled/healthchecks
  • SSL sertifikaları: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem
  • Admin credentials: /root/.cloudzy-creds

Yığın Yönetimi

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. Alan adınızı sunucu IP adresine yönlendirin.

2. Düzenle .env alan adınızı şu şekilde ayarlamak için SITE_ROOT: SITE_ROOT=https://yourdomain.com

3. Hizmetleri yeniden oluşturun:

cd /root/healthchecks/
docker compose up -d

4. Nginx yapılandırmasını düzenleyin ve her ikisini de değiştirin server_name <IP>; alan adınızla (<yourdomain.com>) hem HTTP (bağlantı noktası 80) hem de HTTPS (bağlantı noktası 443) blokları için:

vim /etc/nginx/sites-available/healthchecks

5. Certbot'u yükleyin:

apt install -y certbot python3-certbot-nginx

6. Geçerli bir Let’s Encrypt sertifikası oluşturmak için aşağıdaki komutu çalıştırın:

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

7. Nginx yapılandırmasında SSL yollarını değiştirin (TLS bölümü):

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. Değişiklikleri uygulamak için Nginx'i yeniden başlatın:

systemctl restart nginx

9. Tarayıcınızı açın ve şu adresi ziyaret edin: https://yourdomain.com

Başvuru Detayları