# Bot-Hosting Status

> Real-time uptime monitoring dashboard for Bot-Hosting.net services. Tracks websites, server nodes, and databases with live status, incident history, uptime history, Discord webhook alerts, a developer API, and embeddable status widgets.

Bot-Hosting Status is the official status page for Bot-Hosting.net, a free and premium hosting platform. The site monitors the health of all Bot-Hosting infrastructure—including the main website, wiki, control panel, advertising site, multiple free and premium server nodes across Europe and the US, and database services—and presents real-time uptime data, latency metrics, incident timelines, and historical reliability to users and administrators.

## Key Features

- **Live Status Dashboard**: Real-time monitoring of ~26 services grouped into categories (Websites, Free Nodes, Premium Nodes, Databases) with 30-second auto-refresh via WebSocket.
- **90-Day Uptime History**: Color-coded daily uptime strips with tooltips showing up/down/partial counts per category.
- 365 day uptime history also available*
- **Incident Management**: Full incident timeline with severity levels, status updates, and resolution tracking. Admins can create, update, and resolve incidents.
- **Scheduled Maintenance**: Automate maintenance windows with start/end times and automatic monitor status toggling.
- **Discord Webhook Alerts**: Users connect a Discord webhook to receive real-time outage and incident notifications, with priority monitor selection and alert type filtering.
- **Custom Port Monitors**: Authenticated users can add their own bot-hosting server ports (20000–30000 range) for active health monitoring via `/health` endpoint checks.
- **Developer API**: JSON API endpoints for querying status, uptime, daily history, and custom monitors. API key authentication with rate limiting and usage tracking.
- **Embeddable Widgets**: iframe embed pages and a lightweight JavaScript widget (`widget.js`) for displaying live monitor status on external sites. Supports dark and light themes.
- **Admin Panel**: Full admin dashboard for managing monitors, incidents, maintenance schedules, broadcast alerts, admin logs, and user reports.
- **Reports System**: Users can report monitor issues; admins review and manage reports.
- **Dark/Light Theme**: Automatic theme detection with manual toggle, persisted in localStorage.
- **Mobile Responsive**: Optimized sidebar navigation with touch gestures, responsive grids, and mobile-specific UI adaptations.
- **Offline Support**: Service worker with offline caching and a visible offline banner.

## Monitored Services

- **Websites**: Main Website (bot-hosting.net), Wiki, Legacy Control Panel, Advertising Website, Panel API
- **Free Nodes**
- **Premium Nodes**
- **Domain Proxies**
- **Databases**: Free & Premium MySQL Databases

## Pages

| Route | Description |
|-------|-------------|
| `/` | Main status dashboard with all monitors, active incidents, and uptime history strips |
| `/monitor/:id` | Individual monitor detail page with latency charts and history |
| `/incidents` | Full incident history timeline with stats (30d/90d counts, avg resolution time) |
| `/history` | Daily uptime history archive with detailed per-day snapshots |
| `/alerts` | Webhook setup, custom port monitors, API key management, and alert configuration |
| `/docs` | Developer API documentation with endpoint reference and embed/widget guides |
| `/legal` | Legal information, privacy policy, and API usage terms |

## Embeds

Embed live monitor status on external sites using one of two methods:

1. **iframe Embed**: `<iframe src="https://status.bot-hosting.net/pub-api/embeds/{monitorId}" width="320" height="140" frameborder="0"></iframe>`
2. **JavaScript Widget**: Include `/pub-api/widget.js` and configure `window.BOT_HOSTING_WIDGETS` with monitor IDs.

Both support `?light=true` for light theme.

## Tech Stack

- **Frontend**: React 18, React Router 6, Recharts, Vite, Lucide icons
- **Backend**: Express.js, Node.js
- **Database**: PostgreSQL (via `pg` and `connect-pg-simple` for sessions)
- **Auth**: Discord OAuth2 via Passport.js
- **Security**: Helmet.js, express-rate-limit, CORS, CSRF-safe session handling
- **PWA**: Service worker, manifest.json, offline support

## Contact

- **Website**: https://bot-hosting.net
- **Status Page**: https://status.bot-hosting.net
- **Email**: contact@bot-hosting.net
- **GitHub**: https://github.com/bot-hosting