ALPON X4 Operating System

This page describes the ALPON X4's customized Raspberry Pi OS, emphasizing its optimized performance and the need to maintain system integrity.

Operating System

📦 ALPON X4 · OS Reference · User Access Setup

The ALPON X4 operates on a customized version of Raspberry Pi OS Lite 64-bit Bookworm, specifically tailored for optimal IoT performance. This OS includes essential software for cellular communication, device management, network management, app and container management, API integration, and VPN setup.

🐧
Base Operating System
Raspberry Pi OS Lite 64-bit Bookworm

Customized by Sixfab for industrial IoT edge deployments. Includes pre-installed software stack for all ALPON platform capabilities.

Cellular Communication Device Management Network Management App & Container Management API Integration VPN Setup

This customized OS is optimized to ensure seamless performance and smooth operation of all pre-installed applications. We strongly advise against making any changes to the operating system, as modifications may negatively impact device performance, disrupt pre-installed applications, and cause conflicts with your own software.

For best results, we recommend using the system as provided. Any alterations could lead to reduced uptime, system instability, and compatibility issues that may affect both your applications and the ALPON X4's reliability.

⚠️
Do not modify the OS Any alterations to the base operating system may reduce uptime, cause system instability, and create compatibility issues that affect pre-installed applications and your own software.

Setting Up User Access

By default, the ALPON X4 device comes with a pre-configured alpon user and a password of sixfab.

This default user allows you to perform initial configuration on the device. However, for security reasons, you can choose to either update the password for this user or delete it entirely. Additionally, you can create a new user and grant them admin privileges.

Default Username
alpon
Default Password
sixfab
🔐
Change default credentials before deployment The default alpon / sixfab credentials are shared across all ALPON X4 devices. Always change the password or replace this user before deploying to a production environment.

Also, each ALPON X4 has a unique hostname based on its MAC address, in the format:

alpon-[MAC_ADDRESS]

This ensures that multiple devices on the same network do not conflict. Follow these steps to create a user account, assign admin privileges, and connect to the device:


1
Provision the Device

Before proceeding, ensure the device is provisioned via the Sixfab Connect platform.

📋 PrerequisiteALPON X4 Getting Started guide →
2
Access the Remote Terminal

Log in to the Sixfab Connect platform and open the remote terminal for your ALPON X4.

💻
The remote terminal gives you shell access to the device from any browser — no SSH client or network configuration needed for this step.
3
Manage the Default User

The ALPON X4 device comes with the alpon user account, with the password set to sixfab. For enhanced security, you can:

Option A — Change the password
terminal shell
passwd alpon

Enter the new password and confirm it.

Option B — Delete the user entirely
terminal shell
sudo deluser alpon

After completing these steps, it is recommended to create a new user for further access and management (see Step 4).

4
Create a New User

Run the following command to create a new user:

terminal shell
adduser [USERNAME]

Replace [USERNAME] with the desired username. Example:

terminal — example shell
adduser test
  • Enter a password when prompted.
  • Confirm the password.

Assign Admin Privileges

Grant the new user admin rights by running:

terminal shell
echo "[USERNAME] ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/[USERNAME]

Example:

terminal — example shell
echo "test ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/test
5
Connect via SSH

Once the user is created, connect to the device from your computer using SSH:

terminal shell
ssh [USERNAME]@alpon-[MAC_ADDRESS].local

Example — if your device's hostname is alpon-2ccf67319374 and your username is test:

terminal — example shell
ssh test@alpon-2ccf67319374.local
SSH Connection Reference
Username
test (the user you created in Step 4)
Hostname
alpon-2ccf67319374.local (unique per device — find on label)
Port
22 (default SSH port)
Network
Same local network required, or use Sixfab Connect remote terminal
💡
The .local suffix uses mDNS (Bonjour/Avahi). If hostname resolution fails, use the device's IP address instead: ssh test@<IP_ADDRESS>
6
Connect via Display Optional

If needed, you can connect a display to the ALPON X4 via HDMI and log in using the created username and password.

🖥️
Connect the HDMI cable before powering on the device. The ALPON X4's HDMI 2.0 port supports up to 4Kp60 output.
User access configured Your device now has a secure user account. You can connect via SSH or the Sixfab Connect remote terminal to manage your ALPON X4.