# Activate Licenses

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

Last validated: 2026-05-25

Streamer and Player (unless activated per-session via the Portal) must be activated before use. Activation binds the license to the current computer.

You need internet access when you activate a license or revoke a license.

> **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.
    
-   `sudo` or root access if you are activating a headless Streamer service installation.
    

## Activate from the GUI

Use the GUI when you can open the application normally.

1.  Start Oden.
    
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**.

## 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-streamer --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

For Oden Fleet Streamer installations:

```shell
sudo oden-streamer --activate <license-key>
sudo systemctl restart oden-streamer.service
```

## 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
```

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).