Skip to content
Odeion

Device Linking

Device linking allows you to sign in to an Odeion app on a new device without typing your server URL and password. Instead, you generate a short code on a device where you are already logged in and enter it on the new device.

How It Works

Section titled “How It Works”

  1. On a device where you’re already signed in, generate a link code from Settings. The web and mobile apps both expose it in the same place. A 5-character alphanumeric code is displayed (for example, ABC12).

  2. Open the Odeion app on the device you want to sign in to (phone, TV, Roku, etc.) and select the device code login option. Enter the 5-character code.

  3. The new device resolves the code through the link service, connects to your server, and completes the login automatically.

How It Works Internally

Section titled “How It Works Internally”

The device code flow uses a public relay service at link.odeion.app to bridge the gap between the new device (which doesn’t know your server URL yet) and your server.

When you generate a code on your logged-in device, your server creates a login token and registers it along with your server’s URL with the link service. The link service stores this mapping temporarily and returns the 5-character code.

When you enter the code on the new device, the app resolves it through the link service to discover the server URL and login token. If the code points to a different Odeion instance, the app is redirected to the correct server to complete the login.

Codes expire after 10 minutes and are single-use. The link service stores nothing permanently; it holds codes in memory and cleans up expired entries automatically.

Requirements

Section titled “Requirements”

Device linking requires your Odeion server to be accessible over HTTPS at its configured base URL. The link service needs to be able to include your server’s URL in the code mapping, and the device completing the login needs to reach your server to finalize authentication.

If your server is only accessible on a local network (no public HTTPS), device linking will not work. In that case, use the server URL + username/password login option instead.