Connect OAK4 to Luxonis Hub
1
Install OAK Viewer
OAK Viewer is a desktop GUI application that allows you to visualize the camera's streams and interact with the device. It is the main way to connect your OAK4 camera to Luxonis Hub.
Download now:OAK Viewer 1.6.3 for Ubuntu 24.04 / 22.04 (x86)More details can be found on the OAK Viewer Documentation page.
Download now:Linux
macOS
Windows
Linux
Debian packages are available for Ubuntu 24.04 / 22.04, supporting x86_64 (AMD64) architecture.
2
Connect to Hub
If you want to connect the camera to Luxonis Hub and explore the ecosystem click on the "Adopt to Hub" button in the OAK Viewer, confirm factory reset and select new password. Once setup is complete, a
Hub tag will be shown on your device in OAK Viewer.Step by step instructions:1. Click Adopt To Hub
If you want to connect the camera to Luxonis Hub and explore the ecosystem click on the "Adopt to Hub" button in the OAK Viewer.
2. Acknowledge data deletion
You will get a warning about the on-device data deletion if you continue with the Hub setup. This will delete all user data - including 
/data/ and the user overlay. After this step you will be redirected to a web browser.3. Insert new password
Insert password and advanced settings if necessary.
4. Confirm successful finish
Navigating back to the OAK Viewer you should now see a 
Hub tag next to your device indicating that the camera is successfully connected to the Luxonis Hub.Connecting to Hub enables SSH
Devices running OS 1.18 or newer ship with password-based SSH disabled; completing Luxonis Hub setup turns SSH back on and applies the password you configure in that flow.
3
(Optional) Advanced Options
While setting the new password, you can also configure advanced options. Details are below:Use DHCP
Enables your device to automatically obtain an IP address, subnet mask and gateway settings from a DHCP server in the network.Enable SSH
Allows remote access to your device via the Secure Shell (SSH) protocol. Use this feature to securely configure or monitor the device over an encrypted connection.Require Internet Access
Device setup will not complete unless internet access can be established by the device.Enable Error Reporting
Enable detailed error reporting to enhance troubleshooting and system diagnostics. By selecting this option, you allow the collection of the following data: Pipeline Schema, Device Platform, OS Platform, Connection Type and Crash Dump. This information is crucial for identifying and resolving issues more efficiently.DepthAI Peripheral Mode
Enabling this option, exposes DepthAI server, giving access to the device from other hosts, using DepthAI library. This makes the device act similar to the RVC2 (OAK) device.Hostname
The unique name assigned to your device within the network. Use a descriptive and recognizable hostname for easier identification, especially in environments with multiple devices.
Enables your device to automatically obtain an IP address, subnet mask and gateway settings from a DHCP server in the network.Enable SSH
Allows remote access to your device via the Secure Shell (SSH) protocol. Use this feature to securely configure or monitor the device over an encrypted connection.
For login, use the default username 'oak' and the camera password you defined during setup.
Device setup will not complete unless internet access can be established by the device.Enable Error Reporting
Enable detailed error reporting to enhance troubleshooting and system diagnostics. By selecting this option, you allow the collection of the following data: Pipeline Schema, Device Platform, OS Platform, Connection Type and Crash Dump. This information is crucial for identifying and resolving issues more efficiently.DepthAI Peripheral Mode
Enabling this option, exposes DepthAI server, giving access to the device from other hosts, using DepthAI library. This makes the device act similar to the RVC2 (OAK) device.Hostname
The unique name assigned to your device within the network. Use a descriptive and recognizable hostname for easier identification, especially in environments with multiple devices.
Connect Other OAKs To Luxonis Hub
1
Prerequisites
- a Luxonis Hub account
- a Linux computer with supported operating system
- direct terminal access or SSH access
2
Install Agent
Copy and run the command for Custom Linux Install on the target computer.
Devices >
After a successful installation, a window will appear displaying a message indicating that the installation was completed.
Devices >
Connect Device > Custom Linux Install > Copy command from the dialogAfter a successful installation, a window will appear displaying a message indicating that the installation was completed.If you are experiencing issues with the installation process check the troubleshooting guide.
Command Line
1╭──────────────────────────────────────────────────────────╮
2│ │
3│ Luxonis Hub Agent Installer │
4│ Linux / aarch64 │
5│ │
6│ Installation complete! │
7│ Use `hubctl help` to manage the agent. │
8│ │
9╰──────────────────────────────────────────────────────────╯3
Adopt Agent to the Hub
4
Connect the OAK
Plug your OAK into the USB port of your computer or connect it to your network via an Ethernet cable with PoE. The OAK will automatically appear in the OAKs tab under your device.
Connecting Large Fleets
If you're managing a larger fleet of OAK devices, reach out to support@luxonis.com to discuss options for simplifying the connection process.
Luxonis Hub also supports pre-adopted devices, allowing streamlined onboarding and provisioning for bulk deployments.
Luxonis Hub also supports pre-adopted devices, allowing streamlined onboarding and provisioning for bulk deployments.