Getting Started

Welcome to OpenMoni. This guide walks you through creating your first monitor and understanding the dashboard.

What is OpenMoni?

OpenMoni is an open-source server monitoring platform that checks your websites, APIs, and infrastructure in real time. When something goes wrong, OpenMoni records the incident and can notify you by email.

Create an account

1. Go to /register.
2. Enter your name, email, and password.
3. Click Create account.
4. Log in at /login.

You can also sign in with Google OAuth if your instance has it configured.

Add your first host

A host is anything you want to monitor — a website, API, or service endpoint.

1. From the dashboard, click Add host or go to /hosts/new.
2. Enter a name (for example, "Production API").
3. Select a platform (web, Railway, AWS, etc.).
4. Enter the URL or endpoint to check.
5. Choose a check interval (for example, every 5 minutes).
6. Click Create host.

OpenMoni will start checking the endpoint immediately.

Understand host status

Each host shows one of the following statuses:

• Active — monitoring is enabled.
• Inactive — monitoring is paused.
• Maintenance — the host is in maintenance mode.

A check result is either up or down. The dashboard shows the latest result, average response time, and uptime percentage.

View incidents

When a check fails, OpenMoni creates an incident. You can view open incidents from the dashboard or from the /incidents page (if enabled). Each incident includes the start time, severity, status, and related check history.

Next steps

• Read the MCP integration guide to let AI assistants query your monitoring data.
• Read the API reference to automate host management.