> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Crosstalk-Solutions/project-nomad/llms.txt
> Use this file to discover all available pages before exploring further.

# 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)           |

<Note>
  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.
</Note>

### 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.

<Steps>
  <Step title="Run the one-line installer">
    ```bash theme={null}
    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
    ```
  </Step>

  <Step title="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.
  </Step>

  <Step title="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
    ```
  </Step>
</Steps>

<Warning>
  The install script requires `sudo` privileges. Running it without `sudo` will cause it to exit with an error.
</Warning>

## 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.

<CardGroup cols={2}>
  <Card title="Easy Setup Wizard" icon="wand-magic-sparkles" href="/getting-started/easy-setup">
    First-time setup guide for configuring capabilities and downloading content.
  </Card>

  <Card title="Advanced Installation" icon="docker" href="/getting-started/advanced-installation">
    Deploy using Docker Compose directly for full control over configuration.
  </Card>
</CardGroup>