CloudSoftwareHardware
Platform

ON THIS PAGE

  • OAK4 Advanced
  • Connect to the camera through SSH or ADB
  • Set static IP
  • Local Setup
  • 1. Power device
  • 2. Verify oakctl version
  • 3. Put device in Setup Mode
  • 4. Setup your device
  • Using setup.luxonis.com
  • Using command line

OAK4 Advanced

Connect to the camera through SSH or ADB

SSH
ADB

SSH

Connecting with ethernet

Enabling SSH

By default SSH access via password is disabled on devices running OS version 1.18 and newer. There are two ways of enabling it:

Usage

To access the device via SSH, you will need to know its IP address. You can find it by connecting the device to your network and checking the DHCP leases on your router, or using a network scanning tool like nmap or some IP scanner app. Alternately you can also run oakctl list to find OAK devices in your local network.
Command Line
1# SSH into the the device
2$ ssh root@IP_ADDRESS
To transfer a file to the device you can use scp:
Command Line
1$ scp folder/file.txt root@IP_ADDRESS:/data/
2# Or a folder
3$ scp -r folder/ root@IP_ADDRESS:/data/

Set static IP

A static IP is helpful when the camera must maintain a constant, predictable address that other systems can reliably reference. This configuration assumes you already have an active connection to the camera.You can set static IP manually in:
  • advanced settings when setting up the camera either with Luxonis Hub or locally.
  • by connecting to the camera (either ADB/SSH ) and using agentconfd configure tool:
Command Line
1agentconfd configure --help
2Usage: agentconfd configure [OPTIONS] [NETWORK_CONFIG]
3
4Arguments:
5  [NETWORK_CONFIG]  Either "dhcp" or "ipv4,ipv4_mask,ipv4_gateway"
So you can either set a static IP address or revert to DHCP:
Command Line
1# ADB/SSH into the device first, then on device set static IP:
2agentconfd configure 192.168.10.15,255.255.255.0,192.168.10.1
3# Revert back to DHCP:
4agentconfd configure dhcp

Local Setup

This section covers an advanced path for setting up an OAK device using oakctl, including cases where internet access is not available. This method can be used when you need full local control of the setup process—for example:
  • Setting up the camera without connecting to the Luxonis Hub.
  • Enabling SSH access for development or debugging.
  • Resetting the device password locally.
  • Configuring advanced network settings, such as assigning a static IP when DHCP is unavailable.
Use local setup in these scenarios or any environment where network restrictions or workflow requirements prevent using the standard cloud-based setup.

1. Power device

Connect the PoE/ETH cable to power up the device

2. Verify oakctl version

Ensure you have oakctl version 0.16.2 or higher installed by executing oakctl version. If necessary, update with oakctl self-update.

3. Put device in Setup Mode

Ensure the device is ready for setup (status light on camera blinking blue) by setting it in Setup Mode:
Command Line
1oakctl start-setup

4. Setup your device

Using setup.luxonis.com

Use this option if you want a simple, guided local setup experience. The web-based wizard automatically generates configuration values for your deployment. Go to setup.luxonis.com and select Setup Locally, then follow the on-screen instructions to configure your camera.

Using command line

This option is useful if you don't have internet access and/or want to setup your camera using command-line. The minimal command to set a password and enable ssh:
Command Line
1oakctl setup -p <INSERT_PASSWORD_HERE> --dont-check-internet
And make sure you replace <INSERT_PASSWORD_HERE> in the command with your preferred password. To see other options execute oakctl setup --help.

Need assistance?

Head over to Discussion Forum for technical support or any other questions you might have.