Activate Licenses
OdenVR, Oden Dome Player, OdenVRDev, Oden Streamer, and Oden Fleet Streamer must be activated with a license key before production use. Activation binds the license to the current computer.
You need internet access when you activate a license, refresh a license, or revoke a license. After activation, Oden can run without internet access until the current activation period expires. The exact period depends on the license, but is typically several weeks. Oden warns when a license is close to expiring and automatically tries to refresh an existing license key when the computer is online.
| Activation contacts the Voysys license server and sends information that identifies the computer. This is required so the license can be tied to the machine. |
Before you start
Make sure you have:
-
The license key from Voysys.
-
Internet access to
https://license.voysys.se. -
The Oden application installed on the computer where it will be used.
-
Administrator or
sudoaccess if you are activating a headless Streamer service installation.
If the computer is normally offline, connect it to the internet for activation. After activation succeeds, it can be moved back to the offline network until the activation needs to be refreshed.
Activate from the GUI
Use the GUI when you can open the application normally.
-
Start OdenVR, Oden Dome Player, OdenVRDev, or Oden Streamer.
-
Open .
If Oden already has a key but is not activated, use .
-
Paste the license key exactly as provided, including hyphens.
-
Press Ok.
-
Wait for the status text in the top bar to clear or change.
If activation succeeds, Oden stores the key and the activated license data for that application. Restart Oden after the first activation so all licensed features are loaded with the new license state.
To check the current license later, open . The dialog shows whether the license is valid, the saved license key, which applications the license allows, and the activation dates.
Activate from the terminal
Use terminal activation for headless systems, remote machines, scripted setup, or systems where the GUI is unavailable.
On Linux, use the installed command name:
oden-vr --activate <license-key>
oden-dome-player --activate <license-key>
oden-vr-dev --activate <license-key>
oden-streamer --activate <license-key>
On Windows, run the installed executable from PowerShell or Command Prompt:
& "C:\Program Files\OdenVR\OdenVR.exe" --activate <license-key>
& "C:\Program Files\Oden Dome Player\OdenDomePlayer.exe" --activate <license-key>
& "C:\Program Files\OdenVRDev\OdenVRDev.exe" --activate <license-key>
& "C:\Program Files\Oden Streamer\OdenStreamer.exe" --activate <license-key>
The command prints Activated successfully when activation is complete.
If the application already has a saved key, Oden refuses to overwrite it unless you explicitly add --force:
oden-streamer --activate <license-key> --force
Prefer revoking the old key before replacing it.
Use --force only when you are intentionally replacing the saved key on the same computer.
Headless Streamer and services
Oden Streamer can be activated before starting it as a service. For Oden Fleet Streamer installations, activate the same installed command that the service uses:
sudo oden-streamer --activate <license-key>
sudo systemctl restart oden-streamer.service
For Oden Serve Streamer installations, the service command is oden-serve-streamer.
Serve products do not use the standard Oden license activation flow.
Move a license to another computer
A license can only be activated on one computer at a time. Before using the same license key on another computer, revoke it on the current computer while that computer still has internet access.
From the GUI:
-
Open .
-
Press Ok.
-
Wait for the status text to report that revocation succeeded.
From the terminal:
oden-vr --revoke
oden-streamer --revoke
& "C:\Program Files\OdenVR\OdenVR.exe" --revoke
& "C:\Program Files\Oden Streamer\OdenStreamer.exe" --revoke
After successful revocation, activate the license on the new computer.
| Do not uninstall or wipe the old computer before revoking the license if you plan to reuse the same key. If the old computer is no longer available, contact Voysys support. |
Offline operation
Oden does not require a continuous internet connection after a successful activation. It does require internet access again before the activated period expires.
For offline deployments:
-
Activate the license while the machine is online.
-
Open and check Activated To.
-
Plan a maintenance window before that date to reconnect the machine and let Oden refresh the activation.
-
Revoke the license before decommissioning or replacing the computer.
Oden shows a warning when the license is close to expiry. If a saved key exists and the license is near expiry, Oden attempts to refresh it automatically when the license server is reachable.
Troubleshooting
Unable to connect to license server-
Check internet access, DNS, firewall, proxy, and whether
https://license.voysys.seis reachable from the computer. License key was not recognized by the server-
Check that the key was pasted correctly, including hyphens.
License key has already been activated on another computer-
Revoke the license on the other computer first, then activate it again on this computer.
License not valid for this application-
The license does not include the product you are trying to run. Check or contact Voysys to confirm which applications the key allows.
License has expiredorLicense key has expired on the server-
The license period has ended or the local activation was not refreshed in time. Reconnect the computer to the internet and run activation again. If the message remains, contact Voysys.
License is revoked-
The local license data has been marked as revoked. Activate with a current license key.
Where Oden stores license data
Oden stores the saved key and activated license data per application.
The files are named key.conf and license2.lic.
Common application config roots are %LOCALAPPDATA%\oden on Windows and $HOME/.config/oden on Linux.
Typical per-application roots include:
| Application | Windows | Linux |
|---|---|---|
OdenVR |
|
|
OdenVRDev |
|
|
Oden Dome Player |
|
|
Oden Streamer / Oden Fleet Streamer |
|
|
For root-run Linux services, activate with sudo so key.conf and license2.lic are stored where the service process can read them.
For project and application config context, see Projects and Scenes.