This repository contains all the necessary information and files to self-host your own instance of Rallly. Rallly is an open-source scheduling and collaboration tool designed to make organizing events and meetings easier.
- Requirements
- Setup Instructions
- Using a Reverse Proxy
- Configuration Options
- Update Instructions
- Links
To run this project you will need:
- Docker
- Access to an SMTP server
- x86-64 Architecture (arm64 support has been suspended)
git clone https://github.com/lukevella/rallly-selfhosted.git
cd rallly-selfhosted
In the root of this project you will find a file called config.env
. This is where you can set your environment variables to configure your instance.
Start by generating a secret key. Must be at least 32-characters long.
openssl rand -base64 32
Open config.env
and set SECRET_PASSWORD
to your secret key.
Next, set NEXT_PUBLIC_BASE_URL
. It should be the base url where this instance is accessible, including the scheme (eg. http://
or https://
), the domain name, and optionally a port. Do not use trailing slashes or URLs with paths/subfolders..
First, set SUPPORT_EMAIL
. Your users will see this as the contact email for any support issues and it will also appear as the sender of all emails.
Next, use the following environment variables to configure your SMTP server:
SMTP_HOST
- The host address of your SMTP serverSMTP_PORT
- The port of your SMTP serverSMTP_SECURE
- Set to "true" if SSL is enabled for your SMTP connectionSMTP_USER
- The username (if auth is enabled)SMTP_PWD
- The password (if auth is enabled)
The default behaviour of the app is the same as on the cloud-hosted version on rallly.co. i.e. Anyone can create polls without needing to log in. You can prevent this by setting AUTH_REQUIRED
to true
in config.env
which limits poll creation and admin access to logged in users.
Additionally, you can restrict who is able to register and log in by setting ALLOWED_EMAILS
. You can use wildcards to allow a range of email addresses.
# Example: only users matching the following patterns can register/login
ALLOWED_EMAILS="user@email.com,*@example.com,*@*.example.com"
By default the app will take you to the landing page which may not be what you want. If you want to go straight in to the app, set DISABLE_LANDING_PAGE
to true
.
You can start the server by running:
docker compose up -d
This command will:
- Create a postgres database
- Run migrations to set up the database schema
- Start the Next.js server on port 3000
By default the app will run unencrypted on port 3000. If you want to serve the app over HTTPS you will need to use a reverse proxy.
After setting up a reverse proxy be sure to change this line
- 3000:3000
to -127.0.0.1:3000:3000
indocker-compose.yml
and restart the container for it to apply changes. This prevents Rallly from being accessed remotely using HTTP on port 3000 which is a security concern.
For a full list of configuration options, check out the official self-hosting docs.
Rallly is constantly being updated but you will need to manually pull these updates and restart the server to run the latest version. You can do this by running the following commands from within this directory:
docker compose down
docker compose pull
docker compose up -d
You can pin a specific version of Rallly by changing the image
line in docker-compose.yml
:
- image: lukevella/rallly:<version>
Check the releases to see what versions are available.
We follow semver versioning so you may want to set your version to a major release (e.g. lukevella/rallly:2
) to avoid pulling in breaking changes.