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
Requirements
Make sure you have 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

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.

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

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:
Volume 1:
host path: dataos_data
Container path: /home/bun/.gaio-dataos
Volume 2:
host path: dataos_clickhouse
Container path: /var/lib/clickhouse
Click Run Container to launch the environment.

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.

2. Enter your email
Type in a valid email address to proceed.

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.

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.

You're all set!
Congratulations! You’ve successfully installed Gaio DataOS. 🎉
You can now:
Import and process data
Build dashboards and APIs
Automate data flows
Use integrated AI features
And much more 🚀

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:
# 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:
# 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 --name gaio-dataos -p 6410:6410 -v dataos_data:/home/bun/.gaio-dataos -v dataos_clickhouse:/var/lib/clickhouse gaiodataos/gaiodataos:latest
# Start the container - Pull specific version
docker run --name gaio-dataos -p 6410:6410 -v dataos_data:/home/bun/.gaio-dataos -v dataos_clickhouse:/var/lib/clickhouse gaiodataos/gaiodataos:v0.0.800
Need help?
We're here to support you: https://gaio.discourse.group/
Last updated