Simple Uptime Monitoring

✅ Uptime Kita

"Kita" is the Indonesian word that means "Us"; this means that the uptime can be used for all of us

🥔 Live Demo

U can try the uptime kita demo (Server located on Germany)

• Status Page Demo: Demo Status

⭐ Key Features

• 🔐 Google Oauth authentication
• ✅ Monitoring uptime for HTTP(s)
• 🔒 Certificate check
• ✨ Fancy, Reactive, Fast UI/UX
• 📩 Notifications via Email (SMTP), Telegram, Slack, and the others are still in progress
• 🔔 Real-time toast notifications on public pages via Server-Sent Events (SSE)
• 📊 Multiple status pages
• 🐳 Docker support for easy deployment
• 📈 Server resources monitoring (CPU, Memory, Disk, etc.)
• 🏷️ Uptime badge for embedding in README/websites

🔧 How to Install

Requirements:

• php ^8.2 (and meet Laravel 12.x requirements).
• Node.js ^22
• Redis
• SQLite
• Crontab
• Supervisord

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on our development workflow, pull request process, and coding standards.

🔧 Installation

Clone repository:

git clone https://github.com/syofyanzuhad/uptime-kita

Install PHP dependencies:

composer install

Install javscript dependencies and build assets:

# install dependencies
npm install

# build assetes
npm run build

Setup .env file

# change directory to the uptime-kita
cd uptime-kita

# copy .env file from .env.example
cp .env.example .env

# admin credential
ADMIN_EMAIL=admin@syofyanzuhad.dev
ADMIN_PASSWORD=password123

# google oauth https://developers.google.com/identity/protocols/oauth2?hl=id
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# telegram bot token https://t.me/botfather
TELEGRAM_BOT_TOKEN=

# email configuration with https://resend.com/
RESEND_API_KEY=

Generate application key:

php artisan key:generate

Update default monitor on database/seeder/monitors/ directory and MonitorSeeder.php file

- seeders
|_ monitors
|  |_monitors.php
|  |_collages.php
|_ MonitorSeeer.php

// MonitorSeeder.php

/**
* Run the database seeds.
*/
public function run(): void
{
$monitors = require database_path('seeders/monitors/monitors.php');
$collages = require database_path('seeders/monitors/collage.php');

// others code
}

Create databases:

touch database/database.sqlite
touch database/queue.sqlite
touch database/telescope.sqlite

Run migration and seeder (this will prompt to create database.sqlite file if it doesn’t exists)

php artisan migrate --seed --force

Run the scheduler using cron job:

# open cron configuration
crontab -e

# copy this text to the end of line (change the path to your project path)
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

Read more about laravel scheduler

There are 2 ways to run the background job:

Laravel Queue

# install supervisord
sudo apt-get install supervisor

# add new file on /etc/supervisor/conf.d directory
touch /etc/supervisor/conf.d/laravel-worker.conf

# copy this text (change the path to your project path)
[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /home/path-to-project/artisan queue:work sqs --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=forge
numprocs=8
redirect_stderr=true
stdout_logfile=/home/forge/app.com/worker.log
stopwaitsecs=3600

Read more about laravel queue

Laravel Horizon

# install supervisord
sudo apt-get install supervisor

# add new file on /etc/supervisor/conf.d directory
touch /etc/supervisor/conf.d/horizon.conf

# copy this text (change the path to your project path)
[program:horizon]
process_name=%(program_name)s
command=php /home/path-to-project/artisan horizon
autostart=true
autorestart=true
user=forge
redirect_stderr=true
stdout_logfile=/home/path-to-project/horizon.log
stopwaitsecs=3600

sudo supervisorctl reread

sudo supervisorctl update

sudo supervisorctl start horizon

Read more about laravel horizon

Note

change the path to your project path

🐳 Docker Deployment

You can deploy Uptime Kita using Docker for easier setup and production deployment.

Quick Start with Docker

# Build the image
docker build -t uptime-kita .

# Run with docker-compose
docker compose up -d

Docker Compose

# Production
docker compose up -d

# Development (with hot reload)
docker compose --profile dev up -d

Environment Variables

Create a .env file or pass environment variables to the container:

APP_NAME=Uptime-Kita
APP_ENV=production
APP_KEY=base64:your-key-here
APP_URL=https://your-domain.com

The Docker image includes:

• Nginx web server
• PHP-FPM
• Supervisor for process management
• Cronless scheduler (no cron required)
• Queue workers

Cronless Scheduler

For environments without cron access (like some Docker/container setups), use the cronless scheduler:

# Run directly
php artisan schedule:run-cronless-safe

# With options
php artisan schedule:run-cronless-safe --frequency=60 --max-memory=256 --max-runtime=86400

Options:

• --frequency=60: Check interval in seconds (default: 60)
• --max-memory=512: Maximum memory in MB before restart (default: 512)
• --max-runtime=86400: Maximum runtime in seconds before restart (default: 24 hours)

See TROUBLESHOOTING-CRONLESS.md for troubleshooting tips.

📈 Server Resources Monitoring

Monitor your server’s health in real-time from the Settings page.

Features

• CPU Usage: Current usage percentage and core count
• Memory: Total, used, and free memory with usage percentage
• Disk: Storage usage for the application directory
• Server Uptime: How long the server has been running
• Load Average: 1, 5, and 15-minute load averages
• PHP Info: Version, memory limit, loaded extensions
• Laravel Info: Version, environment, debug mode status
• Database: Connection status and size
• Queue: Driver, pending and failed jobs count
• Cache: Driver and status

Access

Navigate to Settings > Server Resources to view the monitoring dashboard.

The page auto-refreshes every 5 seconds (configurable), with color-coded progress bars:

• 🟢 Green: < 70% usage
• 🟡 Yellow: 70-90% usage
• 🔴 Red: > 90% usage

🏷️ Uptime Badge

Embed an uptime badge in your README or website to show your service status.

Usage

![Uptime](https://your-uptime-instance.com/badge/your-domain.com)

Parameters

Parameter	Description	Default
period	Time period for uptime calculation	24h

Available periods: 1h, 24h, 7d, 30d, 90d

Examples

<!-- Default 24h uptime -->
![Uptime](https://uptime.syofyanzuhad.dev/badge/syofyanzuhad.dev)

<!-- 7-day uptime -->
![Uptime](https://uptime.syofyanzuhad.dev/badge/syofyanzuhad.dev?period=7d)

<!-- 30-day uptime -->
![Uptime](https://uptime.syofyanzuhad.dev/badge/syofyanzuhad.dev?period=30d)

Badge Appearance

The badge shows:

• Label: "uptime {period}" (e.g., "uptime 24h")
• Value: Uptime percentage (e.g., "99.9%")
• Color: Green (>= 99%), Yellow (>= 95%), Red (< 95%)

🔔 Real-time Status Notifications

Public monitor pages display instant toast notifications when a monitor’s status changes (up → down or down → up).

How It Works

The feature uses Server-Sent Events (SSE) for efficient real-time updates:

1. When a monitor status changes, the event is broadcast to connected clients
2. Public pages automatically subscribe to the SSE stream
3. Toast notifications appear instantly without page refresh
4. Connections auto-reconnect with exponential backoff if disconnected

Supported Pages

• Public Monitor List (/monitors/public) - All public monitors
• Public Monitor Detail (/monitors/{id}/public) - Specific monitor
• Status Pages (/status/{slug}) - Monitors on that status page

Toast Appearance

• 🟢 Green toast: Service recovered (down → up)
• 🔴 Red toast: Service down (up → down)
• Auto-dismiss after 8 seconds with progress bar
• Manual dismiss via close button

Technical Details

• SSE endpoint: /api/monitor-status-stream
• Heartbeat: Every 30 seconds
• Max connection duration: 5 minutes (auto-reconnect)
• Rate limited: 10 requests per minute

🛣️ Roadmap

• Uptime monitoring

• SSL Monitoring

• Monitoring history

• Notification:

• Email

• Telegram

• Slack

• Discord

• Status page

• Docker deployment

• Server resources monitoring

• Uptime badge for embedding

• Cronless scheduler for container environments

• Real-time toast notifications via SSE

• Do you have any suggestions?

📸 Screenshots

Private monitors

Public monitors

Detail Monitor

Status Page

Notification

📊 Activity

⭐️ Star History

---

Uptime Kita is an open-sourced software licensed under the Apache-2.0