# OAK4 Getting Started Use this guide to power your OAK4 camera, open it in OAK Viewer, optionally connect it to Luxonis Hub, and recover from the most common setup issues. ## Before you begin To get started quickly, we've made a video on how to get started with camera connected: The same process as in the video is described below in more detail. ## Power the camera OAK4 cameras can be powered in two ways: #### PoE+ Use PoE+ (802.3at 30W) with an injector or switch, for example [TL-SG1008P](https://www.tp-link.com/en/business-networking/unmanaged-switch/tl-sg1008p/). Normal PoE (802.3af, 15W) injectors and switches won't provide enough power. For the best experience, keep the switch connected to the internet. #### USB-C For a USB-C only connection, we recommend a 30W power supply. Use a high-quality USB-C cable and connect directly to a USB 3.0 port for best throughput. 15W is still supported with throttled performance, which is still sufficient for most use cases. If you are using USB for both power and communication, connect the camera to a USB-C port on the host. USB-A cannot provide enough power in this setup. If your host computer's USB port cannot provide enough power, you can still use USB-C for communication while powering the camera over PoE+. In this case USB-A can also be used on host side as it handles only communication, but still make sure that it is USB port 3.0 For the best experience we recommend connecting the camera to the internet. You can do that by sharing host PC internet connection by: 1. Install [oakclt](https://docs.luxonis.com/software-v3/oak-apps/oakctl.md) to your host PC. 2. Share host PC internet connection to camera with ```bash oakctl usbd enable ``` After being powered and booted, status light should turn solid blue, indicating that the device is ready. ## Install and open 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 available for Windows, macOS, and Linux. Download and install OAK Viewer: #### Linux > **Note** > Debian packages are available for Ubuntu 24.04 / 22.04, supporting x86_64 (AMD64) architecture. OAK Viewer 3.2.1 for [Ubuntu 24.04 / 22.04 (x86)](https://oak-viewer-releases.luxonis.com/data/3.2.1/debian_x86_64/viewer.deb) #### macOS > **Note** > Viewer is available for macOS 12 and later, supporting both ARM (Apple Silicon) and x86_64 (Intel) architectures. OAK Viewer 3.2.1 for [macOS 12+ (ARM)](https://oak-viewer-releases.luxonis.com/data/3.2.1/macos_arm_64/Viewer.zip) | [macOS 12+ (x86)](https://oak-viewer-releases.luxonis.com/data/3.2.1/macos_x86_64/Viewer.zip) #### Windows > **Note** > Please note that you can get warning from Microsoft Defender. Viewer is available for Windows 10/11, supporting the x86_64 (AMD64) architecture. OAK Viewer 3.2.1 for [Windows 10/11 (x86)](https://oak-viewer-releases.luxonis.com/data/3.2.1/windows_x86_64/Viewer.msi) More details can be found on the [OAK Viewer Documentation page](https://docs.luxonis.com/software-v3/depthai/tools/oak-viewer.md). ## Optional: Connect to Luxonis 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: 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. 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. Insert password and advanced settings if necessary. 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. ## Factory reset > **Factory reset warning** > This will reset the device to factory settings, removing all configurations and data. Make sure to back up any important data before proceeding. If you need to factory reset your OAK4 device, you can do so by pressing the hardware reset button while the device is powered on: 1. Press and hold the reset button for 10 seconds. 2. The front LED blinks orange after ~5 seconds. 3. Keep holding; at ~10 seconds the LED blinks red and then turns off, indicating that the factory reset has started. 4. Release the button once the LED turns off and wait for the device to reboot (this may take a few seconds). ## Troubleshooting Jump to symptom: * [Red light (insufficient power)](#Red%20light%20(insufficient%20power)) * [Blue light does not behave as expected](#Blue%20light%20does%20not%20behave%20as%20expected) * [Device visible in oakctl but not OAK Viewer](#Device%20visible%20in%20oakctl%20but%20not%20OAK%20Viewer) * [No DHCP](#No%20DHCP) * [Yellow light (throttled performance)](#Yellow%20light%20(throttled%20performance)) * [Orange light (device issue)](#Orange%20light%20(device%20issue)) * [Reset Button malfunction](#Reset%20Button%20malfunction) ### Red light (insufficient power) Before booting, the OAK4 camera checks for a PoE+ (30W) signal. If not detected, the red light flashes, but the device will still attempt to boot if enough power is available. OAK4 negotiates per IEEE 802.3at for Type 2 (30W PoE+). If negotiation fails or a passive PSE is used, it defaults to Class 0 (15W) and may be underpowered, triggering the red LED as a warning. Some PoE injectors, like [Ubiquiti's PoE+ injector](https://store.ui.com/us/en/category/accessories-poe-power/collections/pro-store-poe-and-power-adapters/products/u-poe-plus?variant=u-poeplus), provide enough power but don't signal compliance. In such cases, OAK4 flashes red before booting and turning blue when operational. ### Blue light does not behave as expected It is possible that your device has an older OS version that behaves differently - blinks out of the box or does not light up at all. In that case it is recommended to update the OS to the latest version. Update the OS using `oakctl`: * Download and install oakctl #### Linux/MacOS On 64bit system, run: ```bash bash -c "$(curl -fsSL https://oakctl-releases.luxonis.com/oakctl-installer.sh)" ``` #### Windows Download and install using the [Windows Installer](https://oakctl-releases.luxonis.com/data/latest/windows_x86_64/oakctl-installer.exe). * Run the following command to update the OS on your OAK4 device: ```bash oakctl device update ``` Follow the prompts to select the device and input the device password. The tool will automatically download the latest OS version and flash it to the device. After the update is complete, the device will reboot. If the updating with oakctl failed, you might need to do a [Full Luxonis OS Flash](https://docs.luxonis.com/software-v3/sw-stack/luxonis-os.md). ### No DHCP By default, OAK4 will try to get a dynamic IP address from DHCP server. If no DHCP server is available on the network (for example, when connecting an OAK-4 directly to your computer through a PoE injector), the camera will fall back to a [link-local](https://en.wikipedia.org/wiki/Link-local_address) address. To communicate with the device in this setup, configure your computer with a static IP in the `169.254.0.0/16` subnet—for example: * Address: `169.254.10.112` * Netmask: `255.255.0.0` Once configured, run `oakctl list` in the command line on your host computer, and you should see the camera detected. ### Device visible in oakctl but not OAK Viewer If the camera appears in `oakctl list` but OAK Viewer shows no reachable device, discovery methods may differ on your network. Quick checks: 1. Update tools and device software: * `oakctl self-update` * `oakctl device update` 2. Verify host and camera are on the same subnet. 3. Allow `11491/udp` (discovery) and `11490/tcp` (XLink) through the host firewall. 4. Disable VPN temporarily. 5. If your host uses multiple interfaces (Wi-Fi + Ethernet), ensure routing to the camera subnet uses the correct interface. See [OAK Viewer](https://docs.luxonis.com/software-v3/depthai/tools/oak-viewer.md) documentation for full troubleshooting details. ### Yellow light (throttled performance) If you see orange light on boot, the camera has detected a power supply between 15 and 20W and will boot into throttled performance mode. This will also cause it to boot slower, so wait a bit longer until the blue light shines. ### Orange light (device issue) If light glows orange, please contact support@luxonis.com due to potential device issue. ### Reset Button malfunction If pressing Reset Button between 5-10 seconds does not enter Setup (Blue light blinking) or Factory Reset (Blue light solid) the button might be malfunctioning. You can still switch to Setup mode with `oakctl adb shell agentconfd start-setup` or do Factory Reset with `oakctl adb shell agentconfd factory-reset`. To learn how to use adb, see Advanced section. ## Next steps ### Explore software options Continue with the software stack, examples, and APIs for OAK4 development. [Explore software options](https://docs.luxonis.com/software-v3.md) ### Open the advanced guide Connect through SSH or ADB, set a static IP, or follow the local setup path. [Open the advanced guide](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md) Head on over to [Advanced](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md) to see how to: * [Connect via SSH/ADB](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md) * [Set static IP](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md) * [Local Setup](https://docs.luxonis.com/hardware/platform/deploy/oak4-deployment-guide/oak4-advanced.md) ### Need assistance? Head over to [Discussion Forum](https://discuss.luxonis.com/) for technical support or any other questions you might have.