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.
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
.envnum 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:
| Ambiente | Para onde vai |
|---|---|
| Produção e prévias | a aplicação no ar e todas as prévias de branches (o padrão) |
| Somente produção | só a aplicação no ar — por exemplo, a chave de pagamento real |
| Somente prévias | só 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ável | Quando |
|---|---|
PORT | sempre — a porta em que a aplicação escuta |
DATABASE_URL, DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD | o projeto tem um banco PostgreSQL ou MySQL |
PGHOST, PGPORT, PGDATABASE, PGUSER, PGPASSWORD | o banco é PostgreSQL |
REDIS_URL, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_CLIENT | o projeto tem Valkey |
RIVERVO_<NAME>_URL | para cada banco de dados, Valkey e réplica de leitura do projeto, pelo nome do serviço |
RIVERVO_<NAME>_URL | para 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_SECRET | o projeto tem armazenamento de objetos |
APP_KEY, APP_ENV, APP_DEBUG, APP_URL, LOG_CHANNEL, SESSION_DRIVER, CACHE_STORE | uma 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.