First Steps
Go from an email invitation to live production data entirely on your own — no Mirox support call needed. This guide walks the complete self-service path: register your account, build your organization, model your plants, then run each plant through the guided five-step onboarding wizard until data starts flowing.
The Whole Path Is Self-Service
Every stage below is something you do yourself in the Mirox platform. The only point where another party is involved is if one of your data loggers needs a brand-new adapter we have not built yet — and even then you keep working while we add it. See Configuring Data Loggers.
The Path at a Glance
Note: inviting your team is optional — you can do everything yourself and add colleagues whenever you like.
Stage 1: Register Your Account
You join Mirox through an invitation. When you are invited, you receive an email with a personal sign-up link.
- Open the invitation email and click the registration link.
- Your email address is pre-filled and locked — just choose a password (at least 8 characters, including one special character) and confirm it.
- Submit. With an invitation link you are logged in immediately and land on your dashboard.
Open in Mirox
Register an account — open the link from your invitation email, which carries your personal sign-up token.
Login is protected and, in production, can require a second factor. We recommend enabling it right away — see Setting Up Two-Factor Authentication. Registration is invite-only by design; the full mechanism is described in Authentication.
Stage 2: Create Your Organization
Your organization is the home for everything else — your plants, your team, your files, and your billing. The person who creates it becomes its Admin.
- After registering, create your organization and enter its details (name, contact and business information).
- You are automatically the organization Admin, with full management rights.
Resources follow a strict hierarchy — organization ▸ portfolio ▸ plant — and this hierarchy drives both reporting rollups and who can see what. The model is explained in Resources.
Open in Mirox
Open the app and follow the organization-setup prompt after you first sign in.
Invite Your Team (Optional)
If colleagues will work alongside you, invite them now or any time later. You invite each person by email and pick the organization role that fits them:
| Organization role | What it grants |
|---|---|
| Admin | Full organization management. |
| Moderator | Manages resources across the whole organization. |
| Asset Manager (Technical) | Technical asset management across the organization's plants. |
| Asset Manager (Commercial) | Commercial asset management — can read and create tickets, with no destructive technical actions and no billing access today. |
| Member | Standard read-only access. |
| External | No resource access by default. |
Asset Manager (Technical) and Asset Manager (Commercial) are peer roles under Moderator and cannot assign each other. You can also grant a member a finer-grained job role (Operator, Technical Manager, Asset Manager, Viewer) on a single plant or portfolio. The full procedure — including pausing access, setting an expiry, and the peer-aware assignment rule — is in Managing Member Permissions.
Open in Mirox
Organization ▸ Team — invite a member and choose their organization role.
To share specific plants with a separate company (for example a service provider), use a cooperation instead of an organization invite — see Creating Cooperations.
Stage 3: Create a Portfolio and Add Plants
A portfolio groups related plants for reporting and access control; each plant is one renewable-energy asset.
- Open your organization's Resources tab and create your first portfolio (give it a name and assign an owner).
- In the same tab, create a plant and fill in its core details:
- Name
- Plant type — solar or wind
- Location (latitude / longitude)
- Installed peak production capacity
- Date of build
- Assign the plant to the portfolio you just created.
Open in Mirox
Organization ▸ Resources — create a portfolio, then add plants to it.
You Don't Enter Equipment by Hand
You do not type in inverters, strings, batteries, or meters during setup. Once the connection is live, the Mirox-Agent discovers your equipment automatically and it appears under the plant for you to review and name. See Resources.
Stage 4: Run the Onboarding Wizard
Each solar plant carries a small Onboarding progress indicator in the plants table. Click it to open the guided five-step wizard. The wizard walks the steps in order, unlocking Next only once the current step is genuinely done, and the progress bar updates live as you go. You can revisit any step at any time, and the regular plant menus stay available if you prefer to work outside the wizard.
Open in Mirox
Open the onboarding wizard for your default plant, or open a plant from your plants and click its Onboarding indicator (also reachable from Organization ▸ Resources). The wizard opens at the first step you still need to finish.
Step 1 — Upload Documents
Upload everything that describes the plant: yield reports, datasheets, contracts — any source document. Every file you add is analysed and tagged in the background, so the rest of the wizard can pre-fill values from it.
- Drag files into the upload area; they are stored in the plant's file storage.
- Wait for the background analysis to settle — Next stays disabled while files are still uploading or being analysed. The more documents you provide, the better the suggestions in Step 2.
The same file area is available outside the wizard, and the AI auto-tagging is covered in Using File Storage.
Step 2 — Complete Park Data
This step makes sure the plant's master data is correct. The platform can pre-fill fields from the documents you uploaded; you review, correct, and complete them.
- Click Analyse documents (or Analyse again) to have the platform read your files and propose values. Suggestions appear inline next to each field — accept them one by one, or use Apply all per tab.
- Fill in the essential fields — the step is done only when all of these carry a value:
- Peak power (the plant's installed capacity)
- Inverter AC limit
- Latitude and longitude
- All 12 monthly performance-ratio (PR) values
- Optional fields (date of build, grid operator, project company, address, description, key contacts) sharpen reporting but do not block progress.
Why the Essentials Matter
Peak power, the inverter limit, coordinates, and the monthly PR values feed the clear-sky simulation and performance calculations. Getting them right here is what makes later loss detection and yield comparisons meaningful.
Key contacts (Grid Operator, Project Company, and others) can also be set on this step. Managing them in depth is covered in Managing Plant Contacts.
Step 3 — Configure VPN
A secure VPN connection lets the platform reach the plant's router so it can talk to the loggers and inverters behind it. This step is complete once at least one VPN connection reports as up.
- Add a VPN connection to the plant router and wait for it to come up — the status banner shows the live state (deploying, updating, up, or not responding).
- Next unlocks the moment one connection is up.
Each change re-deploys the plant's agent, so give the status banner a moment to settle. For the broader picture of VPN access and the full set of options, see the VPN feature; for the day-to-day task guide, Using the VPN and Configuring VPN Servers per Agent (Direct VPN).
Open in Mirox
The VPN section lives inside the wizard. To open the full page later: Networking ▸ Site VPN for your default plant.
Step 4 — Network Devices
With the VPN up, the platform scans the plant's local network and lists every reachable device — loggers, inverters, and meters. This step is complete once at least one device is discovered.
- Click Discover to start a scan. The discovery insights bar shows progress and counts as devices appear.
- You can Abort a running scan at any time — devices already found are kept.
Discovery, device classification, latency, and the credential vault are explained in Local Network Inspector, and the task-by-task guide is Managing Network Devices.
Open in Mirox
The scan control is in the wizard. Full table later: Networking ▸ Devices for your default plant.
Step 5 — Data Loggers
The final step maps discovered network devices to logger adapters so the platform begins collecting production data, alarms, and status. This step completes once at least one logger is configured and the agent has picked it up.
- In the possible loggers table, find a discovered device the platform already has an adapter for and click + to open the guided logger wizard.
- The wizard runs a live dry run against the device — a real probe, not a simulation — and streams back the raw and mapped values it reads, so you can confirm the connection works before saving.
- Save (adopt) the logger; the agent re-deploys to pick it up.
Open in Mirox
The logger tables are in the wizard. Full page later: Data flow for your default plant.
Zero-Config Auto-Onboarding
For supported logger families — Janitza, Huawei, and Phoenix Contact — onboarding is effectively zero-config: the device is recognised and mapped automatically. Other devices may need an adapter we have not built yet; in that case the platform tells you, and you can request an integration while you continue with the rest. The adapter system is explained in Data Scraper.
Stage 5: First Data Is Flowing
Once the five steps are green, the plant is collecting data. From here:
- Watch live production, losses, availability, and specific yield on the KPI Dashboard.
- Review and name the equipment the agent discovered — see Configuring Components.
- Schedule regular performance and financial updates with Reports.
Open in Mirox
Production dashboard — open your default plant to see its dashboard and incoming data, or browse all your plants.
Set Up Billing in Parallel
A flat monthly price applies per active plant. You can sign your service contract, register billing contacts, and set up a payment method at any point — none of it blocks reaching first data. See Accounting & Billing.
Related Guides
- Resources — the organization ▸ portfolio ▸ plant hierarchy your setup builds on
- Managing Member Permissions — invite teammates and grant plant-level job roles
- Using the VPN — reach your plants over the personal VPN
- Managing Network Devices — scan, classify, and monitor the devices behind the VPN
- Configuring Data Loggers — adapters, the live probe, and supported logger families
- Setting Up Two-Factor Authentication — secure your account before you go live
- Permission System — the full organization and job-role model