Quick Start
First-run setup and your first monitors. The full walkthrough is in SiroPing in 10 Minutes.
Create the first admin
Open https://<your-server>/setup/. If no user exists yet, SiroPing shows the form to create
the first Administrator — your username + a strong password.
NOTE
There is **no default password**. If users already exist, `/setup/` is locked (404) —
use `/login/`. The `/setup/` flow is first-run only.
SiroPing creates your workspace and logs you into the dashboard.
tip
Enable **2FA** right after setup (Settings → Two-Factor Authentication) and rotate the
root password. See [Security](./security/).
Add an HTTP monitor
- Monitors → New HTTP Monitor.
- Name + URL (
https://example.com), keep the defaults. - Optionally set Expected status, Basic Auth, Expected Content or SSL monitoring.
- Save. The first check runs within the interval; the monitor turns Up (green).
See HTTP Monitoring for every option.
Add a heartbeat monitor
For cron/backup jobs: New Heartbeat Monitor → paste the Ping URL into your cron:
# crontab of the job that should run "on time"
*/5 * * * * curl -fsS https://<your-server>/monitor/ping/<token>/ >/dev/null
If no ping arrives within interval + grace, SiroPing opens an incident and alerts.
See Heartbeat Monitoring.
Verify with Doctor
sudo -u siroping /opt/siroping/venv/bin/python /opt/siroping/manage.py doctor
- Overall: HEALTHY is the target.
WARNINGon a fresh install is expected until SMTP,ALLOWED_HOSTSand a monitor are configured — Doctor tells you exactly what is missing.
Next steps
- Alerts — configure Email/Telegram/Webhook in Settings → Notifications and send a test.
- Team — invite members; see Incidents & Alerts and the Team guide.
- Client deliverables — monthly reports and status pages: Reports, Status Pages.