Kaffeine

Free & Open Source Uptime Monitoring
kaffeine.arkynox.com »

Features • Tech Stack • Getting Started • Contributing • Security • License

Kaffeine is a free, open-source uptime monitoring platform by Arkynox. Monitor websites and databases with real-time health checks, AES-256 encrypted storage, Cloudflare-powered distributed monitoring, and role-based dashboards — all 100% free.

_{built by Arkynox}

Features

• Website Monitoring — HTTP/HTTPS health checks with configurable intervals
• Database Monitoring — Monitor MongoDB, PostgreSQL, MySQL, and more
• Real-Time Alerts — Instant notifications via server-sent events
• Encrypted Storage — AES-256 encryption for all connection strings and secrets
• Distributed Checks — Cloudflare Workers for global, low-latency monitoring
• Role-Based Dashboards — User and admin panels with granular access control
• Detailed Analytics — 24-hour uptime charts, status history, and metrics
• 100% Free — No credit card, no hidden limits, no paid tiers

Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router, React 19)
Language	TypeScript (strict)
Styling	Tailwind CSS v4 + shadcn/ui
Database	MongoDB
Auth	Session-based (HTTP-only cookies) + JWT
Real-Time	Server-Sent Events (EventSource)
Monitoring	Cloudflare Workers (distributed health checks)
Encryption	AES-256-CBC / bcrypt

Getting Started

Prerequisites

• Node.js 18+
• MongoDB — local or MongoDB Atlas
• Cloudflare account (optional, for distributed monitoring)

Quick Start

1. Clone the repo

   git clone https://github.com/akkilmg/kaffeine.git
   cd kaffeine

2. Install dependencies

   npm install

3. Set up environment variables

   cp .example.env .env

   Edit .env and fill in your MONGODB_URI, ENCRYPTION_KEY, and JWT_SECRET.

4. Run the dev server

   npm run dev

5. Open http://localhost:3000 and create your first account.

See resource/QUICKSTART.md for a detailed walkthrough.

Contributing

We welcome contributions from everyone! See our Contributing Guide for detailed instructions.

Quick links:

• Code of Conduct
• Bug Reports
• Feature Requests
• Pull Request Template

Quick Steps

1. Fork the repo
2. Create a feature branch (git checkout -b feat/my-feature)
3. Make your changes
4. Run npm run lint and npm run build
5. Submit a pull request

Security

Found a security vulnerability? Please read our Security Policy for responsible disclosure guidelines. Do not open public issues for security vulnerabilities.

License

Released under the Apache License 2.0 by Arkynox.

---

_{Built with ❤️ by Arkynox — contributions welcome!}