ziolko/roombelt repository overview

Roombelt is a meeting room schedule display software. This is a docker image for the self-hosted version of this product.

To get started visit product documentation:

• Setting up Roombelt Self-hosted with Google Calendar⁠
• Setting up Roombelt Self-hosted with Microsoft Office 365⁠

You can set the following environment variables:

• PORT defines a port the application will bind to.
• LICENSE_KEY is the license key you can get from the Roombelt team.
• DATABASE_URL is a database connection string. Roombelt self-hosted can run with SQLite or PosgtreSQL.
• UPDATE_DATABASE_SCHEMA - set it to true the first time application starts. This will create the database schema (tables and columns). After that set it to false.
• GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET/GOOGLE_REDIRECT_URL/GOOGLE_WEB_HOOK_URL as documented in the getting started guide.
• OFFICE365_DELEGATED_CLIENT_ID/OFFICE365_DELEGATED_TENANT_ID/OFFICE365_DELEGATED_CLIENT_SECRET/OFFICE365_DELEGATED_REDIRECT_URL as documented in the getting started guide.
• ALLOWED_EMAILS as documented in the getting started guides.
• SMTP_URI is used to send email notifications about offline devices (displays).
• EMAIL_FROM - the email address set as FROM for all email notifications.
• EMAIL_REPLY_TO - the email address set as REPLY TO for email notifications of offline devices.
• EMAIL_NO_REPLY - the email address set as REPLY TO for email notifications about issues with rooms reported by users.

Uploaded device background files are kept in /roombelt/uploads inside the docker container. You should mount a volume at this path so that uploaded files persist service restart.

We recommend pinning to a specific Roombelt version instead of using the latest docker image tag. New Roombelt versions might require a database schema update to work.