Доступ

Откройте браузер и перейдите по адресу: 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. Замените пути SSL в конфигурации Nginx (раздел TLS):

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

Healthchecks

Детали заявки