Docs do NodaroSelf-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.
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.
/setupmostra 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
.envem 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 para trocar de edição e Licença 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) e Avatar cinematográfico (Cinematic Avatar) | HEYGEN_API_KEY ou uma conexão com o Nodaro Cloud |
| Reiluminar e trocar (Relight & Switch) | BEEBLE_API_KEY ou uma conexão com o Nodaro Cloud |
| Extrair da web (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), Editar vídeo Pro (Edit Video Pro), Modificador de voz Pro (Voice Changer Pro), Análise de vídeo (Video Analysis) e Auditoria com IA (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) | Nada: elas rodam no seu servidor |
| Gerar cena 3D (Generate 3D Scene) e Editar cena 3D (Edit 3D Scene) | Uma chave de modelo de texto. A cena é renderizada no seu servidor. |
| História → vídeo (Story → Video) e Renderização 3D Pro (3D Render Pro) | Não disponíveis em uma instalação self-hosted |
Leia Chaves de provedor para ver o que cada chave habilita, e Conectar ao Nodaro Cloud 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.
Os workers chamam os seus provedores de modelos, ou o Nodaro Cloud, quando a instalação está conectada. Leia Arquitetura para ver os processos, as filas e os modos de autenticação.
O caminho por esta seção
Instalação
Início rápido
Dois comandos até uma Community Edition rodando e, depois, um provedor.
Requisitos
Docker, banco de dados, armazenamento, portas e chaves de provedor.
Instalação
A configuração completa: .env, segredos, migrações, armazenamento e primeiro login.
Proxy reverso e HTTPS
Sirva a instalação no seu domínio com nginx ou Caddy.
Primeiro usuário e administrador
Crie a conta do primeiro usuário e promova um administrador.
Edições e perfis de superfície
Mude para a Business e restrinja a interface.
Configuração
Configuração
Todas as variáveis de ambiente, agrupadas, com os valores padrão.
Chaves de provedor
Cole as chaves em /setup ou defina-as no .env.
Banco de dados
A stack do Supabase incluída, um projeto gerenciado e as migrações.
Conectar ao Nodaro Cloud
Modelos sem chaves e os nós exclusivos do Nodaro.
MCP
Deixe o Claude, o Cursor e outros clientes de IA usarem a sua instalação.
Login único (SSO)
Permita que os usuários entrem com o seu próprio provedor de identidade.
Operação
Atualização
Tags de imagem, atualizações, versões major e reversões.
Escalonamento
Separe os workers e ajuste a concorrência.
Backup e restauração
Um comando para cada operação, e o único caminho de downgrade.
Solução de problemas
Sintomas e correções, a partir de /setup.
Projeto
Arquitetura
O frontend, a API, os workers, as filas, o armazenamento e a autenticação.
Como contribuir
Ambiente de desenvolvimento, branches, pull requests e testes.
Licença
A Nodaro Sustainable Use License, em resumo.
Perguntas frequentes
Páginas relacionadas
Início rápido
Requisitos
Edições e perfis de superfície
Conectar ao Nodaro Cloud
Licença
Última atualização