License
Navigate to System > License to view your current license status and manage activation.
License Status
The page displays a status banner at the top indicating the current state:
License Details
When a license is present (valid or invalid), a details card shows:
The License ID, Request ID, and Hardware ID fields are copyable — click them to copy to your clipboard.
Activating a License
If no valid license is present, the page shows the three-step activation wizard. This is the same flow shown on first login.
For step-by-step activation instructions, see Licensing Koios.
Re-Activation
If you need to re-activate — for example, after moving Koios to a different server or VM — click "Need to re-activate your license?" on the license page. This expands the activation wizard so you can generate a new activation file for the current hardware.
First-Login Flow
On first login to a new Koios installation, the application guides you through an onboarding sequence:
- Account setup — optionally set your email, name, and a new password
- License activation — the three-step activation wizard
- Application access — after activation, you're taken to the home page
You can skip both the account setup and license activation steps, but without a valid license the platform operates in a limited state.
What's Next
- Licensing Koios — detailed activation walkthrough
- System Overview — version, health, and server details
