# Instalação com o Docker

Bem-vindo ao **guia de instalação da versão Comunitária do Gaio DataOS!**

Este tutorial irá guiá-lo pelas etapas para executar o Gaio DataOS localmente usando o Docker Desktop.

***

{% hint style="warning" %}
Cada conta de licença Gaio DataOS pode ter um número ilimitado de licenças comunitárias, permitindo que você crie várias instâncias para testes, aprendizagem ou uso comercial.\
O gerenciamento de licenças (comunitárias, SaaS ou empresariais) é feito através do seu painel de controle:

👉 [console.gaiodataos.com](https://console.gaiodataos.com)
{% endhint %}

***

### Requisitos

Certifique-se de ter o [Docker Desktop](https://www.docker.com/products/docker-desktop/) instalado em sua máquina.

{% hint style="info" %}
O Docker está disponível para Windows, macOS e Linux. Baixe a versão compatível com o seu sistema operacional.
{% endhint %}

***

### Passos para instalação:

#### 1. Abra Docker Desktop

* Inicie o Docker Desktop no seu computador.

***

#### 2. Pesquise a imagem Gaio DataOS

* Clique no botão **Buscar** ou use um atalho:
  * `Ctrl + K` (Windows/Linux)
  * `Cmd + K` (Mac)
* No campo de busca, digite:

  ```
  gaiodataos
  ```

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

***

#### 3. Puxe a imagem

* Clique em **Puxar** para instalar a imagem oficial do Gaio DataOS.

{% hint style="warning" %}
Aguarde até que o download seja concluído. Isso pode levar alguns minutos, dependendo da velocidade da sua internet.
{% endhint %}

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

***

#### 4. Execute a imagem

* Vá para a guia **Imagens** no Docker.
* Clique em **Executar** ao lado da imagem `gaiodataos` .

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

***

#### 5. Configure o contêiner

* No campo **Nome do contêiner**, insira algo como `gaio_dataos`.
* Para o **mapeamento de portas**, defina:

  ```
  6410
  ```
* Clique em **Executar contêiner** para iniciar o ambiente.

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

***

#### 6. Acesse a plataforma

* No seu navegador, acesse:

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

***

### Configuração Inicial

#### 1. Selecione seu idioma

* Na tela de boas-vindas, selecione o idioma de sua preferência.

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

***

#### 2. Insira seu e-mail

* Digite um e-mail válido para prosseguir

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

***

#### 3. Crie sua licença Gaio DataOS

* Se você ainda não possui uma conta de licença do Gaio DataOS:
  * Preencha o formulário exibido.
  * Clique em **Enviar** para gerar sua conta de licença do Gaio DataOS.

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

***

#### 4. Crie sua conta de usuário local

* Após a criação da licença, você será solicitado a configurar uma **conta de usuário local**.
* Esta conta será o seu login para acessar a plataforma nesta máquina.

> 🔐 A versão Community permite criar usuários locais para cada instância instalada do Gaio.

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

***

### Tudo pronto!

Parabéns! Você instalou o Gaio DataOS com sucesso. 🎉&#x20;

Agora você pode:

* Importe e processe os dados.
* Construa dashboards e APIs.
* Automatize os fluxos de dados.
* Use recursos integrados de IA
* E muito mais 🚀

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

***

## Gaio DataOS — Instruções para atualização da imagem do Docker

### Baixando a versão mais recente ou uma versão específica:

Você também pode usar a linha de comando para obter a versão mais recente ou uma versão específica:

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

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

***

## Reiniciando o contêiner após a atualização

Depois de baixar a imagem atualizada, pare o contêiner `gaiodataos` e inicie-o novamente.\
Você também pode usar a linha de comando. Substitua `<container_id>` nos comandos abaixo com o ID do contêiner que você encontra no primeiro comando:

```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
docker run --name gaio-dataos -p 6410:6410 -v dataos_data:/.gaio-dataos -v dataos_clickhouse:/var/lib/clickhouse gaiodataos/gaiodataos:latest
```

***

### Precisa de ajuda?

Estamos aqui para ajudá-lo: <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/gaio-dataos-portuguese/getting-started/instalacao-com-o-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.