# Self-hosting

> Rode o Nodaro no seu servidor com Docker Compose. Compare as edições Community, Business e Cloud e veja o que exige chaves próprias ou o Nodaro Cloud.

Source: https://nodaro.ai/pt-BR/docs/self-hosting

Fazer **self-hosting** do Nodaro significa rodar o produto inteiro — o editor visual, a API REST e os workers que executam os seus workflows — em um servidor que você controla. Um único arquivo do Docker Compose inicia o Nodaro junto com o próprio banco de dados, login, armazenamento de mídia e filas de jobs, então uma instalação nova não precisa de conta de nuvem nem de configuração. Para gerar imagens, vídeos e áudio, você então adiciona as suas próprias chaves de provedores de modelos ou conecta a instalação ao Nodaro Cloud.

## O que você recebe
- **O editor e a API completos.** O mesmo canvas, os mesmos nós, os mesmos apps e a mesma API REST do Nodaro Cloud, servidos a partir do seu próprio domínio. O documento OpenAPI 3.1 da sua instalação fica em `/v1/openapi.json`.
- **Tudo incluído.** A stack do Compose roda o Postgres, o login, uma API de dados, o armazenamento MinIO e o Redis ao lado do Nodaro. A mídia fica no seu disco.
- **Sem créditos.** A Community Edition não tem sistema de créditos, taxas do Nodaro nem marca d’água. Você paga os seus provedores de modelos diretamente.
- **Uma tela de integridade.** `/setup` mostra o estado do banco de dados, do Redis, do armazenamento, da chave de criptografia e das suas chaves de provedor, sem login.
- **Backups com um comando.** Um script salva o banco de dados, a mídia, a chave de criptografia e o seu `.env` em um único arquivo de backup.

## Três edições
O Nodaro tem três edições, feitas a partir do mesmo código. A variável `EDITION` escolhe uma delas: `community`, `business` ou `cloud`.

| | Community | Business | Cloud |
| --- | --- | --- | --- |
| **Onde roda** | No seu servidor | No seu servidor | Em app.nodaro.ai, gerenciada pelo Nodaro |
| **Painel de administração** | Não | Sim | Sim |
| **Gerenciamento de usuários** | Não | Sim | Sim |
| **Créditos e cobrança** | Não | Não | Sim |
| **Perfil de superfície** | Ignorado | Sim | Sim |

A imagem Docker publicada é a Community Edition. O painel de administração e o gerenciamento de usuários da Business edition são recursos Enterprise, e usar recursos Enterprise em produção exige uma assinatura do Nodaro Enterprise. Leia [Edições e perfis de superfície](https://nodaro.ai/docs/self-hosting/editions-and-profiles) para trocar de edição e [Licença](https://nodaro.ai/docs/self-hosting/license) para ver os termos.

## As suas próprias chaves ou uma conexão com o Nodaro Cloud
Os nós que chamam um modelo de IA precisam de um provedor de modelos. Uma instalação self-hosted obtém um provedor de duas formas: com as suas próprias chaves de provedor ou com uma conexão com uma conta do Nodaro Cloud, que cobra em créditos. As duas formas podem funcionar lado a lado.

| O que você quer executar | O que é preciso |
| --- | --- |
| Modelos padrão de imagem, vídeo, fala, música e texto | As suas chaves de provedor, como `KIE_API_KEY`, `REPLICATE_API_TOKEN`, `ANTHROPIC_API_KEY`, `GEMINI_API_KEY` ou `ELEVENLABS_API_KEY`, ou uma conexão com o Nodaro Cloud |
| [**Avatar de IA** (AI Avatar)](https://nodaro.ai/docs/nodes/video/ai-avatar) e [**Avatar cinematográfico** (Cinematic Avatar)](https://nodaro.ai/docs/nodes/video/cinematic-avatar) | `HEYGEN_API_KEY` ou uma conexão com o Nodaro Cloud |
| [**Reiluminar e trocar** (Relight & Switch)](https://nodaro.ai/docs/nodes/video/relight-and-switch) | `BEEBLE_API_KEY` ou uma conexão com o Nodaro Cloud |
| [**Extrair da web** (Web Scrape)](https://nodaro.ai/docs/nodes/automate/web-scrape) | `APIFY_API_TOKEN` ou uma conexão com o Nodaro Cloud |
| Os nós exclusivos do Nodaro, como [**Gerar vídeo Pro** (Generate Video Pro)](https://nodaro.ai/docs/nodes/video/generate-video-pro), [**Editar vídeo Pro** (Edit Video Pro)](https://nodaro.ai/docs/nodes/video/edit-video-pro), [**Modificador de voz Pro** (Voice Changer Pro)](https://nodaro.ai/docs/nodes/audio/voice-changer-pro), [**Análise de vídeo** (Video Analysis)](https://nodaro.ai/docs/nodes/video/video-analysis) e [**Auditoria com IA** (AI Audit)](https://nodaro.ai/docs/nodes/video/ai-audit) | Uma conexão com o Nodaro Cloud |
| As edições de vídeo e de áudio, como cortar e combinar, e o [**Renderizar vídeo** (Render Video)](https://nodaro.ai/docs/nodes/video/render-video) | Nada: elas rodam no seu servidor |
| [**Gerar cena 3D** (Generate 3D Scene)](https://nodaro.ai/docs/nodes/video/generate-3d-scene) e [**Editar cena 3D** (Edit 3D Scene)](https://nodaro.ai/docs/nodes/video/edit-3d-scene) | Uma chave de modelo de texto. A cena é renderizada no seu servidor. |
| [**História → vídeo** (Story → Video)](https://nodaro.ai/docs/nodes/video/story-to-video) e [**Renderização 3D Pro** (3D Render Pro)](https://nodaro.ai/docs/nodes/video/pro-3d-render) | Não disponíveis em uma instalação self-hosted |

Leia [Chaves de provedor](https://nodaro.ai/docs/self-hosting/provider-keys) para ver o que cada chave habilita, e [Conectar ao Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect) para a conexão.

## Como as partes se encaixam
Um único contêiner roda o servidor web, a API e os workers. O Redis leva o trabalho entre eles, o Postgres guarda os dados, e um armazenamento compatível com S3 guarda a mídia.

Workflow: O navegador acessa a API pelo servidor web. A API coloca o trabalho na fila do Redis, e os workers o executam, chamam os provedores de modelos e salvam os resultados no armazenamento.

- Navegador → Servidor web
- Servidor web → API
- API → Redis
- API → Banco de dados
- Redis → Workers
- Workers → Armazenamento

Os workers chamam os seus provedores de modelos, ou o Nodaro Cloud, quando a instalação está conectada. Leia [Arquitetura](https://nodaro.ai/docs/self-hosting/architecture) para ver os processos, as filas e os modos de autenticação.

## O caminho por esta seção
### Instalação
  - [Início rápido](https://nodaro.ai/docs/self-hosting/quickstart): 
Dois comandos até uma Community Edition rodando e, depois, um provedor.
  
  - [Requisitos](https://nodaro.ai/docs/self-hosting/requirements): 
Docker, banco de dados, armazenamento, portas e chaves de provedor.
  
  - [Instalação](https://nodaro.ai/docs/self-hosting/install): 
A configuração completa: .env, segredos, migrações, armazenamento e primeiro login.
  
  - [Proxy reverso e HTTPS](https://nodaro.ai/docs/self-hosting/reverse-proxy): 
Sirva a instalação no seu domínio com nginx ou Caddy.
  
  - [Primeiro usuário e administrador](https://nodaro.ai/docs/self-hosting/first-admin): 
Crie a conta do primeiro usuário e promova um administrador.
  
  - [Edições e perfis de superfície](https://nodaro.ai/docs/self-hosting/editions-and-profiles): 
Mude para a Business e restrinja a interface.
  

### Configuração
  - [Configuração](https://nodaro.ai/docs/self-hosting/configuration): 
Todas as variáveis de ambiente, agrupadas, com os valores padrão.
  
  - [Chaves de provedor](https://nodaro.ai/docs/self-hosting/provider-keys): 
Cole as chaves em /setup ou defina-as no .env.
  
  - [Banco de dados](https://nodaro.ai/docs/self-hosting/database): 
A stack do Supabase incluída, um projeto gerenciado e as migrações.
  
  - [Conectar ao Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect): 
Modelos sem chaves e os nós exclusivos do Nodaro.
  
  - [MCP](https://nodaro.ai/docs/self-hosting/mcp): 
Deixe o Claude, o Cursor e outros clientes de IA usarem a sua instalação.
  
  - [Login único (SSO)](https://nodaro.ai/docs/self-hosting/sso): 
Permita que os usuários entrem com o seu próprio provedor de identidade.
  

### Operação
  - [Atualização](https://nodaro.ai/docs/self-hosting/updating): 
Tags de imagem, atualizações, versões major e reversões.
  
  - [Escalonamento](https://nodaro.ai/docs/self-hosting/scaling): 
Separe os workers e ajuste a concorrência.
  
  - [Backup e restauração](https://nodaro.ai/docs/self-hosting/backups): 
Um comando para cada operação, e o único caminho de downgrade.
  
  - [Solução de problemas](https://nodaro.ai/docs/self-hosting/troubleshooting): 
Sintomas e correções, a partir de /setup.
  

### Projeto
  - [Arquitetura](https://nodaro.ai/docs/self-hosting/architecture): 
O frontend, a API, os workers, as filas, o armazenamento e a autenticação.
  
  - [Como contribuir](https://nodaro.ai/docs/self-hosting/contributing): 
Ambiente de desenvolvimento, branches, pull requests e testes.
  
  - [Licença](https://nodaro.ai/docs/self-hosting/license): 
A Nodaro Sustainable Use License, em resumo.

## Frequently asked questions

### Posso rodar o Nodaro no meu próprio servidor?

Sim. Clone o repositório público e rode docker compose -f docker-compose.community.yml up. A stack traz o próprio banco de dados, login, armazenamento e filas, então você não precisa de nenhuma conta de nuvem para iniciá-la.

### Qual é a diferença entre as edições Community, Business e Cloud?

A Community é a edição self-hosted gratuita, sem painel de administração e sem créditos. A Business é self-hosted e acrescenta um painel de administração e o gerenciamento de usuários. A Cloud é o serviço gerenciado em app.nodaro.ai, com créditos e cobrança, e não é oferecida para self-hosting.

### Preciso de chaves de API para fazer self-hosting do Nodaro?

Não para instalá-lo e abrir a demonstração. Para gerar, adicione as suas próprias chaves de provedores de modelos na página /setup ou no .env, ou conecte a instalação a uma conta do Nodaro Cloud, que roda os modelos padrão sem chaves próprias.

### Um Nodaro self-hosted custa alguma coisa?

A Community Edition não tem créditos, taxas do Nodaro nem marca d’água. Você paga os seus provedores de modelos diretamente, ou paga em créditos o que é executado por uma conexão com o Nodaro Cloud. A licença define quem pode usá-la de graça.

### Quais recursos não estão disponíveis em uma instalação self-hosted?

O pipeline História → vídeo e o nó Renderização 3D Pro só rodam no Nodaro Cloud. Os nós exclusivos do Nodaro, como o Gerar vídeo Pro e o Modificador de voz Pro, rodam em uma instalação self-hosted por meio de uma conexão com o Nodaro Cloud.