# Activate Licenses

Activate, refresh, and revoke Oden licenses from the GUI or terminal.

Last validated: 2026-05-05

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.

> **NOTE**
> 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](https://license.voysys.se)`.
    
-   The Oden application installed on the computer where it will be used.
    
-   Administrator or `sudo` access 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.

1.  Start OdenVR, Oden Dome Player, OdenVRDev, or Oden Streamer.
    
2.  Open **Help**  **Enter license key**.
    
    If Oden already has a key but is not activated, use **Help**  **Enter new license key**.
    
3.  Paste the license key exactly as provided, including hyphens.
    
4.  Press **Ok**.
    
5.  Wait for the status text in the top bar to clear or change.
    

![activate license](_images/activate_license.png)

Figure 1. License activation menu

![license textbox](_images/license_textbox.png)

Figure 2. Enter license key

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 **Help**  **License Info**. 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:

```shell
oden-vr --activate <license-key>
```

```shell
oden-dome-player --activate <license-key>
```

```shell
oden-vr-dev --activate <license-key>
```

```shell
oden-streamer --activate <license-key>
```

On Windows, run the installed executable from PowerShell or Command Prompt:

```powershell
& "C:\Program Files\OdenVR\OdenVR.exe" --activate <license-key>
```

```powershell
& "C:\Program Files\Oden Dome Player\OdenDomePlayer.exe" --activate <license-key>
```

```powershell
& "C:\Program Files\OdenVRDev\OdenVRDev.exe" --activate <license-key>
```

```powershell
& "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`:

```shell
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:

```shell
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:

1.  Open **Help**  **Revoke current license**.
    
2.  Press **Ok**.
    
3.  Wait for the status text to report that revocation succeeded.
    

![revoke license](_images/revoke_license.png)

Figure 3. Revoke license

From the terminal:

```shell
oden-vr --revoke
```

```shell
oden-streamer --revoke
```

```powershell
& "C:\Program Files\OdenVR\OdenVR.exe" --revoke
```

```powershell
& "C:\Program Files\Oden Streamer\OdenStreamer.exe" --revoke
```

After successful revocation, activate the license on the new computer.

> **IMPORTANT**
> 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 **Help**  **License Info** 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.se](https://license.voysys.se)` is 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 **Help**  **License Info** or contact Voysys to confirm which applications the key allows.

`License has expired` or `License 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 | `C:\ProgramData\OdenVR\` | `$HOME/.config/oden/OdenVR/` |
| OdenVRDev | `C:\ProgramData\OdenVRDev\` | `$HOME/.config/oden/OdenVRDev/` |
| Oden Dome Player | `C:\ProgramData\Oden Dome Player\` | `$HOME/.config/oden/Oden_Dome_Player/` |
| Oden Streamer / Oden Fleet Streamer | `C:\ProgramData\Oden Streamer\` | `$HOME/.config/oden/Oden_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](../configure/projects-and-scenes.md).