Healthchecks

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

접근

  • 브라우저를 열고 다음 주소를 방문하세요: https://<SERVER_IP>
  • 브라우저에서 SSL 경고가 표시될 수 있습니다(자체 서명 인증서).

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
  • 비밀번호

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

중요한 파일 및 디렉터리

  • 설치 디렉터리: /root/healthchecks
  • 환경 파일: /root/healthchecks/.env
  • Docker Compose 파일: /root/healthchecks/docker-compose.yml
  • SQLite database: /var/lib/docker/volumes/healthchecks_healthchecks-data/_data
  • Nginx 사이트 구성: /etc/nginx/sites-available/healthchecks
  • 활성화된 사이트: /etc/nginx/sites-enabled/healthchecks
  • SSL 인증서: /etc/nginx/ssl/fullchain.pem, /etc/nginx/ssl/privkey.pem
  • Admin credentials: /root/.cloudzy-creds

스택 관리

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. 도메인을 서버 IP로 연결하십시오.

2. 편집 .env 도메인을 다음과 같이 설정하려면 SITE_ROOT: SITE_ROOT=https://yourdomain.com

3. 서비스를 재구축하십시오:

cd /root/healthchecks/
docker compose up -d

4. Nginx 구성 파일을 편집하고 두 개 모두를 교체하십시오. server_name <IP>; 귀하의 도메인과 함께 (<yourdomain.com>HTTP(포트 80) 및 HTTPS(포트 443) 블록 모두에 대해:

vim /etc/nginx/sites-available/healthchecks

5. Certbot 설치:

apt install -y certbot python3-certbot-nginx

6. 유효한 Let’s Encrypt 인증서를 생성하려면 다음 명령어를 실행하십시오:

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

7. Nginx 구성 파일(TLS 섹션)에서 SSL 경로 교체:

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. 변경 사항을 적용하려면 Nginx를 재시작하십시오:

systemctl restart nginx

9. 브라우저를 열고 다음 주소를 방문하세요: https://yourdomain.com

신청 세부사항