Installation

Install Project N.O.M.A.D. on a Debian-based system using the one-line installer.

Project N.O.M.A.D. can be installed on any Debian-based operating system. The installation is entirely terminal-based. All tools and resources are accessed through a browser, so no desktop environment is required if you want to run N.O.M.A.D. as a headless server.

Prerequisites

Before you begin, confirm your system meets the following requirements.

Operating system

• Debian-based Linux distribution (Ubuntu recommended)
• sudo or root privileges

Hardware

For a base installation of the Command Center only:

Component	Minimum
Processor	2 GHz dual-core or better
RAM	4 GB
Storage	5 GB free disk space
OS	Debian-based (Ubuntu recommended)

To run AI tools (LLMs) and take full advantage of all capabilities:

Component	Recommended
Processor	AMD Ryzen 7 / Intel Core i7 or better
RAM	32 GB
GPU	NVIDIA RTX 3060 or AMD equivalent or better
Storage	250 GB free (SSD preferred)
OS	Debian-based (Ubuntu recommended)

The tools and resources you choose to install with N.O.M.A.D. determine the specs you need — not N.O.M.A.D. itself. A base install is lightweight; adding AI models and large content libraries requires significantly more storage and RAM.

Internet connection

An internet connection is required during installation to download dependencies. After installation, N.O.M.A.D. runs fully offline and does not require internet access.

Quick install

Run the following command in your terminal. It updates your package list, installs curl, downloads the install script, and runs it.

1. Run the one-line installer

   sudo apt-get update && sudo apt-get install -y curl && curl -fsSL https://raw.githubusercontent.com/Crosstalk-Solutions/project-nomad/refs/heads/main/install/install_nomad.sh -o install_nomad.sh && sudo bash install_nomad.sh
   
2. Wait for installation to complete

   The script installs Docker (if not already present), pulls the required container images, and starts all services. This may take several minutes depending on your internet speed.

3. Open the Command Center

   Once installation finishes, open a browser and navigate to:

   http://localhost:8080
   

   If you are accessing N.O.M.A.D. from another device on your network, use your device’s IP address instead:

   http://DEVICE_IP:8080
   

The install script requires sudo privileges. Running it without sudo will cause it to exit with an error.

After installation

Once you can access the Command Center at http://localhost:8080, N.O.M.A.D. is running. The next step is to run through the Easy Setup Wizard to configure your capabilities and download content.

If you are an advanced user who wants to manage the Docker Compose configuration directly, see the Advanced Installation guide instead.

Easy Setup Wizard

First-time setup guide for configuring capabilities and downloading content.

Advanced Installation

Deploy using Docker Compose directly for full control over configuration.