OverviewCloudSoftwareHardware
Platform

ON THIS PAGE

  • OAK4 Advanced
  • Connect to the camera through SSH or ADB
  • Set static IP
  • Configure DNS
  • 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
  • Frequently asked questions

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

Configure DNS

When using DHCP, you can still override the DNS server that the device uses. This is helpful in closed networks, when the DHCP server does not provide DNS, or when you need to point the device to a specific resolver.Connect to the camera first (via SSH or ADB), then run:
Command Line
1# ADB/SSH into the device first, then on device run:
2agentconfd configure dhcp --dns 10.12.102.2
If name resolution still fails, try a known public resolver (only if your network policy allows it):
Command Line
1agentconfd configure dhcp --dns 8.8.8.8
Example session:
Command Line
1~ # agentconfd configure dhcp --dns 10.12.102.2
2[2026-02-06T13:49:15Z INFO  agentconfd] Success!
3~ # ping google.com
4ping: bad address 'google.com'
5~ # agentconfd configure dhcp --dns 8.8.8.8
6[2026-02-06T13:49:30Z INFO  agentconfd] Success!
7~ # ping google.com
8PING google.com (142.250.203.142): 56 data bytes
964 bytes from 142.250.203.142: seq=0 ttl=251 time=11.978 ms
1064 bytes from 142.250.203.142: seq=1 ttl=251 time=14.046 ms
If ping by hostname fails but ping by IP succeeds, DNS is misconfigured. Adjust the DNS server or verify that outbound DNS is allowed on your network.

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.

Frequently asked questions

Can USB and PoE be used simultaneously?Yes, if your goal is to:
  • provide power over USB and use a non-PoE cable for communication.
  • provide power over PoE and use USB for ADB communication

Need assistance?

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