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

# Docker

> Get VectorAI DB running locally using Docker.

## Prerequisites

* [Docker](https://docs.docker.com/get-docker/) installed and running
* 8 GB RAM (16 GB+ recommended)
* 10 GB disk space (100 GB+ recommended)

## Run VectorAI DB

```bash theme={null}
docker pull actian/vectorai:latest
docker run -d --name vectorai \
  -v ./local_data:/var/lib/actian-vectorai \
  -p 6573-6575:6573-6575 \
  -e ACTIAN_VECTORAI_ACCEPT_EULA=YES \
  actian/vectorai:latest
```

The gRPC server is available at `localhost:6574`. The Local UI is available at `localhost:6575`.

<Note>
  Want to go further? [Start a free 30-day trial](https://www.actian.com/databases/vectorai-db/community-edition/) and scale to 1 million vectors, fully on your infrastructure. No credit card required.
</Note>

## Using Docker Compose

Create a `docker-compose.yml` file:

```yaml theme={null}
services:
  vectorai:
    image: actian/vectorai:latest
    container_name: vectorai
    ports:
      - "6573:6573"
      - "6574:6574"
      - "6575:6575"
    volumes:
      - ./local_data:/var/lib/actian-vectorai
    environment:
      - ACTIAN_VECTORAI_ACCEPT_EULA=YES
    restart: unless-stopped
```

Start the service:

```bash theme={null}
docker-compose up -d
```

Stop the service:

```bash theme={null}
docker-compose down
```

## Verify installation

<Note>
  **Python SDK required**: Run `pip install actian-vectorai-client` first, or see the [Python SDK installation guide](/sdks/python/installation).
</Note>

```python theme={null}
from actian_vectorai import VectorAIClient

with VectorAIClient("localhost:6574") as client:
    info = client.health_check()
    print(f"Connected to {info['title']} v{info['version']}")
```

## Troubleshooting

| Issue                          | Solution                                                                                                                        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| Connection failed              | Ensure the container is running: `docker ps`                                                                                    |
| Port already in use            | Stop services using port 6574 or remap: `-p 6576:6574`                                                                          |
| Permission denied              | Run Docker with appropriate permissions or add your user to the docker group                                                    |
| Container exits immediately    | Check logs: `docker logs <container-id>`                                                                                        |
| Container exits (Linux / WSL2) | Volume mount permission mismatch: the container runs as UID 999. Run `chown -R 999:999 ./local_data` on the host, then restart. |

### View Docker logs

```bash theme={null}
# List running containers
docker ps

# View logs
docker logs <container-id>

# Follow logs in real-time
docker logs -f <container-id>
```

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