README.md
Rama main · réplica de lectura del repositorio original.
<div align="center">
<a href="https://uptimekit.dev">
<img src="https://r2.uptimekit.dev/logos/uptimekit.svg" alt="UptimeKit Logo" width="120" height="120">
</a>
<h1 align="center">UptimeKit</h1>
<p align="center">
<strong>The modern open-source status page and monitoring solution.</strong>
</p>
<p align="center">
<img src="https://shieldcn.dev/group/github/stars/uptimekit/uptimekit+github/forks/uptimekit/uptimekit+github/license/uptimekit/uptimekit.svg?variant=outline" alt="badges">
</p>
<img width="1624" height="997" alt="image" src="https://github.com/user-attachments/assets/32140a84-8002-43c3-bd42-799149be9b48" />
<br/>
<!-- looks kinda bad
<img src="https://r2.uptimekit.dev/banners/banner-smaller.png" alt="UptimeKit Banner" width="100%"> -->
</div>
<!--    -->
<br/>
## Features
UptimeKit is designed to be the all-in-one solution for tracking your services' uptime and communicating with your users.
- **Monitoring** - Real-time uptime monitoring for your HTTP/TCP services.
- **Status Pages** - Beautiful, customizable status pages for your users.
- **Incidents** - Create and manage incident reports to keep users informed.
- **Organizations** - Multi-tenant support with team management.
- **Analytics** - Detailed uptime and response time metrics.
- **Self-Hostable** - Full control over your data and infrastructure.
- **Instatus Integration** - Display monitors from external instatus pages on your status page,
## How it works
Uptimekit is a distributed monitoring solution. You can have as many workers as you want and as many replicas of the app as you want.
The workers check with the app every 15 seconds to get their assigned monitors and run the checks whenever they have to.
## Getting Started
Follow these steps to get UptimeKit running locally on your machine.
### Prerequisites
- PostgreSQL
- Clickhouse (optional)
### Install
1. **Download the docker-compose.yml and .env.example**
```bash
curl -o docker-compose.yml https://raw.githubusercontent.com/uptimekit/uptimekit/main/docker-compose.yml && curl -L https://raw.githubusercontent.com/uptimekit/uptimekit/refs/heads/main/.env.example -o .env
```
2. **Edit these variables in the .env**
```bash
APP_SECRET=change_me_to_a_secure_secret # openssl rand -hex 32
APP_URL=http://localhost:3000
# Status Page Configuration (Optional)
APP_STATUS_PAGE_DOMAIN=status.example.com
```
Point both `APP_URL` and `APP_STATUS_PAGE_DOMAIN` at the same UptimeKit service.
The dashboard and public status pages are served from the same container.
3. **Start the docker compose**
```bash
docker compose up -d
```
4. Now follow the steps on the app. Enjoy :D
## Project Structure
```bash
uptimekit/
├── apps/
│ ├── dash/ # Main Dashboard application
│ ├── worker/ # Probe who actually pings the monitors
├── packages/
│ ├── api/ # Shared API definition & logic
│ ├── auth/ # Authentication configuration
│ ├── db/ # Database schema & Drizzle config
│ └── config/ # Shared configuration (TS, ESLint, etc.)
└── ....
```
## 💝 Sponsors
Thank you to all our amazing sponsors who make this project possible!
<p align="center">
<a href="https://neon.com">
<img src="https://r2.uptimekit.dev/logos/neon-logo.svg" alt="Neon" height="50">
</a>
</p>
**[Become a sponsor](https://github.com/sponsors/irazvan2745)** and get your logo here!
## 🤝 Contributing
We welcome contributions! Please check out our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and request features.
## 📄 License
This project is licensed under a [MIT License](LICENSE)
---
## Star History
<a href="https://www.star-history.com/?repos=uptimekit%2Fuptimekit&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=uptimekit/uptimekit&type=date&theme=dark&legend=top-left&sealed_token=pZxQDdxjnggzp90uakNdKGMS2_ZxGHDzplL-N6q4bl78Vy0v-waIwW6XEjHSJjhu6OSbMA0N0TL_W72AhXOT5W4iYhOmNQOKeeOtyJsK5-4w2HJDnEuLsA" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=uptimekit/uptimekit&type=date&legend=top-left&sealed_token=pZxQDdxjnggzp90uakNdKGMS2_ZxGHDzplL-N6q4bl78Vy0v-waIwW6XEjHSJjhu6OSbMA0N0TL_W72AhXOT5W4iYhOmNQOKeeOtyJsK5-4w2HJDnEuLsA" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=uptimekit/uptimekit&type=date&legend=top-left&sealed_token=pZxQDdxjnggzp90uakNdKGMS2_ZxGHDzplL-N6q4bl78Vy0v-waIwW6XEjHSJjhu6OSbMA0N0TL_W72AhXOT5W4iYhOmNQOKeeOtyJsK5-4w2HJDnEuLsA" />
</picture>
</a>
<div align="center">
<sub>Built with ❤️ by the UptimeKit Team</sub>
</div>