Skip to content

Deployment on Scalingo

This guide explains how to deploy La Suite Meet on Scalingo using the Suite Numérique buildpack.

Overview

Scalingo is a Platform-as-a-Service (PaaS) that simplifies application deployment. This setup uses a custom buildpack to handle both the frontend (Vite) and backend (Django) builds, serving them through Nginx.

Prerequisites

  • A Scalingo account
  • Scalingo CLI installed (optional but recommended)
  • A PostgreSQL database addon
  • A Redis addon (for caching and sessions)

Step 1: Create Your App

Create a new app on Scalingo using scalingo cli or using the Scalingo dashboard.

Step 2: Provision Addons

Add the required PostgreSQL and Redis services.

This will set the following environment variables automatically: - SCALINGO_POSTGRESQL_URL - Database connection string - SCALINGO_REDIS_URL - Redis connection string

Step 3: Configure Environment Variables

Set the following environment variables in your Scalingo app:

Buildpack Configuration

scalingo env-set BUILDPACK_URL="https://github.com/suitenumerique/buildpack#main"
scalingo env-set LASUITE_APP_NAME="meet"
scalingo env-set LASUITE_BACKEND_DIR="."
scalingo env-set LASUITE_FRONTEND_DIR="src/frontend/"
scalingo env-set LASUITE_NGINX_DIR="."
scalingo env-set LASUITE_SCRIPT_POSTCOMPILE="bin/buildpack_postcompile.sh"
scalingo env-set LASUITE_SCRIPT_POSTFRONTEND="bin/buildpack_postfrontend.sh"

Database and Cache

scalingo env-set DATABASE_URL="\$SCALINGO_POSTGRESQL_URL"
scalingo env-set REDIS_URL="\$SCALINGO_REDIS_URL"

Django Settings

scalingo env-set DJANGO_SETTINGS_MODULE="meet.settings"
scalingo env-set DJANGO_CONFIGURATION="Production"
scalingo env-set DJANGO_SECRET_KEY="<generate-a-secure-secret-key>"
scalingo env-set DJANGO_ALLOWED_HOSTS="my-meet-app.osc-fr1.scalingo.io"

OIDC Authentication

Configure your OIDC provider (e.g., Keycloak, Authentik):

scalingo env-set OIDC_OP_JWKS_ENDPOINT="https://auth.yourdomain.com/realms/meet/protocol/openid-connect/certs"
scalingo env-set OIDC_OP_AUTHORIZATION_ENDPOINT="https://auth.yourdomain.com/realms/meet/protocol/openid-connect/auth"
scalingo env-set OIDC_OP_TOKEN_ENDPOINT="https://auth.yourdomain.com/realms/meet/protocol/openid-connect/token"
scalingo env-set OIDC_OP_USER_ENDPOINT="https://auth.yourdomain.com/realms/meet/protocol/openid-connect/userinfo"
scalingo env-set OIDC_OP_LOGOUT_ENDPOINT="https://auth.yourdomain.com/realms/meet/protocol/openid-connect/logout"
scalingo env-set OIDC_RP_CLIENT_ID="meet"
scalingo env-set OIDC_RP_CLIENT_SECRET="<your-client-secret>"
scalingo env-set OIDC_RP_SIGN_ALGO="RS256"

LiveKit Configuration

Meet requires a LiveKit server for video conferencing:

scalingo env-set LIVEKIT_API_URL="https://livekit.yourdomain.com"
scalingo env-set LIVEKIT_API_KEY="<your-livekit-api-key>"
scalingo env-set LIVEKIT_API_SECRET="<your-livekit-api-secret>"

Email Configuration (Optional)

For email notifications see https://doc.scalingo.com/platform/app/sending-emails:

scalingo env-set DJANGO_EMAIL_HOST="smtp.example.org"
scalingo env-set DJANGO_EMAIL_PORT="587"
scalingo env-set DJANGO_EMAIL_HOST_USER="<smtp-user>"
scalingo env-set DJANGO_EMAIL_HOST_PASSWORD="<smtp-password>"
scalingo env-set DJANGO_EMAIL_USE_TLS="True"
scalingo env-set DJANGO_EMAIL_FROM="meet@yourdomain.com"

Step 4: Deploy

Deploy your application:

git push scalingo main

The Procfile will automatically: 1. Build the frontend (Vite) 2. Build the backend (Django) 3. Run the post-compile script (cleanup) 4. Run the post-frontend script (move assets and prepare for deployment) 5. Start Nginx and Gunicorn 6. Run django migrations

Step 5: Create superuser

After the first deployment, create an admin user:

scalingo run python manage.py createsuperuser

Custom Domain (Optional)

To use a custom domain:

  1. Add the domain in Scalingo dashboard
  2. Update DJANGO_ALLOWED_HOSTS with your custom domain
  3. Configure your DNS to point to Scalingo
scalingo domains-add meet.yourdomain.com
scalingo env-set DJANGO_ALLOWED_HOSTS="meet.yourdomain.com,my-meet-app.osc-fr1.scalingo.io"

Custom Logo (Optional)

To use a custom logo, set the CUSTOM_LOGO_URL environment variable with an HTTPS URL pointing to an SVG item (max 5MB):

scalingo env-set CUSTOM_LOGO_URL="https://cdn.yourdomain.com/logo.svg"

Troubleshooting

Check Logs

scalingo logs --tail

Common Issues

  1. Build fails: Check that all required environment variables are set
  2. Database connection error: Verify DATABASE_URL is correctly set to $SCALINGO_POSTGRESQL_URL
  3. Static files not served: Ensure the buildpack post-frontend script ran successfully
  4. OIDC errors: Verify your OIDC provider configuration and callback URLs

Useful Commands

# Open a console
scalingo run bash

# Restart the app
scalingo restart

# Scale containers
scalingo scale web:2

# One-off command
scalingo run python manage.py shell

Architecture

On Scalingo, the application runs as follows:

  1. Build Phase: The buildpack compiles both frontend and backend
  2. Runtime:
  3. Nginx serves static files and proxies to the backend
  4. Gunicorn runs the Django WSGI application
  5. Both processes are managed by the bin/buildpack_start.sh script

Additional Resources