Configuração
Todas as variáveis de ambiente de um Nodaro auto-hospedado, por finalidade, com o padrão, se o .env pode defini-las no Compose e o que elas mudam.
Esta página é a referência de configuração de um Nodaro auto-hospedado: todas as variáveis de ambiente que os operadores definem, agrupadas por finalidade, com o padrão de cada uma. No conjunto de serviços do Compose incluído, toda variável tem um padrão que funciona, então você só define o que quer mudar. As variáveis que só se aplicam ao Nodaro Cloud não estão listadas.
Como definir uma variável
No conjunto de serviços do Compose, você define uma variável em um destes dois lugares:
- No
.env, ao lado dodocker-compose.community.yml. Isso funciona para as variáveis que o arquivo do Compose repassa ao app. Nas tabelas abaixo, a coluna .env mostra Sim para elas. - No arquivo do Compose, para todas as outras variáveis. Adicione a variável em
environment:do serviçonodaro:
nodaro:
environment:
# ...the variables already listed...
MCP_ENABLED: "true"
MCP_PUBLIC_URL: https://mcp.nodaro.example.comDepois, aplique a alteração:
docker compose -f docker-compose.community.yml up -dO Nodaro lê o ambiente na inicialização. A única exceção são as chaves de provedor que você cola em /setup, que passam a valer na hora. Fora do conjunto de serviços do Compose, defina as variáveis nas configurações de ambiente da sua plataforma.
Obrigatórias fora do conjunto de serviços do Compose: SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY e INTERNAL_ORCHESTRATOR_SECRET. Sem elas, a API se recusa a iniciar e lista as variáveis ausentes ou inválidas.
Instância
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
EDITION | community | Não | community, business ou cloud. O arquivo do Compose a fixa em community. Veja Edições e perfis de superfície. |
PUBLIC_URL | http://localhost:3000 | Sim | A origem pública da instalação: callbacks de login e de OAuth, URLs de mídia e a verificação de CORS. |
PUBLIC_URL_SAME_ORIGIN | não definida | Não | true passa ao navegador o endereço de API / em vez de PUBLIC_URL, de modo que as transmissões ficam no nome de host que o visitante abriu. Para instalações que respondem em vários nomes de host. Só o valor exato true ativa esse comportamento. |
ROBOTS_NOINDEX | não definida | Não | true mantém a instalação inteira fora dos mecanismos de busca: toda resposta leva X-Robots-Tag: noindex, seja quem for que a sirva. Use em uma instalação que nunca deve aparecer em resultados de busca, como uma cópia de homologação. Só o valor exato true ativa esse comportamento. Reinicie para aplicar. |
LEGACY_UI_HOSTS, FLOW_UI_ORIGIN | não definidas | Não | Dão às páginas do app um nome de host próprio, enquanto a API fica em PUBLIC_URL. Só com FLOW_UI_ORIGIN, as páginas ganham um host próprio e nada é redirecionado. Com LEGACY_UI_HOSTS também, elas se mudam para lá, e ela precisa de FLOW_UI_ORIGIN. Veja Mover as páginas do app para um nome de host próprio. |
FLOW_PUBLIC_URL | não definida | Não | Outro nome de FLOW_UI_ORIGIN. Defina uma ou outra. Quando as duas estão definidas, precisam indicar a mesma origem. |
LEGACY_UI_REDIRECT_STATUS | 302 | Não | O status do redirecionamento de uma página movida: 302, nunca guardado em cache, ou 301, guardado em cache pelo navegador por uma hora. Qualquer outro valor vale como 302. |
CORS_ORIGIN | vazia | Sim | Origens extras do navegador, separadas por vírgula. PUBLIC_URL é sempre permitida. Nesses hosts, o redirecionamento do SSO para a página de destino é relativo. Com o MCP por caminho ligado, PUBLIC_URL e esses hosts são os hosts em que o MCP responde. |
DEFAULT_LOCALE | vazia (o idioma do navegador) | Sim | O idioma em que um novo visitante começa. Veja Idioma padrão. |
NODARO_SURFACE_PROFILE | vazia (a interface completa) | Sim | Restringe a interface de uma instalação Business. Veja Perfis de superfície. |
NODARO_TUTORIAL_PACKS | vazia (só os tutoriais nativos) | Sim | Diretórios de pacotes de tutoriais extras, separados por vírgula. Veja Pacotes de tutoriais. |
RUNTIME_ENV | local | Não | Dá nome à instalação quando duas instalações compartilham um banco de dados, mas não um Redis. Veja Escalonamento. No Railway, RAILWAY_ENVIRONMENT_NAME define essa variável. Um endpoint de webhook pertence à instalação que o criou, então renomear RUNTIME_ENV oculta os endpoints criados com o nome antigo. |
PORT, HOST | 8000, 0.0.0.0 | Não | Onde a API escuta. Na imagem, a API escuta na porta 9000, atrás do servidor web na 3000. |
NODE_ENV | development | Não | production em todas as imagens. |
Segredos
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
INTERNAL_ORCHESTRATOR_SECRET | Gerado na inicialização, no conjunto de serviços do Compose | Sim | Autentica o orquestrador na API. Pelo menos 32 caracteres. Obrigatório fora do conjunto de serviços do Compose. Ele também assina os registros de consentimento dos clones de voz de uso único: um novo valor invalida todos os registros emitidos antes, então defina-o explicitamente para que as vozes clonadas continuem funcionando quando um contêiner for substituído. |
NODARO_ENCRYPTION_KEY | Gerada na primeira inicialização, no conjunto de serviços do Compose, e guardada no volume app-data | Sim | Uma chave hexadecimal de 64 caracteres que criptografa as credenciais armazenadas: as chaves de provedor coladas, os tokens de login das redes sociais as credenciais HTTP salvas para o nó Saída de webhook e os segredos de assinatura dos endpoints de webhook. Sem ela, registrar um endpoint de webhook responde 503 encryption_key_missing. |
SOCIAL_ENCRYPTION_KEY | vazia | Sim | O nome antigo de NODARO_ENCRYPTION_KEY. Qualquer um dos dois funciona. |
Gere um segredo com openssl rand -hex 32. Faça backup da chave de criptografia junto com o banco de dados: veja Backup e restauração.
Banco de dados e login
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
SUPABASE_URL | http://localhost:3000/supabase no conjunto de serviços do Compose | Sim | A URL do Supabase que a API usa. Obrigatória fora do conjunto de serviços do Compose. |
SUPABASE_SERVICE_ROLE_KEY | Uma chave padrão pública, no conjunto de serviços do Compose | Sim | A chave service-role que a API usa. Obrigatória fora do conjunto de serviços do Compose. |
SUPABASE_ANON_KEY | Uma chave padrão pública, no conjunto de serviços do Compose | Sim | A chave anon entregue ao navegador e ao serviço de login. |
FRONTEND_SUPABASE_URL | PUBLIC_URL/supabase no conjunto de serviços incluído | Sim | A URL do Supabase que o navegador usa, gravada em /config.js na inicialização. Defina-a quando usar um projeto gerenciado no Supabase. |
SUPABASE_JWT_SECRET | Um segredo padrão público | Sim | O segredo que assina as chaves anon e service-role no conjunto de serviços incluído. Gere os três valores com node tools/generate-selfhost-keys.mjs. |
POSTGRES_PASSWORD | nodaro-postgres-pw | Sim | A senha do banco de dados incluído. As senhas das roles internas só a acompanham na primeira inicialização do banco de dados. |
DATABASE_URL | postgres://postgres:nodaro-postgres-pw@db:5432/postgres | Sim | Uma URL direta do Postgres, usada só para aplicar as migrações na inicialização. Mantenha a senha dela igual à de POSTGRES_PASSWORD. |
RUN_MIGRATIONS_ON_BOOT | false; true no conjunto de serviços do Compose | Sim | Aplica supabase/migrations/ antes de a API iniciar. Defina false com um projeto gerenciado no Supabase. |
SUPABASE_MANAGED_PROXY | não definida | Não | true serve um projeto gerenciado no Supabase pela própria origem do app. Veja Banco de dados. |
SUPABASE_PROXY_UPSTREAM | não definida | Não | A origem do projeto gerenciado, sem caminho, para o proxy acima. |
Filas
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
REDIS_URL | redis://localhost:6379; redis://redis:6379 no conjunto de serviços do Compose | Não | O Redis das filas e dos caches compartilhados. Uma URL de cluster ou de Sentinel também funciona. |
Armazenamento
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
R2_ENDPOINT | http://minio:9000 no conjunto de serviços do Compose | Sim | A URL da API S3 do armazenamento. No conjunto de serviços do Compose, um valor vazio volta ao MinIO. |
R2_FORCE_PATH_STYLE | true no conjunto de serviços do Compose | Sim | Endereçamento no estilo de caminho (path-style), que a maioria dos armazenamentos auto-hospedados exige. |
R2_ACCOUNT_ID | vazia | Sim | O ID da conta do Cloudflare. Fora do conjunto de serviços do Compose, o endpoint do R2 é derivado dele quando R2_ENDPOINT não está definida. |
R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY | As credenciais do MinIO incluído | Sim | As credenciais do armazenamento. No conjunto de serviços do Compose, elas também são as credenciais de superusuário do MinIO. |
R2_BUCKET_NAME | nodaro-assets no conjunto de serviços do Compose | Sim | O bucket. Fora do conjunto de serviços do Compose, o padrão é scenenode-assets, então sempre defina essa variável. |
R2_PUBLIC_URL | http://localhost:3000/storage/nodaro-assets no conjunto de serviços do Compose | Sim | A URL pública do bucket. |
R2_REGION | auto | Sim | A região S3. Defina uma região real para a AWS, o DigitalOcean Spaces (nyc3 e outras) e um Supabase local (local). |
STORAGE_OBJECT_ACL | vazia (sem cabeçalho de ACL) | Sim | Uma ACL pré-configurada em cada objeto enviado, para armazenamentos que recusam uma política de bucket. Veja Instalação. |
R2_PUBLIC_FALLBACK_DOMAIN | vazia | Não | Um segundo host público para a mídia, por exemplo o endereço r2.dev direto ao lado de um domínio de CDN. |
R2_SHARED_WITH_RELAY_TARGET | false | Não | true só quando R2_PUBLIC_URL aponta para o mesmo bucket em que o seu host do Nodaro Cloud grava. Veja Conectar ao Nodaro Cloud. |
STORAGE_DELETES | on | Sim | skip faz esta instalação não apagar nada do armazenamento. Toda exclusão é ignorada com o aviso storage deletes are off on this deployment no log, e o arquivo fica. As linhas ainda são removidas, e os links e as cotas de armazenamento são atualizados como antes. Use em uma instalação que compartilha o armazenamento de mídia com outra instalação, mas tem a sua própria cópia do banco de dados, por exemplo um ambiente de staging restaurado da produção. on, sem valor ou vazio apaga como antes. Qualquer outro valor impede a API de iniciar. Reinicie para aplicar. |
Vários nós medem a entrada antes de uma execução ser cobrada, por exemplo Cortar vídeo, Vídeo em loop, Combinar vídeos, Efeitos sonoros para vídeo, Dublagem e Sincronização labial. O servidor só lê um link de mídia de um endereço público. Um link para um endereço de loopback ou privado, ou um link que redireciona para um deles, é recusado. O seu próprio armazenamento é a exceção. Quando R2_PUBLIC_URL está em um endereço privado, como o MinIO incluído, o servidor baixa um arquivo armazenado, de até 2 GiB, e o mede no disco.
Envios grandes direto para o armazenamento
Arquivos com mais de 500 MB podem ser enviados em partes, direto do navegador para o bucket, com POST /v1/uploads/large/* (o uploads.uploadLarge do SDK). O navegador envia cada parte com um PUT para uma URL pré-assinada no endpoint S3 do armazenamento, o R2_ENDPOINT ou o endpoint R2 do R2_ACCOUNT_ID. As partes nunca passam pelo app. Arquivos menores continuam passando pelo POST /v1/upload, que não precisa de nada disso. Configure duas coisas no bucket, fora do app:
- CORS para
PUT. Permita o métodoPUTde toda origem web que envia arquivos assim: oPUBLIC_URL, cada entrada doCORS_ORIGINe qualquer outro site seu que use o SDK em um navegador. Permita o cabeçalho de requisiçãocontent-type. Nenhum cabeçalho de resposta precisa ser exposto. Sem essa regra, as partes do navegador falham na verificação prévia (preflight). Servidores, e o SDK fora de um navegador, não precisam de nada. - Uma regra de ciclo de vida que cancela envios multipart incompletos depois de 1 dia. Essa regra é obrigatória. Um navegador que sai no meio de um envio deixa partes no bucket, e nada no app as remove. As partes nunca contam no armazenamento de ninguém, mas ocupam espaço: no máximo 3 envios abertos de até 10 GiB por conta ao mesmo tempo. No Cloudflare R2, a regra fica em Settings › Object lifecycle rules › Abort incomplete multipart uploads, no bucket. O MinIO remove sozinho os envios incompletos antigos, depois de 24 horas por padrão (a configuração
stale_uploads_expiry); confira se são no máximo 1 dia. Em qualquer outro armazenamento, defina a regra equivalente.
No Cloudflare R2, a regra de CORS fica em Settings › CORS policy, no bucket, por exemplo:
[{ "AllowedOrigins": ["https://app.example.com"], "AllowedMethods": ["PUT"],
"AllowedHeaders": ["content-type"], "MaxAgeSeconds": 3600 }]No MinIO, defina o CORS do bucket, ou o MINIO_API_CORS_ALLOW_ORIGIN do servidor. O navegador também precisa alcançar o próprio endpoint S3. No MinIO incluído no conjunto de serviços do Compose, esse endpoint é interno (http://minio:9000), então um navegador não consegue enviar arquivos assim, a menos que você o exponha. Em uma instalação assim, deixe os arquivos com mais de 500 MB para clientes fora do navegador. Uma instalação que registra uma política de upload tem esse caminho fechado, e o início responde 409 large_upload_unavailable, porque a política não conseguiria ler bytes que nunca passam pelo app.
Provedores de modelos
Cada uma destas chaves também pode ser colada em /setup. Uma chave definida no ambiente tem prioridade. Veja Chaves de provedor.
| Variável | Padrão | .env | O que habilita |
|---|---|---|---|
NODARO_API_KEY | vazia | Sim | O Nodaro Cloud como provedor, com um token de API pessoal. |
KIE_API_KEY | vazia | Sim | A maior cobertura de modelos de mídia e de texto. |
KIE_API_BASE_URL | O host de API do próprio provedor | Sim | Envia o tráfego desse provedor pelo seu próprio proxy. Também redireciona o tráfego de texto do Claude e do Gemini que roda com a KIE_API_KEY. |
REPLICATE_API_TOKEN | vazia | Sim | Um catálogo alternativo, incluindo os modelos Flux 2. |
ANTHROPIC_API_KEY | vazia | Sim | O Claude, diretamente, para os nós de texto. |
GEMINI_API_KEY | vazia | Sim | O Gemini, diretamente. Veja Modelos Gemini. |
ELEVENLABS_API_KEY | vazia | Sim | Fala, vozes e dublagem. |
ELEVENLABS_BASE_URL | https://api.elevenlabs.io | Sim | Envia o tráfego da ElevenLabs pelo seu próprio proxy. |
FAL_KEY | vazia | Sim | Modelos como o Sync Lipsync v3 e o motor Gemini Omni Flash 1.2 do Estender vídeo. |
HEYGEN_API_KEY | vazia | Sim | Avatar de IA e Avatar cinematográfico. |
BEEBLE_API_KEY | vazia | Sim | Reiluminar e trocar. |
APIFY_API_TOKEN | vazia | Sim | Extrair da web e Captura de site. |
SITE_CAPTURE_ENABLED | ativada | Não | false desativa o nó Captura de site, POST /v1/site-capture e a ferramenta capture_site do MCP nesta instalação. |
HEYGEN_CATALOG_REFRESH_HOURS | 24 | Não | A frequência com que a lista compartilhada de avatares e vozes da HeyGen é atualizada. |
VOICE_LIBRARY_REFRESH_HOURS | 6 | Não | A frequência com que a instalação lê de novo a biblioteca compartilhada de vozes da ElevenLabs, para as contagens dos filtros da biblioteca. Precisa de ELEVENLABS_API_KEY. |
VOICE_PREVIEW_PROXY | não definida | Não | true serve as prévias de voz pelo seu próprio host. Veja Prévias de voz pelo seu próprio host. |
Conexão com o Nodaro Cloud
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
NODARO_CLOUD_URL | https://app.nodaro.ai | Sim | O host do Nodaro Cloud em que o botão Conectar o nodaro.ai faz o registro, e para onde vão as chamadas feitas com a NODARO_API_KEY. Mude essa variável só quando a sua instalação pertencer a uma implantação dedicada do Nodaro. Ela é lida na inicialização. |
NODARO_API_KEY e R2_SHARED_WITH_RELAY_TARGET também fazem parte da conexão. Veja Conectar ao Nodaro Cloud.
Workers e desempenho
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
MAX_CONCURRENT_NODES_PER_EXECUTION | 6, no máximo 20 | Não | Quantos nós uma execução de workflow pode executar ao mesmo tempo. |
VIDEO_WORKER_CONCURRENCY | 50 | Não | Tarefas em paralelo no worker de mídia, que passa a maior parte do tempo esperando os provedores. |
ORCHESTRATOR_CONCURRENCY | 20 | Não | Tarefas em paralelo no orquestrador. |
RENDER_WORKER_CONCURRENCY | 2, no máximo 10 | Não | Renderizações em paralelo. Cada renderização roda um Chrome sem interface. |
REMOTION_CONCURRENCY | 2 para cenas 3D; metade dos núcleos da CPU para as outras renderizações | Não | Abas do navegador por renderização. Um valor que você define vale para os dois casos. Mantenha-o baixo quando várias tarefas 3D são executadas ao mesmo tempo: cada aba WebGL acrescenta threads e conta para o limite de processos do contêiner. |
FFMPEG_CONCURRENCY | 4, no máximo 32 | Não | Processos do ffmpeg ao mesmo tempo, somando todos os nós de edição de vídeo e de áudio. |
UV_THREADPOOL_SIZE | 16 em todas as imagens | Não | O tamanho do pool de threads de worker do Node, que também executa toda consulta de DNS. O padrão do próprio Node é 4, então defina-a quando você roda o backend fora da imagem. Lida quando um processo inicia. |
RAILWAY_DEPLOYMENT_DRAINING_SECONDS | não definida | Não | Só no Railway: o tempo entre o sinal de parada e a parada forçada de um contêiner substituído. O worker de mídia drena durante esse tempo menos 5 segundos. Sem a variável, ele drena por 25 segundos. |
Leia Escalonamento antes de aumentar esses valores.
Editores
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
FREECUT_URL | vazia (o editor hospedado) | Sim | O editor de vídeo por trás de Editar no NodarCut, no canvas, e de Editar, em um resultado de vídeo de um app. off, none, false ou disabled remove a ação de todos os lugares: nenhum resultado de vídeo no canvas, em uma apresentação ou em um app publicado a oferece. |
AUDIOMASS_URL | vazia (sem editor de áudio) | Sim | O editor de áudio por trás de Editar, em um resultado de áudio. Vazia, mantém a ação, que abre um painel que explica o que definir. off remove a ação de todos os lugares. |
Veja Editores de vídeo e de áudio.
Atualizações
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
NODARO_IMAGE | ghcr.io/nodaroai/nodaro-community:latest | Sim | A imagem do app que o arquivo do Compose roda. Fixe aqui uma tag de versão. |
NODARO_UPDATE_CHECK | ativada | Não | off desliga a verificação diária de atualizações: nenhuma requisição sai da instalação. Para instalações isoladas da internet (air-gapped). |
NODARO_UPDATE_CHECK_TOKEN | vazia (anônima) | Não | Um token do GitHub para a verificação de atualizações, sem escopos. |
Veja Atualização.
MCP
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
MCP_ENABLED | desativado | Não | true ou 1 serve o endpoint MCP. |
MCP_PUBLIC_URL | vazia (o host MCP do Nodaro Cloud) | Não | O endereço público do seu host MCP. Não é necessário com o MCP por caminho. |
MCP_DYNAMIC_REGISTRATION | allowlist | Não | O registro dinâmico de clientes MCP: allowlist, open ou off. |
MCP_DCR_ALLOWLIST | 14 clientes conhecidos | Não | Os nomes de cliente que podem se registrar no modo allowlist. |
MCP_ALLOWED_CLIENT_IDS | vazia (sem lista) | Não | Os client_ids de apps de desenvolvedor, separados por vírgula, que podem usar o endpoint do MCP. Quando ela está definida, nenhum outro cliente pode usar o MCP, e o registro dinâmico fica desligado. Uma entrada malformada impede a inicialização. Veja MCP só pelo seu próprio cliente. |
MCP_ASSERTION_EXCHANGE_CLIENT_IDS | vazia (desligada) | Não | O cliente ou os clientes da lista que podem trocar uma asserção assinada pelo seu provedor de identidade por um token do MCP, sem tela de consentimento. Veja A troca de asserção. |
MCP_ASSERTION_EXCHANGE_TOKEN_TTL_SECONDS | 3600 | Não | Quanto tempo vale um token da troca de asserção, de 300 a 86400 segundos. Qualquer outro valor impede a inicialização. |
MCP_TOOLS_BUILT_ONCE | desligada | Não | Experimental. true monta as ferramentas do endpoint MCP uma vez para cada tipo de requisição e as mantém, em vez de montá-las a cada requisição. As respostas são as mesmas; uma requisição gasta menos memória e tempo. Lida na inicialização, então reinicie depois de uma mudança. |
Veja MCP.
Login e funções
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
EXTERNAL_SSO_PROVIDERS | vazia (SSO desativado) | Não | Provedores de identidade confiáveis, como JSON inline ou @/path/to/file.json. Um valor malformado interrompe a inicialização. |
EXTERNAL_SSO_LINK_EXISTING | false | Não | Se o login único (SSO) pode ser vinculado a uma conta local existente. |
PLATFORM_OWNER_EMAIL | vazia | Não | Business: a conta do proprietário, cuja função nenhum outro administrador pode alterar. |
Veja Login único (SSO) e Primeiro usuário e administrador.
Integrações
| Variável | Padrão | .env | O que faz |
|---|---|---|---|
FIGMA_PLUGIN_OAUTH_CLIENT_ID | vazia (conexão do plugin desativada) | Não | O ID do cliente do app de desenvolvedor pelo qual o plugin do Figma se conecta. |
| Variáveis das redes sociais | vazias | Não | Veja Apps das redes sociais. |
Para o plugin do Figma, registre um app de desenvolvedor na sua instalação com <PUBLIC_URL>/v1/oauth/plugin/callback como URI de redirecionamento e os escopos jobs:read, assets:read, assets:write e credits:read. Depois, defina aqui o ID do cliente dele. Quando a variável está vazia, as rotas de conexão do plugin respondem 503, e nada mais muda. Veja Apps OAuth.
Configurações fixadas na compilação
Estas configurações são fixadas quando a imagem é compilada. Altere-as em build: args: do arquivo do Compose e recompile.
| Argumento de compilação | Padrão | O que faz |
|---|---|---|
VITE_EDITION | community no arquivo do Compose | A edição que o editor mostra. A compilação recusa um valor vazio ou desconhecido. |
VITE_STUDIO_URL | https://studio.nodaro.ai | O endereço dos links Abrir no Studio. |
VITE_PERSON_URL | https://person.nodaro.ai | O endereço do cartão Abrir Person da tela inicial. |
Editores de vídeo e de áudio
Editar no NodarCut, em um resultado de vídeo no canvas, e Editar, em um resultado de vídeo de um app, abrem o editor de vídeo NodarCut. Editar, em um resultado de áudio de um app, abre o editor AudioMass. A sua mídia não vai para o servidor do editor: o app lê o arquivo do seu próprio armazenamento e o entrega ao editor dentro do navegador. A edição e a exportação acontecem ali.
- Vídeo. Com
FREECUT_URLvazia, o editor é carregado defreecut.nodaro.ai, que só permite ser incorporado a partir dehttp://localhost:3000. Em outra origem, como um endereço da LAN ou um domínio, o navegador o recusa, e o painel explica o motivo. Abra um chamado no GitHub com a URL que você serve para que ela seja permitida, ou rode o seu próprio FreeCut. O FreeCut é público, tem licença MIT e inclui um Dockerfile. Depois, definaFREECUT_URL=https://freecut.example.internal. Para remover a ação do editor de vídeo de todos os lugares, definaFREECUT_URL=off. - Áudio. Não existe um AudioMass público hospedado, então, até você configurá-lo, Editar, em um resultado de áudio, não abre nenhum editor. Ele abre um painel que explica o que definir, na aba Apresentar do editor, em uma apresentação compartilhada e em um app publicado, da mesma forma. Para remover a ação do editor de áudio de todos os lugares, defina
AUDIOMASS_URL=off(none,falseedisabledtambém funcionam). Rode a versão derivada mantida pelo Nodaro, o AudioMass, que aceita a transferência dentro do navegador que falta no AudioMass original. Depois, definaAUDIOMASS_URL=https://audiomass.example.internal.
Reinicie o conjunto de serviços depois de uma alteração. Não é preciso recompilar.
Prévias de voz pelo seu próprio host
As listas de vozes, GET /v1/voices e GET /v1/voices/library, dão o preview_url de cada voz como um endereço no armazenamento do próprio provedor de fala. Numa rede que filtra toda requisição do navegador pelo nome do host, o navegador não alcança esses endereços, e nenhum seletor de voz consegue tocar uma prévia. Defina VOICE_PREVIEW_PROXY=true, e as listas passam a dar cada prévia como um endereço no seu próprio host: /v1/voices/<voiceId>/preview?src=…&sig=…. A API busca o arquivo do provedor e o transmite ao navegador.
- O endereço é assinado. A chave da assinatura vem de
INTERNAL_ORCHESTRATOR_SECRET. A rota só busca um arquivo que as listas entregaram, para a voz com que o entregaram, e responde404para qualquer outra coisa, antes de buscar algo. - A restrição de vozes vale. Quando o perfil de superfície restringe os gêneros de voz, a rota recusa uma voz de outro gênero com
400 voice_not_available, antes de buscar algo. Veja Gêneros de voz. - Tamanho e cache. A rota só serve um arquivo
audio/*de até 4 MB. Ela guarda cada arquivo na memória por um dia, até 32 MB no total, e por isso pede cada arquivo ao provedor uma vez só. Ela responde a intervalos de bytes com206. Os navegadores guardam uma prévia por um dia. - O MCP não muda. Uma ferramenta MCP que lê as listas de vozes continua recebendo os endereços do provedor.
- Só numa origem. O endereço da prévia é um caminho, então só toca onde a API responde na mesma origem das páginas, como no contêiner padrão. Não defina a variável quando a sua API roda em outro host.
- Vozes salvas. Um personagem ou uma criatura salvos com uma voz dessas listas guardam o endereço no seu host como
voice.previewUrl. A prévia continua tocando enquanto a variável continuartrueeINTERNAL_ORCHESTRATOR_SECRETnão mudar.
Só o valor exato true ativa o recurso. Sem ela, as listas respondem como antes, e /v1/voices/<voiceId>/preview responde 404. Adicione a variável em environment: do serviço nodaro e reinicie.
Logotipos dos desenvolvedores de modelos
GET /v1/models indica o desenvolvedor de cada modelo e pode trazer o logotipo dele como logoUrl, para apps que desenham um seletor de modelos. O logotipo de uma empresa é uma marca registrada dela, por isso nenhum logotipo acompanha o Nodaro. Uma instalação publica só os logotipos que tem o direito de exibir. O logoUrl de qualquer outro desenvolvedor é null, e os apps mostram então o nome do desenvolvedor. Uma instalação que não publica nenhum logotipo não precisa de configuração.
Para publicar o logotipo de um desenvolvedor:
- Envie o arquivo para o bucket por trás de
R2_PUBLIC_URL, embrand/makers/<maker id>.svg, com o tipo de conteúdoimage/svg+xml. Use o logotipo oficial da empresa como um SVG sem scripts. Os IDs dos desenvolvedores são os valores demaker.idqueGET /v1/modelsretorna. - Declare os IDs dos desenvolvedores na configuração da instância
model_maker_logos, uma lista como["google", "openai"]. Numa instalação Business, o operador da plataforma a define comPUT /v1/admin/settings/model_maker_logose o corpo{"value": ["google", "openai"]}. Na Community Edition, que não tem painel de administração, grave a mesma configuração da instância diretamente no banco de dados.
- O servidor verifica o arquivo primeiro. Um desenvolvedor declarado só recebe um
logoUrlquando o arquivo dele está no bucket como SVG, então as duas etapas podem vir em qualquer ordem. Um arquivo ausente ou com o tipo errado geranull, nunca um endereço quebrado. - Nunca abra o endereço num navegador para testar um envio. A CDN, e o Caddy no conjunto de serviços incluído, guardam uma resposta “não encontrado” por um ano. Verifique o arquivo no console do armazenamento ou com uma requisição
HEAD, comocurl -I. - Prazo. Um logotipo novo aparece em cerca de dez minutos. Para substituir um logotipo, envie o arquivo novo por cima do antigo: o endereço muda com o arquivo. Para retirar um, remova o ID dele da configuração ou exclua o arquivo.
- O Nodaro nunca exclui esses arquivos. Remova um logotipo pelo console do armazenamento quando quiser.
Idioma padrão
DEFAULT_LOCALE define o idioma em que um novo visitante começa. Os valores são he, ar, de, fr, es, hi, ja, ko, pt-BR, ru, zh-CN e en. A escolha que o próprio usuário salvou sempre prevalece. Um valor vazio, em branco ou desconhecido volta ao idioma do navegador do visitante. Reinicie para aplicar. Veja Idiomas.
Pacotes de tutoriais
Uma instalação auto-hospedada pode adicionar os próprios tutoriais ao conjunto nativo, sem recompilar. Cada pacote é um diretório:
manifest.json— onamedo pacote e ascategoriesque os tutoriais dele usam, cada uma com umslug, umnamee, opcionalmente, umsortOrdere umadescription. Chaves opcionais:locale,version,forbiddenPromptTermsecreatorDisplayName, o nome do autor mostrado em todos os cartões do pacote.- Um arquivo
*.jsonpor tutorial — um instantâneo de workflow com os nós, as conexões e os resultados já prontos, para que um clone abra mostrando a execução concluída. Dados opcionais do cartão:estimatedCredits, os créditos de uma execução, eestimatedPerMinuteCredits, para um tutorial cujo preço acompanha a duração da gravação que ele recebe. Esse tutorial defineestimatedCreditscomo a parte fixa eestimatedPerMinuteCreditscomo os créditos por minuto da gravação. Também opcionais:nodeTypesUsedeprovidersUsed, para os chips do cartão, umcreatorDisplayNamepor tutorial elistedIn.listedIné["tutorial"]para a aba Tutoriais, o padrão, ou["marketplace"]para o marketplace de templates. Ele só vale no primeiro seed.
Toda mídia que um tutorial usa precisa ser uma URL https:// pública. A categoria de cada tutorial precisa ser declarada no manifesto, e ela é criada na primeira inicialização.
Monte os diretórios dos pacotes no contêiner como somente leitura e liste os caminhos deles dentro do contêiner:
nodaro:
volumes:
- ./tutorials/acme:/data/tutorials/acme:roNODARO_TUTORIAL_PACKS=/data/tutorials/acmeOs pacotes só adicionam tutoriais; eles nunca mudam os nativos. Um pacote que falha na validação é ignorado por inteiro e anotado no registro. A validação falha com um JSON inválido, uma categoria não declarada, uma URL de mídia que não é pública ou um slug que colide com um tutorial existente. Reinicie o contêiner para carregar um pacote alterado.
Apps das redes sociais
A publicação em redes sociais funciona por rede. Uma rede fica disponível assim que as credenciais do app OAuth dela são definidas. Sem elas, a rede continua aparecendo em Configurações › Integrações como indisponível, com os nomes das variáveis que faltam.
| Rede | Variáveis |
|---|---|
META_APP_ID, META_APP_SECRET. Opcional: META_INSTAGRAM_CONFIG_ID, para o Facebook Login for Business. | |
| Instagram, sem uma Página do Facebook | INSTAGRAM_APP_ID, INSTAGRAM_APP_SECRET. A Meta emite essas credenciais separadamente do app do Facebook. Os tokens se renovam sozinhos, a cada cerca de 60 dias. |
META_APP_ID, META_APP_SECRET. Opcional: META_FACEBOOK_CONFIG_ID. | |
| TikTok | TIKTOK_CLIENT_KEY, TIKTOK_CLIENT_SECRET |
| YouTube | GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET |
LINKEDIN_CLIENT_ID, LINKEDIN_CLIENT_SECRET | |
| X | X_CLIENT_ID, X_CLIENT_SECRET |
REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET | |
PINTEREST_CLIENT_ID, PINTEREST_CLIENT_SECRET | |
| Discord | DISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET, DISCORD_BOT_TOKEN |
| Twitch | TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET |
| Threads | THREADS_APP_ID, THREADS_APP_SECRET |
| Mastodon | MASTODON_CLIENT_ID, MASTODON_CLIENT_SECRET. Opcional: MASTODON_URL, com o padrão mastodon.social. |
| Telegram | Nenhuma: os usuários colam o próprio token de bot. |
| Bluesky | Nenhuma: os usuários se conectam com um handle e uma senha de app. |
| Dev.to, Hashnode, Medium | Nenhuma: os usuários se conectam com a própria chave de API ou o próprio token. |
| WordPress | Nenhuma: os usuários se conectam com a URL do site e uma senha de aplicativo. |
| Lemmy | Nenhuma: os usuários se conectam com uma instância, um login e uma comunidade. |
Todo app OAuth precisa permitir a URI de redirecionamento https://<your-domain>/v1/social/callback/<network>. Quando um login do Facebook ou do Instagram gerencia mais de uma Página ou conta, a janela de conexão pergunta ao usuário qual delas conectar. Veja Publicar nas redes sociais.
Perguntas frequentes
Por que uma variável no meu arquivo .env não tem efeito?
O arquivo do Compose só repassa ao app as variáveis listadas no bloco environment do serviço nodaro. Adicione qualquer outra variável a esse bloco no docker-compose.community.yml e depois rode docker compose up -d.
Quais variáveis de ambiente são obrigatórias?
Nenhuma no conjunto de serviços do Compose incluído, que as define ou as gera. Fora dele, a API se recusa a iniciar sem SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY e um INTERNAL_ORCHESTRATOR_SECRET de pelo menos 32 caracteres.
Preciso reiniciar depois de alterar uma variável?
Sim. O Nodaro lê o ambiente na inicialização, então rode docker compose up -d para recriar o contêiner com os novos valores. As chaves de provedor coladas em /setup são a exceção e passam a valer sem reinicialização.
Como mudo o idioma padrão da minha instalação?
Defina DEFAULT_LOCALE, por exemplo DEFAULT_LOCALE=de, e reinicie. Um novo visitante começa nesse idioma. A escolha que o próprio usuário salvou sempre prevalece, e um valor desconhecido volta ao idioma do navegador.
Como adiciono os meus próprios tutoriais a uma instalação auto-hospedada?
Coloque cada pacote de tutoriais em um diretório com um manifest.json e um arquivo JSON por tutorial, monte-o no contêiner e liste os diretórios em NODARO_TUTORIAL_PACKS. Reinicie para carregá-los.
Páginas relacionadas
Instalação
Chaves de provedor
Edições e perfis de superfície
Banco de dados
Solução de problemas
Última atualização
Edições e perfis de superfície
Compare as edições Community, Business e Cloud, mude um Nodaro auto-hospedado para a Business e restrinja a interface dele com um NODARO_SURFACE_PROFILE.
Chaves de provedor
Adicione as chaves de provedor do Nodaro auto-hospedado em /setup ou no .env, veja qual chave habilita quais nós e passe o tráfego pelo seu próprio proxy.