Configuration
Ever Teams uses environment variables for all runtime configuration. The web application reads these from a .env file in the apps/web/ directory.
Getting Started
Copy the sample environment file:
cp apps/web/.env.sample apps/web/.env
Edit the .env file with your preferred settings.
Essential Configuration
API Connection
The most important setting is the connection to the Ever Gauzy API backend:
| Variable | Default | Description |
|---|---|---|
GAUZY_API_SERVER_URL | https://api.ever.team/api | Backend API URL (server-side) |
NEXT_PUBLIC_GAUZY_API_SERVER_URL | https://api.ever.team | Backend API URL (client-side) |
info
By default, Ever Teams connects to the production API at https://api.ever.team. For self-hosted setups, point these to your own Ever Gauzy API server (e.g., http://localhost:3000).
Authentication
| Variable | Default | Description |
|---|---|---|
AUTH_SECRET | ever-app-auth-secret | Secret key for NextAuth.js session signing |
danger
Always change AUTH_SECRET in production! Use a strong random string (at least 32 characters).
OAuth Configuration
Ever Teams supports social login with multiple providers:
Google OAuth
| Variable | Description |
|---|---|
NEXT_PUBLIC_GOOGLE_APP_NAME | Display name for Google sign-in |
GOOGLE_CLIENT_ID | Google OAuth Client ID |
GOOGLE_CLIENT_SECRET | Google OAuth Client Secret |
GitHub OAuth
| Variable | Description |
|---|---|
NEXT_PUBLIC_GITHUB_APP_NAME | Display name for GitHub sign-in |
GITHUB_CLIENT_ID | GitHub OAuth Client ID |
GITHUB_CLIENT_SECRET | GitHub OAuth Client Secret |
Facebook OAuth
| Variable | Description |
|---|---|
NEXT_PUBLIC_FACEBOOK_APP_NAME | Display name for Facebook sign-in |
FACEBOOK_CLIENT_ID | Facebook OAuth Client ID |
FACEBOOK_CLIENT_SECRET | Facebook OAuth Client Secret |
Twitter OAuth
| Variable | Description |
|---|---|
NEXT_PUBLIC_TWITTER_APP_NAME | Display name for Twitter sign-in |
TWITTER_CLIENT_ID | Twitter OAuth Client ID |
TWITTER_CLIENT_SECRET | Twitter OAuth Client Secret |
CAPTCHA Configuration
Ever Teams supports CAPTCHA on authentication pages:
| Variable | Description |
|---|---|
NEXT_PUBLIC_CAPTCHA_TYPE | CAPTCHA provider (recaptcha) |
NEXT_PUBLIC_CAPTCHA_SITE_KEY | Site key from your CAPTCHA provider |
CAPTCHA_SECRET_KEY | Secret key for server-side verification |
Email / SMTP Configuration
For features like invitations and email verification:
| Variable | Description |
|---|---|
SMTP_FROM_ADDRESS | Sender email address |
SMTP_HOST | SMTP server hostname |
SMTP_PORT | SMTP server port (default: 587) |
SMTP_SECURE | Use TLS (true / false) |
SMTP_USERNAME | SMTP authentication username |
SMTP_PASSWORD | SMTP authentication password |
INVITE_CALLBACK_URL | URL for team invitation links |
VERIFY_EMAIL_CALLBACK_URL | URL for email verification links |
Video Conferencing (Meet)
| Variable | Default | Description |
|---|---|---|
NEXT_PUBLIC_MEET_TYPE | jitsi | Meeting provider (jitsi or livekit) |
NEXT_PUBLIC_MEET_DOMAIN | meet.ever.team | Jitsi server domain |
LIVEKIT_API_KEY | — | LiveKit API key |
LIVEKIT_API_SECRET | — | LiveKit API secret |
NEXT_PUBLIC_LIVEKIT_URL |