# Via the web interface:
1. Go to Dashboard
2. Click "Add Domain"
3. Enter your domain name (e.g. example.com)
4. Choose monitoring options:
   - Uptime checks (every 5 minutes)
   - SSL certificate monitoring
   - DNS monitoring
   - Website change detection
5. Configure notifications
6. Click "Save"

# Download the agent:
1. Go to Dashboard → Devices
2. Click "Download Agent"
3. Choose your operating system (Windows/Linux/macOS)
4. Download the installation file

# Installation on Windows:
1. Run the .exe file
2. Follow the installation wizard
3. The agent registers automatically
4. Check status in the dashboard

# For API monitoring:
1. Go to Dashboard → Services
2. Click "Add Service"
3. Choose protocol (HTTP/TCP/IMAP/SMTP/DNS)
4. Enter endpoint URL
5. Set monitoring interval
6. Configure expected behavior
7. Click "Save"

# Enabled by default for:
- Critical alerts (downtime)
- SSL certificate expiration (30 days before)
- Domain expiration warnings

# Adjust:
1. Go to Settings → Notifications
2. Choose "Email" tab
3. Set frequency (Immediate/Daily/Weekly)
4. Choose severity levels

# Setup steps:
1. Go to Settings → Integrations
2. Click "Add Slack"
3. Authorize PulseGuard in Slack
4. Choose channel for notifications
5. Configure message format
6. Test the integration

# For custom integrations:
1. Go to Settings → Integrations → Webhooks
2. Click "Add Webhook"
3. Enter webhook URL
4. Choose events to trigger:
   - domain_up
   - domain_down
   - incident_created
   - incident_resolved
5. Configure headers (if needed)
6. Test webhook

# Via dashboard:
1. Go to Settings → API Keys
2. Click "Generate New Key"
3. Give the key a name (e.g. "Production API")
4. Set permissions:
   - Read domains
   - Write domains
   - Read devices
   - Read incidents
5. Set rate limits (requests per hour)
6. Click "Create"
7. Copy the API key (shown only once!)

# Example curl request:
curl -X GET "https://api.ipulse.one/api/domains" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

# Backend environment (.env in apps/backend/)
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/pulseguard
NEXT_PUBLIC_API_URL=https://api.ipulse.one
CLERK_SECRET_KEY=your_clerk_secret
STRIPE_SECRET_KEY=your_stripe_key

# Frontend environment (.env.local in apps/frontend/)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
NEXT_PUBLIC_API_URL=https://api.ipulse.one

# Start all services:
cd /path/to/PulseGuard
docker compose up -d

# Check status:
docker compose ps

# Stop services:
docker compose down

# Agent configuration (generated automatically):
{
  "server_url": "https://api.ipulse.one",
  "api_key": "your_device_api_key",
  "device_name": "Server-01",
  "collection_interval": 30,
  "log_level": "info"
}

# Check PostgreSQL:
docker compose ps

# View logs:
docker compose logs postgres

# Reset database:
docker compose down -v
docker compose up -d postgres

# Check internet connection
ping api.ipulse.one

# Verify API key
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.ipulse.one/api/devices

# Check firewall
sudo ufw status
sudo iptables -L

# For local development:
# Download mkcert: https://github.com/FiloSottile/mkcert
mkcert -install
mkcert localhost

# Place certificates in apps/frontend/certs/