Skip to main content

kodbox

Kodbox is a private cloud solution designed for enterprises, offering an out-of-the-box setup with no additional configuration needed for rapid deployment. It includes a comprehensive suite of clients and apps and provides Wi-Fi AP functionality, enabling users to access and manage Kodbox devices conveniently from anywhere.

kodbox1

Supported Devices​

Firmware​

Bianbu OS Version: v1.0.11

Firmware Location: https://archive.spacemit.com/image/k1/version/bianbu/

  • bianbu-*-kodbox-*.img.zip is for SD card firmware. After extracting the file, you can use the dd command or balenaEtcher to write it to the SD card.
  • bianbu-*-kodbox-*.zip is for Titan Flasher. For flashing instructions, refer to the Bianbu Flasher User Guide, or extract the file and use the fastboot command for flashing.

System Login​

Kodbox firmware supports the following login methods:

  1. Serial Login: After logging in via the serial port, use the ifconfig command to find the IP address (HOST_IP).
  2. SSH Login: SSH service starts automatically after flashing. Log in using the command ssh root@HOST_IP.

The password for the root user is: bianbu.

Clients​

Kodbox supports the following clients/apps:

  • Web: Accessible via a web browser.
  • PC: Available for Windows and Mac.
  • Mobile: Available for Android and iOS.
  • Third-Party Tools: WebDAV.

Client links can be found at Kodbox Clients/Apps.

Web Login​

The IP address HOST_IP obtained from the Kodbox device is the server site. After retrieving the IP address via the serial port, open a web browser on a PC (ensure it is on the same local network as the Kodbox device) and access the Kodbox service via http://HOST_IP. Initial login will require configuration.

  1. Environment Check

    kodbox_web1

  2. Configure Database and Cache

    kodbox_web2

​ At this step, click "Confirm" to use SQLite as the database and file-based caching by default. You can switch to other databases and caching solutions later if needed.

  1. Set Administrator Password

    kodbox_web3

​ The default administrator account is admin, and the password is set by the user during this step. Once this is done, the initialization process is complete. You can now log in again to access the Kodbox web management interface.

Discovering Kodbox​

Kodbox offers an automatic discovery service, allowing users to easily find the Kodbox site.

Requirements​

  1. Ensure the Kodbox device is powered on and connected to the network.
  2. Download the latest version of the PC or mobile app (note: the iOS app does not yet support the automatic discovery feature).
  3. Make sure the Kodbox device and the client are on the same local network.

Discovery Steps​

PC Discovery​

  1. On the PC app, right-click the icon to find Switch/Discover Sites, or open the PC app and click Discover Sites on the home page.

kodbox_pc_login

  1. After the PC app scans the local network and detects the device, it will display relevant information. If the device has not been initialized, you can click Configure Device to access the system initialization interface.
  2. After initialization, you can log in directly. Future scans will allow you to connect and log in to the device directly.

Mobile Discovery​

  1. Open the mobile app and tap Discover Sites (or access it after switching sites).

    kodbox_android3

  2. After tapping, the app will automatically scan for Kodbox devices on the local network.

    kodbox_android4

Wi-Fi AP​

The Kodbox firmware integrates Wi-Fi AP functionality, which starts automatically after flashing. This allows other devices to connect to the Kodbox device via Wi-Fi and automatically receive an IP address through DHCP.

  • Default Wi-Fi AP SSID: BianbuAP (Password: 12345678)
  • Default Wi-Fi AP IP: 10.0.0.1

Access the Kodbox service via http://10.0.0.1 after connecting the Wi-Fi.