Self-Hosting
Configuration Options

Environment variables

An environment variable is a dynamic value that can be set outside of an application and is used to configure or customize the behavior of an application. This page lists all environment variables supported by Rallly.

Base Configuration

These variables need to be configured for Rallly to run and function properly.

DATABASE_URLDefault: ""

Postgres database connection string

NEXT_PUBLIC_BASE_URLDefault: "http://localhost:3000"

The base url where this instance is accessible, including the scheme (eg. http:// or https://), the domain name, and optionally a port.

SECRET_PASSWORD

A random 32-character secret key used to encrypt user sessions

Email Configuration

These variables need to be configured to let Rallly send out transaction emails.

NOREPLY_EMAILDefault: ""

This email is used as the sender for all transactional emails.

SUPPORT_EMAILDefault: ""

This email will be shown as the contact email for support queries. If NOREPLY_EMAIL is not set, it will also be used as the sender for all transactional emails.

SMTP_HOSTDefault: "localhost"

The host address of your SMTP server

SMTP_PORTDefault: "25 or 465"

The port of your SMTP server

SMTP_SECUREDefault: "false"

Set to “true” if SSL is enabled for your SMTP connection

SMTP_USERDefault: ""

The username (if auth is enabled on your SMTP server)

SMTP_PWDDefault: ""

The password (if auth is enabled on your SMTP server)

SMTP_TLS_ENABLEDDefault: "false"

Enable TLS for your SMTP connection

Custom Configuration

These variables allow you to change Rallly’s default behavior.

ALLOWED_EMAILSDefault: ""

Comma separated list of email addresses that are allowed to register and login. Wildcard characters are supported. Example: *@yourcompany.com

AUTH_REQUIREDDefault: "false"

Set to true to require authentication for creating new polls and accessing admin pages

DISABLE_LANDING_PAGEDefault: "false"

Whether or not to disable the landing page