Uptime monitoring from multiple global locations.

# With Docker Compose (from brainzlab root)
docker-compose --profile beacon up

# Create a monitor
POST /api/v1/monitors { "url": "https://api.example.com", "interval": 60 }

docker pull brainzllc/beacon:latest

docker run -d \
  -p 3000:3000 \
  -e DATABASE_URL=postgres://user:pass@host:5432/beacon \
  -e REDIS_URL=redis://host:6379/6 \
  -e RAILS_MASTER_KEY=your-master-key \
  brainzllc/beacon:latest

bin/setup
bin/rails server

• Ruby 3.4.7 / Rails 8.1
• PostgreSQL 16 with TimescaleDB
• Redis 7 (status cache, rate limiting)
• Hotwire (Turbo + Stimulus) / Tailwind CSS
• Solid Queue / ActionCable (live status updates)
• Multi-region checkers (Fly.io/Railway)

POST /api/v1/monitors
{
  "monitor": {
    "name": "Production API",
    "url": "https://api.example.com/health",
    "check_type": "http",
    "interval": 60,
    "timeout": 30,
    "regions": ["nyc", "lon", "sin"],
    "alert_threshold": 2
  }
}

Create public status pages for your users:

• Custom domain support
• Component grouping
• Incident timeline
• Maintenance windows

Get notified when services go down:

• Multi-region verification (avoid false positives)
• Configurable thresholds
• Integration with Signal for notifications

• GET /api/v1/monitors - List monitors
• POST /api/v1/monitors - Create monitor
• GET /api/v1/monitors/:id/checks - Get check history

• GET /api/v1/incidents - List incidents
• POST /api/v1/incidents/:id/update - Post incident update

• GET /api/v1/status-pages - List public status pages
• POST /api/v1/status-pages - Create status page

Full documentation: docs.brainzlab.ai/products/beacon

services:
  beacon:
    image: brainzllc/beacon:latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgres://user:pass@db:5432/beacon
      REDIS_URL: redis://redis:6379/6
      RAILS_MASTER_KEY: ${RAILS_MASTER_KEY}
      BRAINZLAB_PLATFORM_URL: http://platform:3000
    depends_on:
      - db
      - redis

bin/rails test
bin/rubocop

See CONTRIBUTING.md for development setup and contribution guidelines.

This project is licensed under the OSAaSy License.