Gatus

Automated developer-oriented status page with alerting and incident support.

Accessing Gatus

  • ブラウザを開いて、次のURLにアクセスしてください: https://<SERVER_IP>
  • ブラウザからSSL警告が表示される可能性があります(自己署名証明書)
  • Authentication is required (Basic Auth popup)
  • Authentication method: HTTP Basic Auth
  • Credentials are stored securely in: /root/.cloudzy-creds

重要なファイルとディレクトリ

  • インストール先ディレクトリ: /opt/gatus
  • Docker Compose: /opt/gatus/docker-compose.yml
  • 環境ファイル: /opt/gatus/.env
  • Config directory: /opt/gatus/config/
  • メイン設定ファイル: /opt/gatus/config/config.yaml
  • Database directory: /opt/gatus/data/db
  • Nginxの設定: /etc/nginx/sites-available/gatus.conf
  • Enabled Nginx site: /etc/nginx/sites-enabled/gatus.conf
  • SSL証明書: /etc/nginx/ssl/
  • HTTP Basic Auth file: /etc/nginx/auth/.gatus-htpasswd
  • 認証情報ファイル: /root/.gatus-credentials

Configuration Behavior

  • Configuration files are located in /opt/gatus/config/
  • YAML can be split into multiple files
  • Changes are auto-reloaded
  • No restart is required after edits

Manage the Stack

Go to the installation directory:

cd /opt/gatus

Common Docker Compose commands:

# Check status
docker compose ps

# View logs (follow live)
docker compose logs -f

# Restart all services
docker compose restart

# Stop services
docker compose down

# Start again
docker compose up -d

Disable HTTP Basic Auth in Nginx (Optional)

Edit the Nginx site file: /etc/nginx/sites-available/gatus.conf

Remove or comment out these lines:

auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;

Nginxを再読み込み:

systemctl restart nginx

ドメインでのSSLの有効化

1. ドメインをサーバーのIPアドレスに設定してください。

2. Nginx設定を編集し、両方を置換する server_name <IP>; あなたのドメインで (<your-domain>HTTP(ポート80)およびHTTPS(ポート443)ブロックの両方に対して:

vim /etc/nginx/sites-available/gatus.conf

3. Certbot のインストール:

apt install -y certbot python3-certbot-nginx

4. 有効な Let’s Encrypt 証明書を生成するには、次のコマンドを実行します:

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

5. Nginx設定ファイル内のSSLパスを置換する:

vim /etc/nginx/sites-available/gatus.conf
# 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;

6. 変更を適用するために Nginx を再起動します:

systemctl restart nginx

7. ブラウザを開き、次のURLにアクセスしてください: https://yourdomain.com

申請内容