# 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 through PoE+: The same process as in the video is described below in more detail. ## Power the camera OAK4 cameras consume up to 25W of power (peaks) and require PoE+ (802.3at, 30W) injector/switch for power (eg. [TL-SG1008P](https://www.tp-link.com/en/business-networking/unmanaged-switch/tl-sg1008p/)). After being powered and booted, status light should turn solid blue, indicating that the device is ready. > **PoE+ & Internet** > **Normal PoE (802.3af, 15W)** > injector/switch > **won't** > be able to > **provide enough power** > . We recommend having the switch > **connected to the internet** > to get the best experience. ## 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 > Debian packages are available for Ubuntu 24.04 / 22.04, supporting x86_64 (AMD64) architecture. OAK Viewer 1.6.3 for [Ubuntu 24.04 / 22.04 (x86)](https://oak-viewer-releases.luxonis.com/data/1.6.3/debian_x86_64/viewer.deb) #### macOS > Viewer is available for macOS 12 and later, supporting both ARM (Apple Silicon) and x86_64 (Intel) architectures. OAK Viewer 1.6.3 for [macOS 12+ (ARM)](https://oak-viewer-releases.luxonis.com/data/1.6.3/macos_arm_64/Viewer.zip) | [macOS 12+ (x86)](https://oak-viewer-releases.luxonis.com/data/1.6.3/macos_x86_64/Viewer.zip) #### Windows > 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 1.6.3 for [Windows 10/11 (x86)](https://oak-viewer-releases.luxonis.com/data/1.6.3/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: #### 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. #### 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. #### Insert new password Insert password and advanced settings if necessary. #### 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. ## 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)](#OAK4%2520Getting%2520Started-Troubleshooting-Red%2520light%2520(insufficient%2520power)) * [Blue light does not behave as expected](#OAK4%2520Getting%2520Started-Troubleshooting-Blue%2520light%2520does%2520not%2520behave%2520as%2520expected) * [Device visible in oakctl but not OAK Viewer](#OAK4%2520Getting%2520Started-Troubleshooting-Device%2520visible%2520in%2520oakctl%2520but%2520not%2520OAK%2520Viewer) * [No DHCP](#OAK4%2520Getting%2520Started-Troubleshooting-No%2520DHCP) * [Orange light (device issue)](#OAK4%2520Getting%2520Started-Troubleshooting-Orange%2520light%2520(device%2520issue)) * [Reset Button malfunction](#OAK4%2520Getting%2520Started-Troubleshooting-Reset%2520Button%2520malfunction) ### 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.msi). * 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. ### 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.