Installation & Setup Guide

Step-by-step instructions from Raspberry Pi installation to initial setup

Table of Contents

1

Prepare Required Items

Before starting installation, please prepare the following items.

Hardware

  • Raspberry Pi 5 (4GB RAM or higher)
  • microSD Card 32GB or higher (Class 10 or higher recommended)
  • Power Adapter 5V/5A USB-C (for Raspberry Pi 5)
  • Network Connection (Wired LAN)
Tip

AIBOX OS also runs on the Raspberry Pi 4; however, its performance is lower compared to the Raspberry Pi 5.As a result, processing loads may increase, and AI detection tasks may fail to operate properly.

Camera (at least one)

  • USB Webcam (UVC compatible)
  • IP Camera (RTSP/ONVIF compatible)

PC and Software

  • Windows, Mac, or Linux PC
  • SD Card Reader (if not built into PC)
  • Raspberry Pi Imager (OS image writing tool, or alternative software)
Important Notes

Please choose a high-speed microSD card. Class 10 or higher, and A1/A2 specification if possible, is recommended. Using a slow card may result in degraded performance.

2

Download OS Image

Download the AIBOX OS image file.

Download Procedure

  1. Access the download page
  2. Download the latest OS image (ZIP file)
  3. After download completes, verify SHA256 hash value (recommended)
  4. Extract the ZIP file to obtain the .img file
Go to Download Page

Verify Hash Value (Recommended)

It is recommended to check the SHA256 hash value to confirm the downloaded file is not corrupted.

Windows PowerShell
Get-FileHash aicapture_20251009.img.zip -Algorithm SHA256
Mac/Linux
sha256sum aicapture_20251009.img.zip
Tip

Please confirm that the displayed hash value matches the value listed on the download page.

3

Write to microSD Card

Write the downloaded OS image to the microSD card.

  1. Download and install Raspberry Pi Imager
    https://www.raspberrypi.com/software/
  2. Connect the microSD card to your PC
  3. Launch Raspberry Pi Imager
  4. Select "Choose OS" → "Use custom"
  5. Select the downloaded .img file
  6. Select your microSD card in "Choose Storage"
  7. Click "Write"
  8. When asked "Would you like to apply OS customization settings?" → Click "No"
Important

All data on the microSD card will be erased during the writing process. Please backup any necessary data beforehand.

Complete

After writing completes, safely eject the card. The writing process takes approximately 5-15 minutes.

4

Boot Raspberry Pi

Insert the written microSD card into the Raspberry Pi and boot it.

Connection Procedure

  1. Confirm the Raspberry Pi power is OFF
  2. Insert the microSD card into the Raspberry Pi
  3. Connect the wired LAN cable
  4. Finally, connect the power cable
About Booting

When booted successfully, the LED will change from red to steady green. If it remains red, please check that the microSD card is properly inserted.

5

Install Mobile App (Android/iOS)

Install the dedicated "AI CAPTURE" app to control AIBOX from your smartphone.

Compatible Environments

  • Android: API Level 30 or higher (Android 11 or later)
  • iOS: iOS 18.0 or higher

Installation Method

  1. Open the app store for your smartphone using the links below
  2. Search for "AI CAPTURE" or access the download page directly
  3. Tap "Install" or "Get"
  4. After installation completes, the icon will be added to your home screen
App Sign-in

After app installation completes, launch the app and sign in with your Google Account / Apple ID

6

Initial Setup

When you launch the mobile app and sign in, the cloud initial setup screen will be displayed.

Tap "Run Cloud Initial Setup" to perform the cloud initial setup.

Important

Do not close the app until the initial setup is complete. Keep it open. (Takes approximately 1 minute)

7

Register AIBOX to Camera View

When initial setup completes, one camera view with a 7-day trial license will be added. (First time only)

Register your AIBOX to this added camera view.

What is a Camera View?

A Camera View is a display frame that shows the video from a registered camera.
One AIBOX is required for each camera view. (If you have 2 camera views, you need 2 AIBOXes)

Camera connection information is saved as camera view settings, and the registered AIBOX reads those settings to connect to the camera and stream/record video.

When you connect AIBOX and your smartphone to the same network (LAN), the AIBOX will be displayed. Select it and tap "Register".

About Registration

After registration completes, your smartphone and AIBOX do not need to be on the same network. They only need to be on the same network during the registration process.

8

Connect Camera

Configure camera connection information for your registered camera view. The setup method differs depending on the camera type.

Select the camera type you want to connect from "Connection Method" and follow the procedures below.

8-1 USB Camera Connection

Setup procedure when using a USB webcam.

Connection Procedure

  1. Connect the USB camera to the AIBOX USB port
  2. Open the camera view settings screen in the mobile app
  3. Select "USB Camera" for "Camera Type"
  4. Connected cameras will be automatically detected and displayed in the list
  5. Select the camera you want to use
  6. Tap "Register" to complete setup

8-2 IP Camera Connection (ONVIF)

Setup procedure for auto-detecting and connecting IP cameras that support the ONVIF protocol.

Connection Procedure

  1. Place AIBOX on the same network as the IP camera
  2. Open the camera view settings screen in the mobile app
  3. Select "ONVIF" for "Camera Type"
  4. ONVIF-compatible cameras on the network will be automatically detected
  5. Select the camera you want to use from the list
  6. Enter username and password, then tap "Load Profile"
  7. Select the profile you want to use
  8. Tap "Register" to complete setup
About ONVIF

ONVIF is a standard specification for IP cameras. ONVIF-compatible cameras can be automatically detected and connected regardless of manufacturer or model. Please confirm that ONVIF is enabled in your camera settings.

PTZ (Pan/Tilt/Zoom) Support

If the IP camera complies with ONVIF PTZ specifications, PTZ control buttons will be displayed on the live view screen.

For H.265 Cameras

If the camera video compression is H.265, the image may be distorted. Please change the camera settings to H.264, or turn ON "Enable H.264 Transcode" in the app settings screen.

However, enabling H.264 transcode increases AIBOX processing load, so please select a profile with lower resolution and frame rate from the camera stream when possible.

8-3 IP Camera Connection (RTSP)

Setup procedure when connecting an IP camera via RTSP protocol.

Connection Procedure

  1. Place AIBOX on the same network as the IP camera
  2. Check the camera's IP address, username, and password
  3. Open the camera view settings screen in the mobile app
  4. Select "RTSP" for "Camera Type"
  5. Enter the RTSP URL in "Connect Path"
  6. Tap "Register" to complete setup
RTSP URL Example
rtsp://admin:123456@192.168.1.100:554/stream1
About RTSP URL

The RTSP URL format is as follows:

  • RTSP URL: rtsp://[username]:[password]@[IP address]:[port]/[path]

RTSP URL ports and paths vary by camera manufacturer and model. Please check your camera's manual or manufacturer's website.

For H.265 Cameras

If the camera video compression is H.265, the image may be distorted. Please change the camera settings to H.264, or turn ON "Enable H.264 Transcode" in the app settings screen.

However, enabling H.264 transcode increases AIBOX processing load, so please select a profile with lower resolution and frame rate from the camera stream when possible.

Setup Complete

When camera connection setup completes, live video will be displayed in the camera view. AI CAPTURE setup is now complete!

9

Check for AIBOX OS Updates

Finally, check whether there are any updates for AIBOX OS.

Open the settings screen and verify the version information under Registered AIBOX Information.

If an update is available, it will be displayed in red. Press the "Update" button to perform the AIBOX OS update.

Important

During the update process, AIBOX may restart several times. Please do not turn off the power until the update is complete.