Welcome to CuliUptime

CuliUptime is a production-ready, free and open-source uptime monitoring service that helps you monitor your websites, APIs, and services 24/7. Built with modern technologies, enterprise-grade security, and developer-first principles.

🚀 Quick Start Options

Option 1: Cloud Service (Recommended)

Get started instantly with our free cloud service:

👉 Try CuliUptime Cloud - No setup required!

Option 2: Self-Hosted

Deploy CuliUptime on your own infrastructure:

Development Setup:

git clone https://github.com/chiplonton/culiuptime.git
cd culiuptime
docker-compose -f docker-compose.dev.yml up -d

Production Deployment:

git clone https://github.com/chiplonton/culiuptime.git
cd culiuptime
# Configure .env with production settings
DOMAIN=your-domain.com EMAIL=[email protected] ./scripts/init-letsencrypt.sh
# Initialize database schema
docker compose -f docker-compose.prd.yml exec backend alembic upgrade head

📖 Self-Hosting Guide for detailed instructions. 📖 Production Deployment Guide for production setup.

✨ Key Features

• 🆓 100% Free & Open Source - AGPL-3.0 license, no hidden costs
• ⚡ Fast Setup - 5-minute Docker deployment
• 🌍 Global Monitoring - Deploy agents worldwide
• 📧 Real-time Alerts - Email notifications with more channels coming
• 🔒 Enterprise Security - OAuth2, HTTPS, HMAC auth, OWASP compliance
• 🛠️ Developer-Friendly - REST API, OpenAPI docs, modern stack

🏗️ Architecture

CuliUptime uses a modern, scalable architecture:

┌─── React Frontend ───┐    ┌─── FastAPI Backend ───┐
│  • TypeScript        │    │  • Python 3.11+      │
│  • Real-time UI      │◄──►│  • PostgreSQL DB     │
│  • OAuth2 Login      │    │  • Redis + Celery    │
└──────────────────────┘    └───────────────────────┘
                                       │
                                       ▼
                            ┌─── Global Agents ───┐
                            │  • PHP Agents       │
                            │  • HMAC Security    │
                            │  • Multi-location   │
                            └─────────────────────┘

📚 Documentation Structure

• Getting Started - Choose cloud or self-hosted
• User Guide - Using the web interface
• Self-Hosting - Deploy your own instance
• API Reference - REST API documentation
• Development - Contributing to the project

🤝 Community & Support

• 🐛 Issues: GitHub Issues
• 📖 Contributing: Contributing Guide
• 🔒 Security: Security Policy

📄 License

CuliUptime is licensed under the AGPL-3.0, ensuring it remains free and open source forever.

---

Ready to get started? Choose your deployment method 🚀