Logo

Variáveis de Ambiente

Referência completa de todas as variáveis de ambiente suportadas pelo LIP.

Aplicação

NODE_ENV

Ambiente de execução da aplicação.

Valores: development, staging, production, test

Padrão: development

APP_NAME

Nome da aplicação.

APP_URL

URL base da aplicação.

APP_PORT

Porta do servidor.

Padrão: 3000

APP_HOST

Host do servidor.

Padrão: localhost

Banco de Dados

DATABASE_URL

URL de conexão do banco de dados.

DATABASE_TYPE

Tipo do banco de dados.

Valores: postgres, mysql, mongodb, sqlite

DATABASE_HOST

Host do banco de dados.

DATABASE_PORT

Porta do banco de dados.

DATABASE_NAME

Nome do banco de dados.

DATABASE_USER

Usuário do banco de dados.

DATABASE_PASSWORD

Senha do banco de dados.

DATABASE_SSL

Habilitar conexão SSL.

Valores: true, false

DATABASE_POOL_MIN

Número mínimo de conexões no pool.

Padrão: 2

DATABASE_POOL_MAX

Número máximo de conexões no pool.

Padrão: 10

Redis

REDIS_HOST

Host do Redis.

REDIS_PORT

Porta do Redis.

Padrão: 6379

REDIS_PASSWORD

Senha do Redis.

REDIS_DB

Índice do banco de dados Redis.

Padrão: 0

REDIS_URL

URL completa de conexão do Redis.

Autenticação

JWT_SECRET

Secret para assinatura de tokens JWT.

⚠️ OBRIGATÓRIO EM PRODUÇÃO

JWT_EXPIRES_IN

Tempo de expiração do token JWT.

Padrão: 7d

Formatos: 60s, 5m, 2h, 7d

JWT_ALGORITHM

Algoritmo de assinatura JWT.

Valores: HS256, HS384, HS512, RS256

Padrão: HS256

SESSION_SECRET

Secret para sessões.

SESSION_MAX_AGE

Duração máxima da sessão em milissegundos.

Padrão: 604800000 (7 dias)

Email

SMTP_HOST

Host do servidor SMTP.

SMTP_PORT

Porta do servidor SMTP.

Padrão: 587

SMTP_SECURE

Usar TLS/SSL.

Valores: true, false

SMTP_USER

Usuário do SMTP.

SMTP_PASS

Senha do SMTP.

EMAIL_FROM_NAME

Nome do remetente padrão.

EMAIL_FROM_ADDRESS

Email do remetente padrão.

Storage

STORAGE_DRIVER

Driver de armazenamento.

Valores: local, s3, gcs, azure

Padrão: local

STORAGE_PATH

Caminho local para armazenamento.

Padrão: ./uploads

S3_BUCKET

Nome do bucket S3.

S3_REGION

Região do bucket S3.

AWS_ACCESS_KEY_ID

Access Key da AWS.

AWS_SECRET_ACCESS_KEY

Secret Access Key da AWS.

S3_ENDPOINT

Endpoint customizado do S3 (para S3-compatible services).

Logs

LOG_LEVEL

Nível de log.

Valores: error, warn, info, debug, trace

Padrão: info

LOG_FORMAT

Formato do log.

Valores: json, pretty, simple

Padrão: json

LOG_FILE

Arquivo de log.

Segurança

CORS_ORIGIN

Origens permitidas para CORS.

CORS_CREDENTIALS

Permitir credenciais em requisições CORS.

Valores: true, false

RATE_LIMIT_WINDOW

Janela de tempo para rate limiting (em milissegundos).

Padrão: 900000 (15 minutos)

RATE_LIMIT_MAX

Número máximo de requisições por janela.

Padrão: 100

ALLOWED_HOSTS

Hosts permitidos (separados por vírgula).

API Externa

API_KEY

Chave de API para serviços externos.

STRIPE_PUBLIC_KEY

Chave pública do Stripe.

STRIPE_SECRET_KEY

Chave secreta do Stripe.

GOOGLE_CLIENT_ID

Client ID do Google OAuth.

GOOGLE_CLIENT_SECRET

Client Secret do Google OAuth.

Monitoramento

SENTRY_DSN

DSN do Sentry para tracking de erros.

DATADOG_API_KEY

API Key do Datadog.

NEW_RELIC_LICENSE_KEY

License Key do New Relic.

Cache

CACHE_DRIVER

Driver de cache.

Valores: memory, redis, file

Padrão: memory

CACHE_TTL

Tempo padrão de vida do cache (em segundos).

Padrão: 3600 (1 hora)

CACHE_PREFIX

Prefixo para chaves de cache.

Queue

QUEUE_DRIVER

Driver da fila.

Valores: sync, redis, database, sqs

Padrão: sync

QUEUE_CONNECTION

Nome da conexão da fila.

Desenvolvimento

DEBUG

Habilitar modo debug.

Valores: true, false, *, lip:*

HOT_RELOAD

Habilitar hot reload.

Valores: true, false

Padrão: true em desenvolvimento

MOCK_EXTERNAL_APIS

Mockar APIs externas em desenvolvimento.

Valores: true, false

Exemplo Completo

Desenvolvimento

Produção

Validação

Use a ferramenta de validação para verificar suas variáveis:

Segurança

⚠️ Importante:

  • Nunca commite arquivos .env no Git
  • Use .env.example como template
  • Gere secrets fortes: openssl rand -base64 32
  • Use serviços de gerenciamento de secrets em produção
  • Rotacione secrets regularmente

Próximos Passos

Última atualização

26 de novembro de 2025