NEPI Engine – NEPI Docker Lite Setup
Introduction
The NEPI Docker Lite Setup tutorial walks you through installing, configuring, and running the NEPI software inside a Docker container while making minimal changes to the host operating system. This tutorial focuses on setting up the required NEPI users, configuring the Docker environment, initializing NEPI storage and images, and launching the NEPI container and Resident User Interface for the first time.
The Lite setup is designed for fast evaluation, development, and demonstration of NEPI on PCs, laptops, and trial edge devices. It allows users to explore NEPI’s AI, automation, and hardware integration capabilities without NEPI managing system-level services such as networking, SSH, or storage sharing. This makes it ideal for learning, prototyping, classroom use, and early-stage testing before committing a device to a production configuration.
What you will need
1) 1x NEPI-enabled device.
2) 1x PC with Ethernet network adapter and WiFi support. This tutorial uses a Windows 11 PC and a USB GigE Ethernet adapter.
3) 1x Ethernet cable, keyboard, and mouse connected to the host system.
Hardware Setup
Connect monitor, keyboard, and mouse to the host system. Note: You’ll need to connect to internet either through wired Ethernet or wifi.
Tutorial Notes
– NEPI Lite Installations are recommended for PC base installations and trial Edge-Compute processor installations.
– You will be power-cycling multiple times throughout this installation, you may want to open this tutorial on another screen for convenience.
– NEPI Lite installation will require a minimum of 60 GB of available free hard drive space. See the ‘Check Available Disk Space’ section at the end of these instructions for more information on checking available space.
– NEPI Lite installation will make minimal changes to your device’s operating system configuration with no NEPI management of operating system services (i.e. HOSTNAME, NETWORK, WIFI, SSH, SAMBA SHARED DRIVES, DOCKER …).
– After testing with the Lite installation, systems can be upgraded to the Full Installation to enable local and remote real-time management of operating system services through NEPI’s user interface and APIs. See the NEPI Docker Full Setup Tutorial
NEPI Docker Lite User Setup
This section creates the nepihost user account and prepares your device to install NEPI Docker by cloning the NEPI setup repository that contains the required installation scripts.
1) Log into a user account with Administrator privileges, or use the existing nepihost account if available.
2) Open a Terminal window: right-click the desktop / Open in Terminal
3) Confirm your system has internet access by running the following command:
ping -c 1 google.com
4) Update Git application:
sudo apt update && sudo apt install -y git
5) Clone the NEPI setup repository:
cd /home/${USER}
git clone https://github.com/nepi-engine/nepi_setup.git
6) Run the NEPI Docker user setup script (sudo password is ‘#Nsetup4You’):
cd /home/${USER}/nepi_setup/scripts
sudo su
Then:
./docker_user_setup.sh
Start Screen:
End Screen:
7) POWER CYCLE your system when complete to apply the new settings
NOTE: This section creates a new user account nepihost, the next section will have you login to this new user with the sudo password nepi.
NEPI Docker Lite Environment Setup
This section will set up the NEPI Docker required software environment.
1) Log into the nepihost account created in Docker User Setup (sudo password is now ‘nepi’). Go through any new user starter popups. Then Open terminal.
2) Make sure your system has internet access by running the following command:
ping -c 1 google.com
3) Clone the NEPI Setup repo:
cd /home/${USER}
git clone https://github.com/nepi-engine/nepi_setup.git
4) Run the NEPI Docker Lite Environment setup script (sudo password is ‘nepi’):
source /home/nepihost/nepi_setup/scripts/docker_lite_env_setup.sh
NOTE: For all password inputs, the text will be invisible, press enter after typing password.
NOTE: If prompted enter: ‘y’ or ‘yes’:
NOTE: This step can take around ~10 minutes to load.
Start Screen:
NOTE: If you get a ‘System program problem detected’ popup, select ‘Cancel’ to dismiss it.
NOTE: If you get a ‘Configuration Code’ popup, select ‘Yes’ and enter to continue.
End Screen:
5) Once the script completes, scroll through the terminal output and verify there are no errors.
6) POWER CYCLE your system when complete.
NEPI Docker Config Setup
This section will configure the NEPI Docker configuration using the default settings. You can change settings later in the ‘NEPI Docker Customization’ section.
1) Log into the nepihost account (sudo password is ‘nepi’)
2) Run the NEPI Docker Lite Configuration setup script (sudo password is ‘nepi’):
source /home/nepihost/nepi_setup/scripts/docker_lite_config_setup.sh
Start Screen:
End Screen:
3) POWER CYCLE your system when complete.
NOTE: After this process, the following changes will be made:
– Desktop background and sidebar applications menu updates.
– NEPI bash alias and util functions added to user bash profile.
– NEPI folder shortcuts added to File Manager folder bookmarks.
– Chromium browser updated with useful NEPI browser bookmarks.
– The NEPI Docker install instructions file is added to the Desktop.
NOTE: This process will create the following NEPI Folders:
– NEPI Storage folder created at ‘/mnt/nepi_storage’, along with several user subfolders. This is where NEPI processes store user files such as: Saved Data, AI models, Import/Export Docker Images, and User Saved Configurations.
– NEPI Docker folder created at ‘/mnt/nepi_docker’, This is where NEPI Docker Images are stored.
– NEPI Config folder created at ‘/mnt/nepi_config’, along with several config subfolders.
NEPI Docker Lite Init Setup
This section will initialize and test your NEPI Docker solution. You can change settings later in the ‘NEPI Docker Customization’ section.
1) Log into the nepihost account (sudo password is ‘nepi’)
2) Check for internet connection:
ping -c 1 google.com
3) Run the Docker Lite Initialization script (sudo password is ‘nepi’). If prompted enter: ‘y’ or ‘yes’:
source /home/nepihost/nepi_setup/scripts/docker_lite_init_setup.sh
4) Run the NEPI Docker Import command (sudo password is now ‘nepi’):
nepiimport
5) After the initialization script completes, you can view and print the installed NEPI Docker Images by typing:
dimg
NOTE: This process downloads the Lite AI models, AI training scripts, sample data files, and user_configurations to folders in /mnt/nepi_storage.
NOTE: This process downloads the latest NEPI Docker Image for your system’s architecture NEPI Docker’s import folder at /mnt/nepi_storage/nepi_images.
NEPI Docker Image Testing
This section verifies that the NEPI Docker container runs successfully and that the NEPI Resident User Interface (RUI) launches correctly.
1) Start your NEPI container running:
nepistart
2) Wait for the startup confirmation message.
NOTE Newly installed NEPI Docker Images may take several attempts to start successfully the first time after installation. Try running several times if it fails
3) Open Chromium browser. Check that the NEPI Resident User Interface (RUI) is running by opening the Chromium browser tab and entering the following in the URL search bar:
localhost:5003
4) Confirm that the NEPI RUI dashboard loads and shows a blinking green indicator, signaling that the core NEPI software system is running and that NEPI is active.
NOTE: RUI Controls related to User, Device, Time, Network, and Software management require the NEPI Docker service running.
NEPI Docker Service Setup
This step enables NEPI to automatically start whenever the system boots, so you don’t have to manually start it each time.
1) Enable NEPI Docker service:
nepienable
NOTE: You can disable the NEPI Docker Service with ‘nepidisable’
2) POWER CYCLE your system when complete.
3) Log back into nepihost (sudo password is ‘nepi’).
4) Verify that your NEPI Container is running after reboot:
dps
NOTE:If your container is not running, try to debug NEPI Docker Service issues with the following commands:
nepirestart
nepistatus
nepilogs
NEPI Docker Remote PC Connection
Once your NEPI container is running, verify that you can connect to it from a network-connected PC.
The following steps confirm that remote access, file sharing, and interface connections are working correctly.
1) Connect to the NEPI Host: Use a PC on the same network to connect to your NEPI device and confirm communication.
Follow the tutorial: Connecting and Setup
2) Access NEPI’s Shared Storage: From your PC’s File Manager, connect to the NEPI device’s shared ‘nepi_storage’ folder.
This lets you access saved data, AI models, and configuration files directly over the network.
Follow the tutorial: Accessing the User Storage Drive
3) Configure Through the NEPI RUI: Open the NEPI Resident User Interface (RUI) in a web browser on your PC to manage devices, AI models, and system settings.
Follow the tutorial: NEPI Configuration
4) SSH into NEPI: If you need command-line access, you can securely connect via SSH to either the NEPI Host or the running NEPI container.
Follow the tutorial: NEPI SSH Setup
Additional Resources
If this is your first time setting up NEPI Docker, it is highly recommended that you read through the “NEPI Docker Installation Notes” section on the official GitHub setup guide: NEPI Docker Host Setup Instructions on GitHub.
If you encounter any issues starting and running the NEPI Software container, see the debugging steps in the “NEPI Docker Debugging” section at the bottom of this page: https://github.com/nepi-engine/nepi_setup/blob/main/NEPI_DOCKER_LITE_SETUP.md
For additional support, visit the NEPI Software Community Forum at: NEPI Community
Debugging Troubleshooting
If your container is not running, try to debug NEPI Docker Service issues with the following commands:
nepirestart
nepistatus
nepilogs
For detailed debugging instructions, logs, and advanced troubleshooting steps, refer to the official GitHub setup guide: NEPI Docker Host Setup Instructions on GitHub.
NEPI Software Shortcut Functions
View all NEPI Docker command-line shortcuts anytime by typing:
nepihelp
NEPI Docker Remote PC Connections
If you want to connect to your NEPI device from a remote network connected PC, setup and test a remote connection following these instructions.
NOTE: You will manually need to set your NEPI Device’s network adapter IPV4 settings to ‘Manual’ with the following values ADDRESS = 192.168.179.103 NETMADK = 255.255.255.0 Then reboot your NEPI Device and continue to the tutorials listed below.
Test that you can connect to your running container from a network connected PC. See a tutorial at Connecting and Setup.
NOTE: NEPI Docker Lite Installations do not configure NEPI’s Network Shared Drive support, but the NEPI Storage and NEPI Config Folders, you can access them locally on the NEPI Device at /mnt/nepi_storage and /mnt/nepi_config.
NOTE: NEPI Docker Lite Installations do not configure NEPI Host SSH, but do support NEPI Container SSH connections. Learn more about the NEPI Folders content, see this tutorial for remote SSH access.
SSH into either your NEPI Host device or NEPI running container following this tutorial: NEPI SSH Setup.