Getting started
Welcome to the official documentation of Ravicor 7.2. This page introduces the product, the requirements, installation, first access, and the subscription plans. If you already know what you are looking for, use the shortcuts below.
What is Ravicor
Ravicor is a complete network management platform built for internet service providers (ISPs). You install the system on your own Linux server, physical or virtual, and operate your entire network through a 100% web interface: from the signal of each ONU to mitigating a DDoS attack.
The main environments of the system are:
- Devices and Sensors: monitoring of routers, switches, servers, and any equipment via SNMP and ping, with alert conditions and notifications by email, Telegram, and WhatsApp. See Devices and sensors.
- OLT (fiber/GPON): ONUs and ONTs from 15 brands, RX/TX signal, ONU authorization, and cut-fiber alerts. See OLT and fiber.
- Concentrator (BNG/PPPoE): PPPoE sessions with latency, traffic, drops, and reconnections. See Concentrator.
- Flow New in 7.2: NetFlow/IPFIX/sFlow collection with per-vector attack detection and BGP mitigation (FlowSpec and RTBH), enabled by plan. See Flow: overview and analysis.
- ACS (TR-069) New in 7.2: management of the routers installed at subscribers, with automatic inventory, Wi-Fi, provisioning profiles, bulk actions, routines and model homologation, enabled by plan. See ACS (router management).
- Dashboards (NOC/TV) New in 7.2: custom screens with a visual editor and slideshows for TV. See Dashboards.
- Backups New in 7.2: daily backup of the configuration of your network equipment, multi-brand, with change history. See Equipment backups.
- DNS: the provider's recursive and authoritative server, with statistics and reverse (PTR). See DNS.
- IPDOCS: IP block documentation, scanner, and RBL check. See IPDOCS.
- AI Copilot New in 7.2: an artificial-intelligence assistant that performs real actions in the system. See AI Copilot.
- Extras: web terminal, WinBox in the browser, WireGuard, service monitoring, PDF reports, public API, and mobile app.
Version 7.2 was released on June 30, 2026. A summary of the new features is in the What's new in 7.2 section, at the end of this page.
How it works
The entire system runs on your server: web interface, database, collectors, and auxiliary services. Your network's monitoring data stays with you; none of your subscribers' traffic leaves the server.
In general terms:
- Continuous collection: scheduled tasks collect data from the environments (devices, OLT, concentrator, Flow, IPDOCS) every minute and process alerts. There is nothing for the operator to "run": after installation, everything is automatic.
- Web interface: the entire operation happens through the browser, at the IP configured during installation. Access can receive an SSL certificate later, through the Settings.
- Ravi central: the server communicates periodically (every 10 minutes) with the Ravi central over an end-to-end encrypted channel. It is through this channel that it validates the license and plan, sends usage telemetry, and receives the new-version notice with the digitally signed update package.
The central handles only licensing, plan enforcement, and update distribution: your subscribers' traffic and data never travel over this channel.
License validation has some slack: a single successful synchronization per day is enough for the plan to stay valid. Short internet outages have no effect. Blocking only happens after more than 3 days without a successful synchronization, or from prolonged non-payment (see Plans and features).
For details on licensing, synchronization, and automatic updates, see System updates.
Requirements
Ravicor is distributed as its own ISO based on Debian 11 (64-bit). The ISO installs the operating system and everything else: web server, database, and auxiliary services. You do not install anything manually, neither during installation nor afterward: the automatic updates keep the whole stack current.
Minimum hardware
| Resource | Minimum |
|---|---|
| Processor | 4 cores, 64-bit |
| RAM | 6 GB (8 GB recommended on a virtual machine) |
| Disk | 80 GB |
These are minimum values. The more equipment, sensors, ONUs, and sessions you monitor, the more resources the server needs. A practical Flow reference: receiving the full BGP table (about 1.1 million routes) is comfortable with 12 GB of RAM or more and saturates with less than 6 GB.
The system itself protects you from overload: Flow classifies the server's real capacity (RAM, cores, and load) and blocks heavy features the hardware cannot handle, such as ClickHouse, per-city GeoIP, and forensic capture. The operator monitors this on the capacity tab of the Flow settings (see Server capacity). The daily equipment backup also has a safety lock: it does not run if there is less than 2 GB free on disk.
Network and internet
- The server needs outbound internet access over HTTPS: this is how it synchronizes license and plan with the Ravi central, downloads updates, Debian packages, and the optional Flow databases (ASN, GeoIP, threat intelligence).
- The web panel is accessed through the IP defined during installation. SSL is configurable later, in the Settings (Ravi wildcard certificate or your own certificate).
- The update automatically enables fail2ban: after several wrong SSH passwords, the source IP is temporarily blocked by brute-force protection. If SSH "stops responding" after password errors, that is this protection at work, not a failure.
Without outbound HTTPS access to the internet and to the Debian repositories, the server does not validate the license or receive updates. Always keep this access open on your edge firewall.
Installation
Installation is the same for a dedicated server and for a virtual machine: write or point to the ISO, follow the installer, and access the panel at the configured IP. The official ISO is available at ravicor.com/teste-gratis.
Dedicated server (bare metal)
- Download the ISO from ravicor.com/teste-gratis.
- Write the ISO to a bootable USB drive (for example, with Rufus).
- Boot the server from the USB drive.
- Follow the installer: enter the IP, Gateway, and network mask, and set the root password.
- Restart and access the web panel in your browser, at the configured IP.
Virtual machine
The process works with any hypervisor (Proxmox, VMware, Hyper-V, KVM), as long as the virtual CPU is 64-bit.
- Create the VM pointing to the ISO. Recommendation: at least 4 cores, 8 GB of RAM, and 80 GB of disk.
- Follow the same installer: IP, gateway, mask, and root password.
- Restart the VM and access the panel at the IP.
On a virtual machine, taking a snapshot before major changes is cheap and recommended. It is your extra safety net, on top of the protections built into the system update itself.
One installation corresponds to one server. Cloning the VM and keeping both copies active creates an identity conflict at the central (anti-clone protection) and the plan stops being applied. To migrate to another server, use backup and restore and let the system register itself again on its own; never run both at the same time.
After installing, check the time zone in the Settings (Select a timezone field): it aligns the date and time of logs and reports.
First access
On the first access to the panel, when no user exists yet, the system automatically opens the welcome wizard to create the first user. This screen has a language selector and a light/dark theme toggle.
- Open your browser and go to the IP configured during installation.
- In the wizard, choose the Language: besides adjusting the screen itself live, it sets the system's default language.
- Fill in Name, User, Password, and Confirm Password.
- Enter a real Phone and Email: they are used for password recovery.
- Click Continue. The system takes you to the login screen.
The user created in this wizard is the Master, with full access to the system. You use it to create the other users and set permissions later, in Users and permissions.
Trial period
Every new installation starts on the TRIAL plan: 10 days with all features enabled, equivalent to the ENTERPRISE plan. During the trial, the top of the system shows Test version and a countdown expiration notice. At the end of the 10 days, the plan drops to FREE and the paid features are blocked until registration.
Registration and plan activation
- To subscribe, use the Register now! menu item (visible to Master and Admin during the trial or after expiration). It opens the Ravi website already identifying your server.
- The server identification token is in Settings, in the RAVI Registration card, with the Copy button.
- After subscribing or changing plans, go back to the RAVI Registration card and click Update: this forces an immediate synchronization with the central and the new plan takes effect at once. Without this click, the plan is applied within 10 minutes, at the next automatic synchronization.
Plans and features
The subscription plan is defined at the Ravi central and automatically synchronized to your server. The name of the active plan appears in the system header, next to the logo, for the Master user.
| Plan | What it unlocks |
|---|---|
| RAVI FREE | Unregistered server or expired trial. Paid features blocked. |
| RAVI 250 / 500 / 1000 / 2500 / 5000 | Legacy plans, sized by network scale. |
| BASIC | Basic monitoring of devices and sensors. No OLT and no Concentrator. |
| NORMAL | Everything in BASIC, plus 1 OLT and 1 concentrator. |
| PREMIUM | Up to 4 OLTs and up to 4 concentrators. Flow enabled with 1 exporter. |
| GOLD | Unlimited OLTs and concentrators. Flow with up to 4 exporters. |
| ENTERPRISE | Everything unlimited, including Flow exporters. |
| TRIAL | 10-day trial, equivalent to ENTERPRISE. |
Important points about the limits:
- The Flow environment Premium+ plan is only enabled on the PREMIUM, GOLD, ENTERPRISE, and TRIAL plans. The Flow menu item is always visible, even without an eligible plan: it is through it that you learn about, subscribe to, and activate the feature.
- The ACS environment Premium+ plan also belongs to the PREMIUM, GOLD, ENTERPRISE, and TRIAL plans. Unlike Flow, the ACS menu item only appears when the plan includes the environment.
- When you try to register an OLT, concentrator, or exporter beyond the plan limit, the system shows an upgrade message and does not complete the registration. There are no surprise charges.
- If the plan drops to FREE (expired trial), the DNS environment is automatically disabled and the resolver starts forwarding queries to public resolvers: your customers do not lose name resolution, you lose the management until you regularize.
- Prolonged non-payment (more than 15 days overdue) or more than 3 days without being able to synchronize with the central drop the web session of all users until it is regularized.
Changed plans? Go to Settings, the RAVI Registration card, and click Update for the new plan to take effect immediately.
What's new in 7.2 New in 7.2
7.2 is the biggest version leap in the product's history, with about 160 cataloged advances. These are the main highlights of the version:
- Flow environment: real-time DDoS detection and mitigation with NetFlow/IPFIX/sFlow, FlowSpec and RTBH via BGP, 1-click mitigation approval over WhatsApp, and automatic PDF post-mortem. See Flow: overview and analysis and Flow: configuration and mitigation.
- ACS environment (TR-069): complete management of subscriber routers, from automatic inventory and the health score to Wi-Fi, cascading profiles, bulk actions, autonomous routines and AI-driven model homologation. Works even behind CGNAT. See ACS (router management).
- AI Copilot: an assistant present throughout the system that performs real actions (create, edit, delete, access equipment via SSH), and not just answers questions. See AI Copilot.
- Dashboards environment: custom screens for TVs and NOC with a visual editor, 19 widget types, rotating slideshows, and multi-server dashboards that consolidate several POPs into one panel. See Dashboards.
- Backups environment: automatic daily backup of the configuration of all network equipment, with AI discovery, change history (diff), and credentials encrypted in a vault. See Equipment backups.
- New Devices, OLT, and Concentrator screens: a hive view with thousands of ONUs and sessions on screen, native panels, and configurable columns. See Devices, OLT, and Concentrator.
- Remote probes: a lightweight agent (including for Windows) paired by token, to monitor remote networks and POPs in the same device tree. See Remote probes.
- Account security: two-step verification (2FA), trusted devices, multiple sessions with remote disconnection, and action auditing. See Account and security.
- New experience: dark theme across the whole system, a redesigned mobile interface, and three languages (Portuguese, English, and Spanish) with per-user selection. See Interface and navigation.
- Expanded public API: complete Flow via API and real creation, editing, and deletion of devices and sensors. See the API documentation.
- Digitally signed updates, with gradual rollout (canary): more security and control as the platform evolves. See System updates.
Within the system itself, the What's new page shows the release timeline in customer-friendly language: hover over the avatar in the top-right corner and click What's new. Details in What's new page.
If you are coming from version 7.1, start with Coming from version 7.1: there you will find the screens that moved, what was replaced, and what migrates on its own.