Demo Installation

This tutorial walks you through setting up, configuring, and running a NEPI Docker Demo Installation on a supported device.

Supported devices: Ubuntu PC, NVIDIA Jetson

NEPI Docker Demo Installations are recommended for a quick demo of the NEPI Software Container for experienced Linux users. If you are not an experienced Linux user, you may want to try the NEPI Docker Lite installation, which includes a fully automated setup process. See the NEPI Docker Lite Setup instructions.

NEPI Docker Demo Env Setup

Log into a user account on the device with 'Administrator' privileges. Open a Terminal window by right-clicking on the desktop and selecting the "Open in Terminal" option.

Check that Docker is installed on your device by typing:

docker

Check that a Chromium web browser is installed on your device by typing:

chromium

Create NEPI required system folders on your device, and add your user to required system groups:

sudo -v

Then run:

CONFIG_USER=$(id -un) && USER_1000=$(id -nu 1000)
sudo mkdir /mnt/nepi_config
sudo chown 1000:1000 /mnt/nepi_config
sudo mkdir /mnt/nepi_storage
sudo chown 1000:1000 /mnt/nepi_storage
sudo usermod -aG sudo $CONFIG_USER
sudo adduser ${CONFIG_USER} dialout
sudo usermod -aG dialout ${CONFIG_USER}
sudo usermod -aG tty ${CONFIG_USER}
sudo usermod -aG i2c ${CONFIG_USER}
sudo usermod -aG video ${CONFIG_USER}
sudo usermod -aG docker ${CONFIG_USER}
sudo usermod -aG ${USER_1000} ${CONFIG_USER}
exec su -l $CONFIG_USER

Install the latest NEPI Docker Image for your device. Select your device type:

sudo docker pull numurusinc/nepi:latest-amd64

sudo docker tag numurusinc/nepi:latest-amd64 nepi:latest
sudo docker rmi numurusinc/nepi:latest-amd64

sudo docker pull numurusinc/nepi:latest-amd64-cuda

sudo docker tag numurusinc/nepi:latest-amd64-cuda nepi:latest
sudo docker rmi numurusinc/nepi:latest-amd64-cuda

sudo docker pull numurusinc/nepi:latest-jetson

sudo docker tag numurusinc/nepi:latest-jetson nepi:latest
sudo docker rmi numurusinc/nepi:latest-jetson

Install the latest NEPI Storage Files, which include sample data, AI model, and configuration files:

sudo -v

Then run:

cd /mnt/nepi_storage
storage_latest_link='https://www.dropbox.com/scl/fi/za3sz2q7e0pbcj6m89d8h/nepi_storage-latest.zip?rlkey=eq6u97w6qpqiqblcudqnwj8ud&st=hj0yewy3&dl=0'
storage_latest_zip=nepi_storage-latest.zip
sudo rm ${storage_latest_zip} 2> /dev/null
sudo wget ${storage_latest_link} -O ${storage_latest_zip}
sudo -v && sudo unzip -o -q $storage_latest_zip
sudo rm ${storage_latest_zip} 2> /dev/null
sudo chown -R 1000:1000 ${NEPI_STORAGE}
ls ./

NEPI Docker Software Testing

Start your NEPI container running. Select your device type:

sudo docker run -d --privileged --rm -e UDEV=1 --ipc=host --user 0:0 \
--mount type=bind,source=/mnt/nepi_storage,target=/mnt/nepi_storage \
--mount type=bind,source=/mnt/nepi_config,target=/mnt/nepi_config \
--mount type=bind,source=/dev,target=/dev \
--mount type=bind,source=/etc/udev,target=/etc/udev \
--cap-add=SYS_TIME --volume=/var/empty:/var/empty \
-v /etc/ntpd.conf:/etc/ntpd.conf -e DISPLAY=:0 \
--net=host -p 9091:9091 -p 9092:9092 -p 11311:11311 \
-p 137:137/udp -p 138:138/udp -p 139:139/tcp -p 445:445/tcp \
nepi:latest /bin/bash -c '/nepi_start_all'

sudo docker run -d --privileged --rm -e UDEV=1 --ipc=host --user 0:0 \
--mount type=bind,source=/mnt/nepi_storage,target=/mnt/nepi_storage \
--mount type=bind,source=/mnt/nepi_config,target=/mnt/nepi_config \
--mount type=bind,source=/dev,target=/dev \
--mount type=bind,source=/etc/udev,target=/etc/udev \
--cap-add=SYS_TIME --volume=/var/empty:/var/empty \
-v /etc/ntpd.conf:/etc/ntpd.conf -e DISPLAY=:0 \
--net=host -p 9091:9091 -p 9092:9092 -p 11311:11311 \
-p 137:137/udp -p 138:138/udp -p 139:139/tcp -p 445:445/tcp \
--gpus all --runtime nvidia -v /tmp/.X11-unix/:/tmp/.X11-unix \
nepi:latest /bin/bash -c '/nepi_start_all'

sudo docker run -d --privileged --rm -e UDEV=1 --ipc=host --user 0:0 \
--mount type=bind,source=/mnt/nepi_storage,target=/mnt/nepi_storage \
--mount type=bind,source=/mnt/nepi_config,target=/mnt/nepi_config \
--mount type=bind,source=/dev,target=/dev \
--mount type=bind,source=/etc/udev,target=/etc/udev \
--cap-add=SYS_TIME --volume=/var/empty:/var/empty \
-v /etc/ntpd.conf:/etc/ntpd.conf -e DISPLAY=:0 \
--net=host -p 9091:9091 -p 9092:9092 -p 11311:11311 \
-p 137:137/udp -p 138:138/udp -p 139:139/tcp -p 445:445/tcp \
--gpus all --runtime nvidia -v /tmp/.X11-unix/:/tmp/.X11-unix \
-v /var/run/docker.sock:/var/run/docker.sock -v /tmp:/tmp \
-v /usr/bin/nvargus-daemon:/usr/bin/nvargus-daemon \
nepi:latest /bin/bash -c '/nepi_start_all'

Open Chromium web browser. Check that the NEPI Resident User Interface (RUI) is running by opening the Chromium browser and entering the following in the search bar:

localhost:5003

This will take you to the NEPI RUI dashboard. Once the NEPI core software system is running, you should see a blinking green indicator and messages.

You can also access the NEPI admin page for managing NEPI software configurations by entering the following in the search bar:

localhost:5003/admin

The default admin password is: nepiadmin

To learn more about using, configuring, and building NEPI software, see the NEPI tutorials and quick start guide.

NEPI Software Support

To learn more about using, configuring, and building NEPI software, see the NEPI website for documentation, tutorials, videos, and the community forum.