BoxGPT Quick Start Guide
Welcome to BoxGPT — your local, privacy-first AI assistant that runs entirely offline or within your local network.
This guide walks you through setup, configuration, and first use.
Power Setup
- Connect Power
Plug the included power cord into the power socket on the back of the BoxGPT machine.
Connect the other end to a wall outlet or power strip. - Toggle Power Switch
On the back panel, switch the power toggle to the ON position. - Attach Wi-Fi Antennas (if using Wi-Fi)
Screw in both antennas on the rear panel. - Turn On the System
Press the Start button on the front of the BoxGPT machine.
The front LED will light up, and the system will automatically begin booting.
Configuration Overview
Inside the package, you'll find a USB drive — this is your setup/config/recovery drive.
- Insert the USB drive into any laptop or computer.
- Open the file
boxgpt.confin a text editor such as Notepad (Windows) or TextEdit (macOS).
You'll see something similar to the following:
# Network Configuration File
# You can add comments using #
[DEFAULT]
# mode can be set to:
# offline - connect monitor, keyboard, mouse directly to BoxGPT machine. Use BoxGPT machine as a standalone PC.
# localnetwork - connect BoxGPT machine to local network using Wi-Fi (enter network name/password below). Or connect to router using Ethernet.
# hotspot - BoxGPT will host its own Wi-Fi network (enter network name/password below). Connect your devices to this network.
# direct - use Ethernet cable to connect BoxGPT to your device directly.
mode=offline
# Wi-Fi network name.
# For localnetwork mode, use existing network name.
# For hotspot mode, create a unique Wi-Fi network name (default: boxgpt).
wifi_ssid=
# Wi-Fi network password.
# For localnetwork mode, enter correct password.
# For hotspot mode, create a unique password (default: k7m2n9p4). MUST HAVE at least 8 characters, at least one number
wifi_password=
# Set to true if network is hidden
wifi_hidden=false
# Enable/disable remote connection using ssh
ssh_enabled=trueBoxGPT supports four main connection options:
| Mode | Description | Recommended For |
|---|---|---|
| offline | Standalone mode connect monitor, keyboard, and mouse directly. | Full desktop experience without network. |
| localnetwork (Wi-Fi) | Connect BoxGPT to your existing Wi-Fi router. | Homes or offices with wireless networks. |
| localnetwork (Ethernet) | Connect BoxGPT to your router via Ethernet cable | Offices, labs, or stable wired setups. |
| hotspot | BoxGPT creates its own Wi-Fi network. | Portable or isolated environments. |
| direct | Connect BoxGPT directly to your computer via Ethernet. | Fastest single-device connection. |
Offline Mode (Standalone PC)
- In
boxgpt.conf, set:
(You may leave Wi-Fi fields blank.)mode=offline - Save and close the file.
- Remove the USB drive from your computer and plug it into the front USB port on the BoxGPT machine.
- Wait about 60 seconds for the system to automatically apply your configuration.
- Connect a monitor, keyboard, and mouse directly to the BoxGPT.
- Once the system boots, open a browser and go to:
http://boxgpt.local:8080 - Login: Create a new user account (non-admin). Or use the default admin account:
- Email:
admin@admin.com - Password:
admin
- Email:
Local Network Mode (Wi-Fi)
- In
boxgpt.conf, set:mode=localnetwork wifi_ssid=YourNetworkName wifi_password=YourPassword wifi_hidden=false - Save and close the file.
- Plug the USB drive into the front USB port of BoxGPT.
- Wait 60 seconds for configuration to apply.
- Ensure your BoxGPT is within range of your Wi-Fi router.
- On any computer or device connected to the same Wi-Fi network, open a web browser and visit:
http://boxgpt.local:8080 - Login:
Create a new user account (non-admin). Or use the default admin account:- Email:
admin@admin.com - Password:
admin
- Email:
Local Network Mode (Ethernet)
- In
boxgpt.conf, set:
(Wi-Fi fields can remain blank.)mode=localnetwork - Save and close the file.
- Plug the USB drive into BoxGPT and wait 60 seconds.
- Connect an Ethernet cable from BoxGPT to your router or switch.
- On any computer connected to the same network, open:
http://boxgpt.local:8080 - Login:
Create a new user account (non-admin). Or use the default admin account:- Email:
admin@admin.com - Password:
admin
- Email:
Hotspot Mode (BoxGPT's Own Wi-Fi)
- In
boxgpt.conf, set:
(You can change these values, but ensure the password has at least 8 characters and one number.)mode=hotspot wifi_ssid=BoxGPT wifi_password=k7m2n9p4 - Save and close the file.
- Insert the USB drive into BoxGPT and wait 60 seconds.
- On your laptop or phone, open Wi-Fi settings and connect to the BoxGPT network (e.g., BoxGPT) using your password.
- Once connected, open your browser and visit:
http://boxgpt.local:8080 - Login:
Create a new user account (non-admin). Or use the default admin account:- Email:
admin@admin.com - Password:
admin
- Email:
Direct Connection Mode (Ethernet to a Single Device)
- In
boxgpt.conf, set:mode=direct - Save and close the file.
- Plug the USB drive into the BoxGPT front port and wait 60 seconds.
- Connect an Ethernet cable directly between BoxGPT and your laptop or PC.
- After about a minute, the connection will be automatically established.
- In your browser, enter:
http://boxgpt.local:8080 - Login:
Create a new user account (non-admin). Or use the default admin account:- Email:
admin@admin.com - Password:
admin
- Email:
Ubuntu System Login (Local Desktop Access)
If you are using Offline Mode or connecting a monitor directly to BoxGPT, you can access the Ubuntu desktop environment.
Default system credentials:
- Username:
test - Password:
test
Once logged in, you can open the browser or terminal directly from the desktop.
Notes
- The configuration will persist across reboots — no need to repeat setup unless you wish to change modes.
- To reset or reconfigure the system, simply re-edit
boxgpt.confon the USB drive and repeat the process.