Skip to main content

Configuration

Ever Teams uses environment variables for all configuration, and reads them at runtime.

  • From source: the web application reads a .env file in the apps/web/ directory.
  • From the Docker image: the container environment is read when the server starts and on every page request. Nothing deployment-specific is baked into the image, so one image serves any deployment — see Runtime Configuration.

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:

VariableDefaultDescription
GAUZY_API_SERVER_URLhttps://api.ever.team/apiBackend API URL (server-side)
NEXT_PUBLIC_GAUZY_API_SERVER_URLhttps://api.ever.teamBackend 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​

VariableDefaultDescription
AUTH_SECRETever-app-auth-secretSecret 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​

VariableDescription
NEXT_PUBLIC_GOOGLE_APP_NAMEDisplay name for Google sign-in
GOOGLE_CLIENT_IDGoogle OAuth Client ID
GOOGLE_CLIENT_SECRETGoogle OAuth Client Secret

GitHub OAuth​

VariableDescription
NEXT_PUBLIC_GITHUB_APP_NAMEDisplay name for GitHub sign-in
GITHUB_CLIENT_IDGitHub OAuth Client ID
GITHUB_CLIENT_SECRETGitHub OAuth Client Secret

Facebook OAuth​

VariableDescription
NEXT_PUBLIC_FACEBOOK_APP_NAMEDisplay name for Facebook sign-in
FACEBOOK_CLIENT_IDFacebook OAuth Client ID
FACEBOOK_CLIENT_SECRETFacebook OAuth Client Secret

Twitter OAuth​

VariableDescription
NEXT_PUBLIC_TWITTER_APP_NAMEDisplay name for Twitter sign-in
TWITTER_CLIENT_IDTwitter OAuth Client ID
TWITTER_CLIENT_SECRETTwitter OAuth Client Secret

CAPTCHA Configuration​

Ever Teams supports CAPTCHA on authentication pages:

VariableDescription
NEXT_PUBLIC_CAPTCHA_TYPECAPTCHA provider: recaptcha (default), hcaptcha or cloudflare
NEXT_PUBLIC_CAPTCHA_SITE_KEYSite key from your CAPTCHA provider
CAPTCHA_SECRET_KEYSecret key for server-side verification

Set the site key and the secret together, or leave both empty to sign up without a CAPTCHA.

Email / SMTP Configuration​

For features like invitations and email verification:

VariableDescription
SMTP_FROM_ADDRESSSender email address
SMTP_HOSTSMTP server hostname
SMTP_PORTSMTP server port (default: 587)
SMTP_SECUREUse TLS (true / false)
SMTP_USERNAMESMTP authentication username
SMTP_PASSWORDSMTP authentication password
INVITE_CALLBACK_URLURL for team invitation links
VERIFY_EMAIL_CALLBACK_URLURL for email verification links

Video Conferencing (Meet)​

VariableDefaultDescription
NEXT_PUBLIC_MEET_TYPEjitsiMeeting provider (jitsi or livekit)
NEXT_PUBLIC_MEET_DOMAINmeet.ever.teamJitsi server domain
LIVEKIT_API_KEY—LiveKit API key
LIVEKIT_API_SECRET—LiveKit API secret
NEXT_PUBLIC_LIVEKIT_URL—LiveKit server URL
MEET_JWT_APP_IDever_teamsJWT App ID for meeting authentication
MEET_JWT_APP_SECRET—JWT secret for meeting tokens

Board & Collaboration​

VariableDescription
NEXT_PUBLIC_BOARD_APP_DOMAINURL for the board application
NEXT_PUBLIC_BOARD_BACKEND_POST_URLBoard API endpoint
NEXT_PUBLIC_BOARD_FIREBASE_CONFIGFirebase configuration (JSON) for real-time board sync

Monitoring & Analytics​

Sentry (Error Tracking)​

VariableDescription
SENTRY_ORGSentry organization slug
SENTRY_PROJECTSentry project slug
SENTRY_AUTH_TOKENSentry authentication token
SENTRY_DSN / NEXT_PUBLIC_SENTRY_DSNSentry Data Source Name
NEXT_PUBLIC_SENTRY_DEBUGEnable Sentry debug mode (true/false)

PostHog (Product Analytics)​

VariableDescription
NEXT_PUBLIC_POSTHOG_KEYPostHog project API key
NEXT_PUBLIC_POSTHOG_HOSTPostHog instance URL

Jitsu (Event Tracking)​

VariableDescription
NEXT_PUBLIC_JITSU_BROWSER_URLJitsu tracking URL (client-side)
NEXT_PUBLIC_JITSU_BROWSER_WRITE_KEYJitsu write key (client-side)
JITSU_SERVER_URLJitsu URL (server-side)
JITSU_SERVER_WRITE_KEYJitsu write key (server-side)

Google Analytics​

VariableDescription
NEXT_PUBLIC_GA_MEASUREMENT_IDGoogle Analytics 4 Measurement ID

Branding & White-Labeling​

Ever Teams supports full white-label customization:

VariableDefaultDescription
APP_NAMEEver TeamsApplication display name
APP_SLOGAN_TEXTReal-Time Clarity, Real-Time Reality™.Tagline text
APP_LINKhttps://ever.teamMain website URL
APP_SIGNATUREEver TeamsEmail signature name
APP_LOGO_URLEver Teams logoLogo URL for emails
COMPANY_NAMEEver Co. LTDCompany name
COMPANY_LINKhttps://ever.coCompany website
TERMS_LINKhttps://ever.team/tosTerms of Service URL
PRIVACY_POLICY_LINKhttps://ever.team/privacyPrivacy Policy URL
MAIN_PICTURE—Auth page background (light mode)
MAIN_PICTURE_DARK—Auth page background (dark mode)

SEO Metadata​

VariableDescription
NEXT_PUBLIC_SITE_NAMESite name for meta tags
NEXT_PUBLIC_SITE_TITLEPage title
NEXT_PUBLIC_SITE_DESCRIPTIONMeta description
NEXT_PUBLIC_SITE_KEYWORDSMeta keywords (comma-separated)
NEXT_PUBLIC_WEB_APP_URLCanonical site URL
NEXT_PUBLIC_TWITTER_USERNAMETwitter handle for cards

Logging​

VariableDefaultDescription
ACTIVE_LOCAL_LOG_SYSTEMtrueEnable local file logging
LOG_FOLDER_MAX_SIZE10Max log folder size (MB)

Application Flags​

VariableDefaultDescription
NEXT_PUBLIC_DEMO—Enable demo mode restrictions
IS_DESKTOP_APP—Flag for desktop app builds
NEXT_PUBLIC_DISABLE_AUTO_REFRESHfalseDisable automatic data refresh
ANALYZEfalseEnable webpack bundle analyzer
RECOIL_DUPLICATE_ATOM_KEY_CHECKING_ENABLEDfalseEnable Recoil duplicate atom warnings

Images Configuration​

VariableDescription
NEXT_PUBLIC_IMAGES_HOSTSComma-separated list of allowed image hostnames for Next.js Image Optimization

Cookies​

VariableDefaultDescription
NEXT_PUBLIC_COOKIE_DOMAINSever.teamDomain(s) for cookie sharing

Customer Support​

VariableDescription
NEXT_PUBLIC_CHATWOOT_API_KEYChatwoot live chat API key

Email Marketing​

VariableDescription
MAILCHIMP_API_KEYMailchimp API key
MAILCHIMP_LIST_IDMailchimp list/audience ID
POSTMARK_SERVER_API_TOKENPostmark transactional email token