> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vectoraidb.actian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux

> Get VectorAI DB running on Linux using the installer script.

## Prerequisites

* Linux with systemd (Ubuntu 22.04 LTS or later recommended)
* `unzip` and `node` installed
* 8 GB RAM (16 GB+ recommended)
* 10 GB disk space (100 GB+ recommended)

## Install VectorAI DB

<Tabs>
  <Tab title="x86-64 (AMD/Intel)">
    <Steps>
      <Step title="Extract the tarball">
        Download `Actian-VectorAI-linux-x64-1.0.0.tar.gz` from the [Actian VectorAI DB downloads page](https://www.actian.com/databases/vectorai-db/) after signing up, then run:

        ```bash theme={null}
        tar -xzf Actian-VectorAI-linux-x64-1.0.0.tar.gz -C /usr/local
        ```

        This creates the following structure:

        ```
        /usr/local/actian-vectorai/install/
        ├── cortex-core-linux-x64-1.0.0-package.tar.gz
        ├── cortex.web-linux-x64-nightly-20260425.zip
        ├── install_actian_vectorai.sh
        └── uninstall_actian_vectorai.sh
        ```
      </Step>

      <Step title="Run the installer">
        ```bash theme={null}
        cd /usr/local/actian-vectorai/install
        sudo bash install_actian_vectorai.sh
        ```

        The installer prompts you to accept the EULA. Enter `y` to continue.

        To skip the prompt in automated environments:

        ```bash theme={null}
        sudo ACCEPT_ACTIAN_VECTORAI_EULA=YES bash install_actian_vectorai.sh
        ```

        When complete, the installer prints:

        ```
        [timestamp] Install completed successfully
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="ARM64">
    <Steps>
      <Step title="Extract the tarball">
        Download `Actian-VectorAI-linux-arm64-1.0.0.tar.gz` from the [Actian VectorAI DB downloads page](https://www.actian.com/databases/vectorai-db/) after signing up, then run:

        ```bash theme={null}
        tar -xzf Actian-VectorAI-linux-arm64-1.0.0.tar.gz -C /usr/local
        ```

        This creates the following structure:

        ```
        /usr/local/actian-vectorai/install/
        ├── cortex-core-linux-arm64-1.0.0-package.tar.gz
        ├── cortex.web-linux-arm64-nightly-20260425.zip
        ├── install_actian_vectorai.sh
        └── uninstall_actian_vectorai.sh
        ```
      </Step>

      <Step title="Run the installer">
        ```bash theme={null}
        cd /usr/local/actian-vectorai/install
        sudo bash install_actian_vectorai.sh
        ```

        The installer prompts you to accept the EULA. Enter `y` to continue.

        To skip the prompt in automated environments:

        ```bash theme={null}
        sudo ACCEPT_ACTIAN_VECTORAI_EULA=YES bash install_actian_vectorai.sh
        ```

        When complete, the installer prints:

        ```
        [timestamp] Install completed successfully
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

The REST API is available at `localhost:6573`. The Local UI is available at `localhost:6575`.

## Verify installation

<Note>
  Run these commands in a terminal after installation completes.
</Note>

```bash theme={null}
# Check service status
systemctl status actian-vectorai
systemctl status actian-vectorai-webui

# Check the engine API
curl http://localhost:6573/

# List collections
curl http://localhost:6573/collections
```

A successful response from `curl http://localhost:6573/` looks like this:

```json theme={null}
{
  "title": "Actian VectorAI DB",
  "version": "Actian VectorAI DB 1.0.0 / VDE 1.0.0",
  "commit": ""
}
```

## Troubleshooting

| Issue                                  | Solution                                                                |
| -------------------------------------- | ----------------------------------------------------------------------- |
| Services not running after install     | Run `sudo systemctl start actian-vectorai actian-vectorai-webui`        |
| Port 6573 / 6574 / 6575 already in use | Find the process: `sudo lsof -i :6573`, then stop it or change the port |
| Missing prerequisites error            | Run `sudo apt install -y unzip nodejs` and re-run the installer         |
| Connection refused                     | Wait a few seconds for the services to initialize, then retry           |
| Engine logs                            | `journalctl -u actian-vectorai`                                         |

### Check service status

```bash theme={null}
systemctl status actian-vectorai
systemctl status actian-vectorai-webui

# Restart a service if needed
sudo systemctl restart actian-vectorai
```

## Uninstall

Run the uninstall script included with the installer:

```bash theme={null}
sudo bash /usr/local/actian-vectorai/install/uninstall_actian_vectorai.sh
```

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/home/quickstart/quickstart">
    Create your first collection, insert vectors, and run a search.
  </Card>

  <Card title="Core concepts" icon="book-open" href="/home/getting-started/overview">
    Understand the data model, architecture, and how search works.
  </Card>

  <Card title="Python SDK" icon="code" href="/sdks/python/installation">
    Install and configure the Python SDK.
  </Card>
</CardGroup>