Setup

Get started with NEPI

Follow these steps to get the NEPI Docker container running on your hardware.

Step 1

Check system requirements

Before installing, confirm your hardware meets the minimum requirements.

Supported platforms:

Software requirements:

Step 2

Install Docker

If Docker is not already installed on your system, follow the official installation guide for your platform.

For Jetson platforms: Docker comes pre-installed on JetPack. Verify with:

$ docker --version

For x86 systems: Install Docker Engine following the official Docker documentation.

Step 3

Pull the NEPI container

Download the latest NEPI container image from Docker Hub.

$ docker pull numurus/nepi-engine:latest

This downloads the full NEPI platform including all drivers, AI frameworks, automation tools, and the browser-based UI.

Step 4

Run the container

Start NEPI with the following command. This launches the platform with access to your host hardware and network.

$ docker run --runtime nvidia --privileged --network host numurus/nepi-engine:latest

For x86 systems without NVIDIA GPU, omit the --runtime nvidia flag.

Step 5

Access the NEPI interface

Once the container is running, open a web browser and navigate to your device's IP address on port 5003.

http://<your-device-ip>:5003

You should see the NEPI web UI with dashboards for system status, connected hardware, sensor feeds, and AI outputs.

Next steps

Now that NEPI is running, here's where to go next.

Connect hardware

Plug in your sensors and cameras. NEPI will automatically detect and configure supported devices.

Hardware setup guide

Follow a tutorial

Walk through a complete project from sensor connection to AI deployment and automation.

Browse tutorials

Join the community

Ask questions, get help from other developers, and share what you're building.

Join Discord

Need help?

If you run into issues or have questions about your setup, we're here to help.