Docs do NodaroInício rápido
Inicie a Community Edition self-hosted do Nodaro com dois comandos, verifique-a em /setup e adicione uma chave de provedor ou o Nodaro Cloud para gerar.
O início rápido da Community Edition leva você do zero a um Nodaro self-hosted em funcionamento com dois comandos. A stack do Docker Compose traz o próprio banco de dados, login, armazenamento e filas, então não há contas de nuvem para criar, chaves de API para encontrar nem nada para configurar. Você precisa do Docker 24 ou mais recente, com o Docker Compose v2.
Iniciar o Nodaro
Clonar o repositório e iniciar a stack
git clone https://github.com/nodaroai/app.nodaro.ai.git nodaro
cd nodaro
docker compose -f docker-compose.community.yml upA primeira inicialização baixa a imagem pré-compilada do app, de cerca de 2,4 GB, e os serviços incluídos. É um download, não uma compilação, então não sobrecarrega a sua CPU. As inicializações seguintes levam segundos.
Abrir o app e criar a sua conta
Abra http://localhost:3000 e crie uma conta com qualquer endereço de e-mail e senha. A conta funciona na hora, porque uma stack local não envia e-mail de confirmação.
Na sua primeira visita, a tela inicial adiciona um workflow Welcome Demo. Ele é uma execução já concluída de roteiro, imagem, vídeo, voz e corte final, com todos os resultados prontos. Você pode abrir os nós dele e reproduzir o clipe final antes de configurar qualquer coisa.
Verificar a instalação em /setup
Abra http://localhost:3000/setup. A página mostra o status em tempo real do banco de dados, do Redis, do armazenamento, da chave de criptografia e das suas chaves de provedor, e não exige login. Em uma stack nova, todos os cartões ficam verdes, exceto o das chaves de provedor.
Adicionar um provedor de modelos
Escolha uma das três formas abaixo. Quando houver um provedor, clique em Executar no nó Imagem da cena (Scene Image) da demonstração. Ele usa o Z-Image, o modelo de imagem mais barato, e responde em segundos.
O que é iniciado
| Serviço | O que faz | Onde ficam os dados |
|---|---|---|
| Postgres (imagem do Supabase) | O banco de dados. As migrações são aplicadas sozinhas na primeira inicialização. | Volume db-data |
| GoTrue | Login com e-mail e senha. Não é preciso um servidor de e-mail. | — |
| PostgREST | A API de dados com que o editor se comunica | — |
| MinIO | Armazenamento de mídia. As imagens, os vídeos e os áudios gerados ficam no seu disco. | Volume minio-data |
| Redis | Filas de jobs | Volume redis-data |
| Nodaro | O app: editor, API e workers, na porta 3000 | Volume app-data |
A stack publica duas portas na sua máquina: a 3000, para o app, e a 9001, para o console do MinIO, esta só na interface de loopback.
Adicionar um provedor de modelos
Ver a demonstração é gratuito e funciona offline. Para você mesmo executar nós, a instalação precisa de um provedor de modelos. Até ter um, a tela inicial mostra o aviso Esta instalação ainda não consegue gerar, que pode ser dispensado, com um botão para cada opção.
As três formas podem funcionar lado a lado, com uma regra. Quando a instalação está conectada ao Nodaro Cloud e também tem uma NODARO_API_KEY, ela usa a conexão e ignora a chave.
Sem arquivos e sem reinicialização.
- Abra
/setupe conclua a etapa 1, Crie seu login do servidor. Os cartões de integridade não exigem login, mas salvar uma chave exige. - Encontre os blocos dos provedores na seção Integridade da instalação. Os mesmos blocos ficam no app, em Integrações › Provedores de modelos.
- Clique em Colar chave em um bloco, cole a chave e salve.
Cada bloco diz o que a chave dele habilita e onde conseguir uma. A chave é armazenada criptografada no seu próprio banco de dados e passa a valer na hora. Se você se conectar ao Nodaro Cloud, nenhum bloco é obrigatório: a conexão cobre todos eles.
Sem chaves para gerenciar.
- Em
/setup, na etapa 2, Conecte um provedor de modelos, clique em Conectar o nodaro.ai. - O navegador abre a tela de consentimento do Nodaro Cloud. Faça login, ou crie uma conta gratuita com 1.500 créditos, e aprove.
- Você volta para a sua instalação, já conectada.
Os modelos de imagem, vídeo, fala e texto passam, então, a ser executados pela sua conta do Nodaro Cloud e são cobrados em créditos. Leia Conectar ao Nodaro Cloud para ver os detalhes.
Para infraestrutura como código. Crie um arquivo chamado .env ao lado do arquivo do Compose:
KIE_API_KEY=... # broadest model coverage
# or
REPLICATE_API_TOKEN=...
# or
NODARO_API_KEY=... # a personal API token from app.nodaro.ai, Settings › API TokensDepois, aplique-o:
docker compose -f docker-compose.community.yml up -dUma chave no .env tem prioridade sobre uma chave colada na tela. O bloco dela mostra set (env) e não pode ser editado ali mesmo.
Leia Chaves de provedor para ver todos os provedores e o que cada um habilita.
Você paga os seus provedores diretamente. A Community Edition não tem sistema de créditos, taxas do Nodaro nem marca d’água.
Aprender o editor de graça
Os Tutoriais da tela inicial começam com um conjunto de guias passo a passo, adicionados na primeira inicialização. Navegar por eles não custa nada. As imagens, os vídeos e os áudios deles são carregados da CDN do Nodaro, então eles precisam de conexão com a internet. Veja Tutoriais e templates.
Verificar a instalação pela linha de comando
Para uma verificação mais profunda do que a /setup consegue mostrar, rode o teste de contrato a partir do seu clone. Ele precisa do Node.js.
node tools/community-smoke.mjs http://localhost:3000O teste cria uma conta descartável, cria um workflow, envia uma geração, acompanha o job até o estado final e informa quais verificações passaram. Uma verificação que não se aplica à sua instalação, por exemplo porque você já adicionou uma chave de provedor, é informada como ignorada. Sem flags extras, o teste nunca gasta nada.
Para testar também uma geração real, adicione --keyed:
node tools/community-smoke.mjs http://localhost:3000 --keyedO --keyed precisa de uma KIE_API_KEY ou de um REPLICATE_API_TOKEN na instalação, no .env ou colados em /setup. Ele executa uma geração no modelo mais barato para essa chave: o Z-Image com a KIE_API_KEY e o Flux 2 Klein com o REPLICATE_API_TOKEN. Isso costuma custar menos de um centavo de dólar no provedor. Depois, o teste verifica se a mídia chegou ao armazenamento da própria instalação. Uma conexão ou um token do Nodaro Cloud é verificado separadamente.
Comandos do dia a dia
| Tarefa | Comando |
|---|---|
| Iniciar em segundo plano | docker compose -f docker-compose.community.yml up -d |
| Acompanhar os logs | docker compose -f docker-compose.community.yml logs -f |
| Parar a stack | docker compose -f docker-compose.community.yml down |
Aplicar um .env alterado | docker compose -f docker-compose.community.yml up -d |
Nunca adicione -v ao down, a menos que seja essa a intenção: docker compose down -v apaga os volumes e, com eles, o seu banco de dados e a sua mídia.
Antes que outras pessoas possam acessar a instalação
Os padrões do Compose foram feitos para uso local e são públicos. Antes de expor a stack a uma rede, gere novas chaves de autenticação, defina novas senhas para o banco de dados e o armazenamento e sirva a instalação por HTTPS. Siga Proteger a instalação e Proxy reverso e HTTPS.
Próximos passos
- Instalação — a configuração completa, com serviços gerenciados, armazenamento e segredos.
- Proxy reverso e HTTPS — sirva a instalação no seu domínio.
- Atualização — tags de imagem e atualizações.
- Backup e restauração — um comando para cada operação.
- Solução de problemas — quando um cartão em
/setupestá vermelho.
Perguntas frequentes
Páginas relacionadas
Instalação
Chaves de provedor
Conectar ao Nodaro Cloud
Proxy reverso e HTTPS
Solução de problemas
Última atualização
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.
Requisitos
O que o Nodaro self-hosted exige: Docker 24+ com Compose v2, banco Supabase, armazenamento compatível com S3, portas e chave de provedor ou o Nodaro Cloud.