Começar

Variáveis de ambiente.

As suas variáveis e as que a Rivervo define para você, produção e prévias, como substituir um valor automático e quando as mudanças passam a valer.

3 MIN DE LEITURA

Chaves, senhas e configurações da sua aplicação ficam na aba Variáveis. Elas são guardadas criptografadas e chegam à aplicação como variáveis de ambiente comuns.

Como adicionar as suas

Variáveis → Adicionar variável, digite um NOME e um valor e clique em Salvar.

  • Um nome tem letras latinas, números e _ e não começa com número. Cada nome precisa ser único.
  • Dica: cole o conteúdo de um arquivo .env num campo de nome — todas as linhas são adicionadas de uma vez.

As variáveis chegam à aplicação quando ela roda — não na etapa de build. As mudanças chegam à aplicação no próximo deploy. Depois de salvar, o painel oferece Fazer deploy agora, que refaz o deploy da versão em execução com as novas variáveis, sem um novo build.

Produção e prévias

Cada variável tem um Ambiente:

AmbientePara onde vai
Produção e préviasa aplicação no ar e todas as prévias de branches (o padrão)
Somente produçãosó a aplicação no ar — por exemplo, a chave de pagamento real
Somente préviassó as prévias de branches — por exemplo, uma chave de pagamento de teste

As prévias recebem só as variáveis definidas para elas. Uma prévia também tem a própria aba Variáveis: ali você vê o que ela recebe Da aplicação, e um valor seu com o mesmo nome toma o lugar desse valor só naquela prévia.

Definidas automaticamente

A lista Definidas automaticamente mostra o que a Rivervo fornece para a sua aplicação e mantém atualizado. Você não adiciona essas variáveis:

VariávelQuando
PORTsempre — a porta em que a aplicação escuta
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORDo projeto tem um banco PostgreSQL ou MySQL
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORDo banco é PostgreSQL
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENTo projeto tem Valkey
RIVERVO_<NAME>_URLpara cada banco de dados, Valkey e réplica de leitura do projeto, pelo nome do serviço
RIVERVO_<NAME>_URLpara cada um dos outros serviços web da aplicação — o endereço interno, por exemplo RIVERVO_API_URL=http://api:8080 (veja Comunicação entre serviços)
S3_ENDPOINT, S3_REGION, S3_BUCKET, S3_KEY, S3_SECRETo projeto tem armazenamento de objetos
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STOREuma aplicação Laravel (veja Laravel)

O primeiro banco de dados de um projeto recebe os nomes de sempre (DATABASE_URL, DB_*). Um segundo banco só adiciona a própria RIVERVO_<NAME>_URL, então nada muda sozinho — veja Bancos de dados.

Como substituir um valor automático

Uma variável sua com o mesmo nome toma o lugar da automática; o painel a marca com Seu valor está em uso. Use isso para apontar a aplicação para outro lugar, por exemplo DATABASE_URL para outro banco de dados do projeto.

PORT é a única exceção: ela é sempre gerenciada pela Rivervo.

Serviços de um projeto

Cada serviço de um projeto — workers, tarefas agendadas, outros serviços web — recebe as variáveis do projeto, inclusive o banco de dados. Um serviço também pode ter variáveis próprias, que têm prioridade sobre as do projeto. Um serviço web sempre recebe a própria APP_URL. Cada serviço de código também recebe o endereço interno de cada um dos outros serviços web como RIVERVO_<NAME>_URL; depois de adicionar ou renomear um serviço web, faça o deploy dos outros serviços de novo para que eles a recebam. Veja Serviços de um projeto.

Quem pode ver os valores

Os valores ficam visíveis para o titular da conta e para quem tem o papel de Desenvolvedor ou Administrador na aplicação. O papel de Visualizador não os vê. Veja Acesso a uma aplicação.

Ainda com dúvidas?

Fale com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte