# Installation with Docker

Welcome to the **installation guide for the Community version of Gaio DataOS**!

This tutorial will walk you through the steps to run Gaio DataOS locally using Docker Desktop.

***

> **Important:**\
> Each Gaio DataOS License Account can have an **unlimited number of Community licenses**, allowing you to create multiple instances for testing, learning, or commercial use.
>
> License management (Community, SaaS, or Enterprise) is handled through your control panel:\
> 👉 [console.gaiodataos.com](https://console.gaiodataos.com)

***

### Requirements

Make sure you have [Docker Desktop](https://www.docker.com/products/docker-desktop/) installed on your machine.

> 📌 **Tip:** Docker is available for Windows, macOS, and Linux. Download the version that matches your operating system.

***

### Installation Steps

#### 1. Open Docker Desktop

* Launch Docker Desktop on your computer.

***

#### 2. Search for the Gaio DataOS image

* Click the **Search** button or use the shortcut:
  * `Ctrl + K` (Windows/Linux)
  * `Cmd + K` (Mac)
* In the search field, type:

  ```
  gaiodataos
  ```

<figure><img src="/files/JQTMRBWDEzXKjX4T3426" alt=""><figcaption></figcaption></figure>

***

#### 3. Pull the image

* Click **Pull** to download the official Gaio DataOS image.

> ⏳ Please wait for the download to complete. It may take a few minutes depending on your internet speed.

<figure><img src="/files/kVHXLoRmzP7kNmhqwC0z" alt=""><figcaption></figcaption></figure>

***

#### 4. Run the image

* Go to the **Images** tab in Docker.
* Click **Run** next to the `gaiodataos` image.

<figure><img src="/files/9BoD7pmGbRkcUjTc3Qs6" alt=""><figcaption></figcaption></figure>

***

#### 5. Set up the container

* In the **Container Name** field, enter something like `gaio-dataos`.
* For **Port Mapping**, set:

  ```
  6410
  ```
* In the **Volumes** field, add:&#x20;

```
Volume 1: 
Host path: dataos_content
Container path: /home/bun/.gaio-dataos/app/content
```

```
Volume 2: 
Host path: dataos_h2o
Container path: /home/bun/.gaio-dataos/h2o
```

```
Volume 3: 
Host path: dataos_redis
Container path: /home/bun/.gaio-dataos/redis
```

```
Volume 4: 
Host path: dataos_clickhouse
Container path: /var/lib/clickhouse
```

* Click **Run Container** to launch the environment.

<figure><img src="/files/92PXfPG6MtKA2E80AhiE" alt=""><figcaption></figcaption></figure>

***

#### 6. Access the platform

* In your browser, go to:

  ```
  http://localhost:6410
  ```

***

### Initial Configuration

#### 1. Choose your language

* On the welcome screen, select your preferred language.

<figure><img src="/files/u4jUfk1VRKKGdQmqs5Ry" alt=""><figcaption></figcaption></figure>

***

#### 2. Enter your email

* Type in a valid email address to proceed.

<figure><img src="/files/NxMN989mU92YmbJaFjGh" alt=""><figcaption></figcaption></figure>

***

#### 3. Create your Gaio DataOS license

* If you don’t already have a Gaio DataOS License Account:
  * Fill out the form displayed.
  * Click **Submit** to generate your Gaio DataOS License Account.

<figure><img src="/files/qXsCZB2O1FVQdVa8lDlQ" alt=""><figcaption></figcaption></figure>

***

#### 4. Create your local user account

* After the license is created, you’ll be prompted to set up a **local user account**.
* This account will be your login to access the platform on this machine.

> The Community version allows you to create local users for each installed instance of Gaio.

<figure><img src="/files/0Z2BkPthEdTfUUrK2XH8" alt=""><figcaption></figcaption></figure>

***

### You're all set!

Congratulations! You’ve successfully installed Gaio DataOS.&#x20;

You can now:

* Import and process data
* Build dashboards and APIs
* Automate data flows
* Use integrated AI features
* And much more&#x20;

<figure><img src="/files/4CBs3DFIktUJdegpij5O" alt=""><figcaption></figcaption></figure>

***

### **Gaio DataOS — Docker Image Update Instructions**

#### **Pulling the Latest or a Specific Version**

You can also use the command line to pull the latest, or a specific version:

```bash
# Pull latest (stable) version
docker pull gaiodataos/gaiodataos

# Pull specific version
docker pull gaiodataos/gaiodataos:v0.0.800
```

***

#### **Restarting the Container After Update**

After pulling the updated image, stop your `gaiodataos` container and start it again.\
You can also use the command line. Replace `<container_id>` in the commands below with the container ID you find in the first command:

```bash
# Find your container ID
docker ps -a

# Stop the container with the `<container_id>`
docker stop <container_id>

# Remove the container with the `<container_id>`
docker rm <container_id>

# Start the container - Pull latest (stable) version
docker run --pull always --name gaio-dataos -p 6410:6410 -v dataos_content:/home/bun/.gaio-dataos/app/content -v dataos_h2o:/home/bun/.gaio-dataos/h2o -v dataos_redis:/home/bun/.gaio-dataos/redis  -v dataos_clickhouse:/var/lib/clickhouse gaiodataos/gaiodataos:latest

# Start the container - Pull specific version
docker run --pull always --name gaio-dataos -p 6410:6410 -v dataos_content:/home/bun/.gaio-dataos/app/content -v dataos_h2o:/home/bun/.gaio-dataos/h2o -v dataos_redis:/home/bun/.gaio-dataos/redis  -v dataos_clickhouse:/var/lib/clickhouse gaiodataos/gaiodataos:v0.0.800
```

***

### Need help?

We're here to support you: <https://gaio.discourse.group/>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/getting-started/installation-with-docker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.