Open source video conferencing app powered by LiveKit. Built with Django and React.
📝(doc) format env variable table with even column widths
lebaudantoinee692a0cf8a44
diff --git a/docs/installation.md b/docs/installation.mdindex 51cc7569..955d8b46 100644--- a/docs/installation.md+++ b/docs/installation.md@@ -249,115 +249,115 @@ You can use Visio on https://meet.127.0.0.1.nip.io from the local device. The prThese are the environmental options available on meet backend.-| Option | Description | default |-| ----------------------------------------------- | ---------------------------------------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------|-| DATA_DIR | Data directory location | /data |-| DJANGO_ALLOWED_HOSTS | Hosts that are allowed | [] |-| DJANGO_SECRET_KEY | Secret key used for Django security | |-| DJANGO_SILENCED_SYSTEM_CHECKS | Silence Django system checks | [] |-| DJANGO_ALLOW_UNSECURE_USER_LISTING | Allow unsecure user listing | false |-| DB_ENGINE | Database engine used | django.db.backends.postgresql_psycopg2 |-| DB_NAME | Name of the database | meet |-| DB_USER | User used to connect to database | dinum |-| DB_PASSWORD | Password used to connect to the database | pass |-| DB_HOST | Hostname of the database | localhost |-| DB_PORT | Port to connect to database | 5432 |-| STORAGES_STATICFILES_BACKEND | Static file serving engine | whitenoise.storage.CompressedManifestStaticFilesStorage |-| AWS_S3_ENDPOINT_URL | S3 host endpoint | |-| AWS_S3_ACCESS_KEY_ID | S3 access key | |-| AWS_S3_SECRET_ACCESS_KEY | S3 secret key | |-| AWS_S3_REGION_NAME | S3 region | |-| AWS_STORAGE_BUCKET_NAME | S3 bucket name | meet-media-storage |-| DJANGO_LANGUAGE_CODE | Default language | en-us |-| REDIS_URL | Redis endpoint | redis://redis:6379/1 |-| SESSION_COOKIE_AGE | Session cookie expiration in seconds | 43200 (12 hours) |-| REQUEST_ENTRY_THROTTLE_RATES | Entry request throttle rates | 150/minute |-| CREATION_CALLBACK_THROTTLE_RATES | Creation callback throttle rates | 600/minute |-| SPECTACULAR_SETTINGS_ENABLE_DJANGO_DEPLOY_CHECK | Enable Django deploy check | false |-| CSRF_TRUSTED_ORIGINS | CSRF trusted origins list | [] |-| FRONTEND_CUSTOM_CSS_URL | URL of an additional CSS file to load in the frontend app. If set, a `<link>` tag with this URL as href is added to the `<head>` of the frontend app | |-| FRONTEND_ANALYTICS | Analytics information | {} |-| FRONTEND_SUPPORT | Crisp frontend support configuration | {} |-| FRONTEND_SILENCE_LIVEKIT_DEBUG | Silence LiveKit debug logs | false |-| FRONTEND_IS_SILENT_LOGIN_ENABLED | Enable silent login feature | true |-| FRONTEND_FEEDBACK | Frontend feedback configuration | {} |-| FRONTEND_USE_FRENCH_GOV_FOOTER | Show the French government footer in the homepage | false |-| FRONTEND_USE_PROCONNECT_BUTTON | Show a "Login with ProConnect" button in the homepage instead of a "Login" button | false |-| DJANGO_EMAIL_BACKEND | Email backend library | django.core.mail.backends.smtp.EmailBackend |-| DJANGO_EMAIL_HOST | Host of the email server | |-| DJANGO_EMAIL_HOST_USER | User to connect to the email server | |-| DJANGO_EMAIL_HOST_PASSWORD | Password to connect to the email server | |-| DJANGO_EMAIL_PORT | Port to connect to the email server | |-| DJANGO_EMAIL_USE_TLS | Enable TLS on email connection | false |-| DJANGO_EMAIL_USE_SSL | Enable SSL on email connection | false |-| DJANGO_EMAIL_FROM | Email from account | [email protected] |-| EMAIL_BRAND_NAME | Email branding name | |-| EMAIL_SUPPORT_EMAIL | Support email address | |-| EMAIL_LOGO_IMG | Email logo image | |-| EMAIL_DOMAIN | Email domain | |-| EMAIL_APP_BASE_URL | Email app base URL | |-| DJANGO_CORS_ALLOW_ALL_ORIGINS | Allow all CORS origins | false |-| DJANGO_CORS_ALLOWED_ORIGINS | Origins to allow (string list) | [] |-| DJANGO_CORS_ALLOWED_ORIGIN_REGEXES | Origins to allow (regex patterns) | [] |-| SENTRY_DSN | Sentry server DSN | |-| DJANGO_CELERY_BROKER_URL | Celery broker host | redis://redis:6379/0 |-| DJANGO_CELERY_BROKER_TRANSPORT_OPTIONS | Celery broker options | {} |-| OIDC_CREATE_USER | Create OIDC user if not exists | true |-| OIDC_VERIFY_SSL | Verify SSL for OIDC | true |-| OIDC_FALLBACK_TO_EMAIL_FOR_IDENTIFICATION | Fallback to email for identification | false |-| OIDC_RP_SIGN_ALGO | Token verification algorithm used by OIDC | RS256 |-| OIDC_RP_CLIENT_ID | OIDC client ID | meet |-| OIDC_RP_CLIENT_SECRET | OIDC client secret | |-| OIDC_OP_JWKS_ENDPOINT | OIDC endpoint for JWKS | |-| OIDC_OP_AUTHORIZATION_ENDPOINT | OIDC endpoint for authorization | |-| OIDC_OP_TOKEN_ENDPOINT | OIDC endpoint for token | |-| OIDC_OP_USER_ENDPOINT | OIDC endpoint for user | |-| OIDC_OP_USER_ENDPOINT_FORMAT | OIDC endpoint format (AUTO, JWT, JSON) | AUTO |-| OIDC_OP_LOGOUT_ENDPOINT | OIDC endpoint for logout | |-| OIDC_AUTH_REQUEST_EXTRA_PARAMS | Extra parameters for OIDC request | {} |-| OIDC_RP_SCOPES | OIDC scopes | openid email |-| OIDC_USE_NONCE | Use nonce for OIDC | true |-| OIDC_REDIRECT_REQUIRE_HTTPS | Require HTTPS for OIDC | false |-| OIDC_REDIRECT_ALLOWED_HOSTS | Allowed redirect hosts for OIDC | [] |-| OIDC_STORE_ID_TOKEN | Store OIDC ID token | true |-| OIDC_REDIRECT_FIELD_NAME | Redirect field for OIDC | returnTo |-| OIDC_USERINFO_FULLNAME_FIELDS | Full name claim from OIDC token | ["given_name", "usual_name"] |-| OIDC_USERINFO_SHORTNAME_FIELD | Short name claim from OIDC token | given_name |-| OIDC_USERINFO_ESSENTIAL_CLAIMS | Required claims from OIDC token | [] |-| LOGIN_REDIRECT_URL | Login redirect URL | |-| LOGIN_REDIRECT_URL_FAILURE | Login redirect URL for failure | |-| LOGOUT_REDIRECT_URL | URL to redirect to on logout | |-| ALLOW_LOGOUT_GET_METHOD | Allow logout through GET method | true |-| LIVEKIT_API_KEY | LiveKit API key | |-| LIVEKIT_API_SECRET | LiveKit API secret | |-| LIVEKIT_API_URL | LiveKit API URL | |-| LIVEKIT_VERIFY_SSL | Verify SSL for LiveKit connections | true |-| RESOURCE_DEFAULT_ACCESS_LEVEL | Default resource access level for rooms | public |-| ALLOW_UNREGISTERED_ROOMS | Allow usage of unregistered rooms | true |-| RECORDING_ENABLE | Record meeting option | false |-| RECORDING_OUTPUT_FOLDER | Folder to store meetings | recordings |-| RECORDING_WORKER_CLASSES | Worker classes for recording | {"screen_recording": "core.recording.worker.services.VideoCompositeEgressService","transcript": "core.recording.worker.services.AudioCompositeEgressService"} |-| RECORDING_EVENT_PARSER_CLASS | Storage event engine for recording | core.recording.event.parsers.MinioParser |-| RECORDING_ENABLE_STORAGE_EVENT_AUTH | Enable storage event authorization | true |-| RECORDING_STORAGE_EVENT_ENABLE | Enable recording storage events | false |-| RECORDING_STORAGE_EVENT_TOKEN | Recording storage event token | |-| RECORDING_EXPIRATION_DAYS | Recording expiration in days | |-| SCREEN_RECORDING_BASE_URL | Screen recording base URL | |-| SUMMARY_SERVICE_ENDPOINT | Summary service endpoint | |-| SUMMARY_SERVICE_API_TOKEN | API token for summary service | |-| SIGNUP_NEW_USER_TO_MARKETING_EMAIL | Signup users to marketing emails | false |-| MARKETING_SERVICE_CLASS | Marketing service class | core.services.marketing.BrevoMarketingService |-| BREVO_API_KEY | Brevo API key for marketing emails | |-| BREVO_API_CONTACT_LIST_IDS | Brevo API contact list IDs | [] |-| DJANGO_BREVO_API_CONTACT_ATTRIBUTES | Brevo contact attributes | {"VISIO_USER": true} |-| BREVO_API_TIMEOUT | Brevo timeout in seconds | 1 |-| LOBBY_KEY_PREFIX | Lobby key prefix | room_lobby |-| LOBBY_WAITING_TIMEOUT | Lobby waiting timeout in seconds | 3 |-| LOBBY_DENIED_TIMEOUT | Lobby deny timeout in seconds | 5 |-| LOBBY_ACCEPTED_TIMEOUT | Lobby accept timeout in seconds | 21600 (6 hours) |-| LOBBY_NOTIFICATION_TYPE | Lobby notification types | participantWaiting |-| LOBBY_COOKIE_NAME | Lobby cookie name | lobbyParticipantId |-| ROOM_CREATION_CALLBACK_CACHE_TIMEOUT | Room creation callback cache timeout | 600 (10 minutes) |-| ROOM_TELEPHONY_ENABLED | Enable SIP telephony feature | false |-| ROOM_TELEPHONY_PIN_LENGTH | Telephony PIN length | 10 |-| ROOM_TELEPHONY_PIN_MAX_RETRIES | Telephony PIN maximum retries | 5 |+| Option | Description | default |+| ----------------------------------------------- |------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|+| DATA_DIR | Data directory location | /data |+| DJANGO_ALLOWED_HOSTS | Hosts that are allowed | [] |+| DJANGO_SECRET_KEY | Secret key used for Django security | |+| DJANGO_SILENCED_SYSTEM_CHECKS | Silence Django system checks | [] |+| DJANGO_ALLOW_UNSECURE_USER_LISTING | Allow unsecure user listing | false |+| DB_ENGINE | Database engine used | django.db.backends.postgresql_psycopg2 |+| DB_NAME | Name of the database | meet |+| DB_USER | User used to connect to database | dinum |+| DB_PASSWORD | Password used to connect to the database | pass |+| DB_HOST | Hostname of the database | localhost |+| DB_PORT | Port to connect to database | 5432 |+| STORAGES_STATICFILES_BACKEND | Static file serving engine | whitenoise.storage.CompressedManifestStaticFilesStorage |+| AWS_S3_ENDPOINT_URL | S3 host endpoint | |+| AWS_S3_ACCESS_KEY_ID | S3 access key | |+| AWS_S3_SECRET_ACCESS_KEY | S3 secret key | |+| AWS_S3_REGION_NAME | S3 region | |+| AWS_STORAGE_BUCKET_NAME | S3 bucket name | meet-media-storage |+| DJANGO_LANGUAGE_CODE | Default language | en-us |+| REDIS_URL | Redis endpoint | redis://redis:6379/1 |+| SESSION_COOKIE_AGE | Session cookie expiration in seconds | 43200 (12 hours) |+| REQUEST_ENTRY_THROTTLE_RATES | Entry request throttle rates | 150/minute |+| CREATION_CALLBACK_THROTTLE_RATES | Creation callback throttle rates | 600/minute |+| SPECTACULAR_SETTINGS_ENABLE_DJANGO_DEPLOY_CHECK | Enable Django deploy check | false |+| CSRF_TRUSTED_ORIGINS | CSRF trusted origins list | [] |+| FRONTEND_CUSTOM_CSS_URL | URL of an additional CSS file to load in the frontend app. If set, a `<link>` tag with this URL as href is added to the `<head>` of the frontend app | |+| FRONTEND_ANALYTICS | Analytics information | {} |+| FRONTEND_SUPPORT | Crisp frontend support configuration | {} |+| FRONTEND_SILENCE_LIVEKIT_DEBUG | Silence LiveKit debug logs | false |+| FRONTEND_IS_SILENT_LOGIN_ENABLED | Enable silent login feature | true |+| FRONTEND_FEEDBACK | Frontend feedback configuration | {} |+| FRONTEND_USE_FRENCH_GOV_FOOTER | Show the French government footer in the homepage | false |+| FRONTEND_USE_PROCONNECT_BUTTON | Show a "Login with ProConnect" button in the homepage instead of a "Login" button | false |+| DJANGO_EMAIL_BACKEND | Email backend library | django.core.mail.backends.smtp.EmailBackend |+| DJANGO_EMAIL_HOST | Host of the email server | |+| DJANGO_EMAIL_HOST_USER | User to connect to the email server | |+| DJANGO_EMAIL_HOST_PASSWORD | Password to connect to the email server | |+| DJANGO_EMAIL_PORT | Port to connect to the email server | |+| DJANGO_EMAIL_USE_TLS | Enable TLS on email connection | false |+| DJANGO_EMAIL_USE_SSL | Enable SSL on email connection | false |+| DJANGO_EMAIL_FROM | Email from account | [email protected] |+| EMAIL_BRAND_NAME | Email branding name | |+| EMAIL_SUPPORT_EMAIL | Support email address | |+| EMAIL_LOGO_IMG | Email logo image | |+| EMAIL_DOMAIN | Email domain | |+| EMAIL_APP_BASE_URL | Email app base URL | |+| DJANGO_CORS_ALLOW_ALL_ORIGINS | Allow all CORS origins | false |+| DJANGO_CORS_ALLOWED_ORIGINS | Origins to allow (string list) | [] |+| DJANGO_CORS_ALLOWED_ORIGIN_REGEXES | Origins to allow (regex patterns) | [] |+| SENTRY_DSN | Sentry server DSN | |+| DJANGO_CELERY_BROKER_URL | Celery broker host | redis://redis:6379/0 |+| DJANGO_CELERY_BROKER_TRANSPORT_OPTIONS | Celery broker options | {} |+| OIDC_CREATE_USER | Create OIDC user if not exists | true |+| OIDC_VERIFY_SSL | Verify SSL for OIDC | true |+| OIDC_FALLBACK_TO_EMAIL_FOR_IDENTIFICATION | Fallback to email for identification | false |+| OIDC_RP_SIGN_ALGO | Token verification algorithm used by OIDC | RS256 |+| OIDC_RP_CLIENT_ID | OIDC client ID | meet |+| OIDC_RP_CLIENT_SECRET | OIDC client secret | |+| OIDC_OP_JWKS_ENDPOINT | OIDC endpoint for JWKS | |+| OIDC_OP_AUTHORIZATION_ENDPOINT | OIDC endpoint for authorization | |+| OIDC_OP_TOKEN_ENDPOINT | OIDC endpoint for token | |+| OIDC_OP_USER_ENDPOINT | OIDC endpoint for user | |+| OIDC_OP_USER_ENDPOINT_FORMAT | OIDC endpoint format (AUTO, JWT, JSON) | AUTO |+| OIDC_OP_LOGOUT_ENDPOINT | OIDC endpoint for logout | |+| OIDC_AUTH_REQUEST_EXTRA_PARAMS | Extra parameters for OIDC request | {} |+| OIDC_RP_SCOPES | OIDC scopes | openid email |+| OIDC_USE_NONCE | Use nonce for OIDC | true |+| OIDC_REDIRECT_REQUIRE_HTTPS | Require HTTPS for OIDC | false |+| OIDC_REDIRECT_ALLOWED_HOSTS | Allowed redirect hosts for OIDC | [] |+| OIDC_STORE_ID_TOKEN | Store OIDC ID token | true |+| OIDC_REDIRECT_FIELD_NAME | Redirect field for OIDC | returnTo |+| OIDC_USERINFO_FULLNAME_FIELDS | Full name claim from OIDC token | ["given_name", "usual_name"] |+| OIDC_USERINFO_SHORTNAME_FIELD | Short name claim from OIDC token | given_name |+| OIDC_USERINFO_ESSENTIAL_CLAIMS | Required claims from OIDC token | [] |+| LOGIN_REDIRECT_URL | Login redirect URL | |+| LOGIN_REDIRECT_URL_FAILURE | Login redirect URL for failure | |+| LOGOUT_REDIRECT_URL | URL to redirect to on logout | |+| ALLOW_LOGOUT_GET_METHOD | Allow logout through GET method | true |+| LIVEKIT_API_KEY | LiveKit API key | |+| LIVEKIT_API_SECRET | LiveKit API secret | |+| LIVEKIT_API_URL | LiveKit API URL | |+| LIVEKIT_VERIFY_SSL | Verify SSL for LiveKit connections | true |+| RESOURCE_DEFAULT_ACCESS_LEVEL | Default resource access level for rooms | public |+| ALLOW_UNREGISTERED_ROOMS | Allow usage of unregistered rooms | true |+| RECORDING_ENABLE | Record meeting option | false |+| RECORDING_OUTPUT_FOLDER | Folder to store meetings | recordings |+| RECORDING_WORKER_CLASSES | Worker classes for recording | {"screen_recording": "core.recording.worker.services.VideoCompositeEgressService","transcript": "core.recording.worker.services.AudioCompositeEgressService"} |+| RECORDING_EVENT_PARSER_CLASS | Storage event engine for recording | core.recording.event.parsers.MinioParser |+| RECORDING_ENABLE_STORAGE_EVENT_AUTH | Enable storage event authorization | true |+| RECORDING_STORAGE_EVENT_ENABLE | Enable recording storage events | false |+| RECORDING_STORAGE_EVENT_TOKEN | Recording storage event token | |+| RECORDING_EXPIRATION_DAYS | Recording expiration in days | |+| SCREEN_RECORDING_BASE_URL | Screen recording base URL | |+| SUMMARY_SERVICE_ENDPOINT | Summary service endpoint | |+| SUMMARY_SERVICE_API_TOKEN | API token for summary service | |+| SIGNUP_NEW_USER_TO_MARKETING_EMAIL | Signup users to marketing emails | false |+| MARKETING_SERVICE_CLASS | Marketing service class | core.services.marketing.BrevoMarketingService |+| BREVO_API_KEY | Brevo API key for marketing emails | |+| BREVO_API_CONTACT_LIST_IDS | Brevo API contact list IDs | [] |+| DJANGO_BREVO_API_CONTACT_ATTRIBUTES | Brevo contact attributes | {"VISIO_USER": true} |+| BREVO_API_TIMEOUT | Brevo timeout in seconds | 1 |+| LOBBY_KEY_PREFIX | Lobby key prefix | room_lobby |+| LOBBY_WAITING_TIMEOUT | Lobby waiting timeout in seconds | 3 |+| LOBBY_DENIED_TIMEOUT | Lobby deny timeout in seconds | 5 |+| LOBBY_ACCEPTED_TIMEOUT | Lobby accept timeout in seconds | 21600 (6 hours) |+| LOBBY_NOTIFICATION_TYPE | Lobby notification types | participantWaiting |+| LOBBY_COOKIE_NAME | Lobby cookie name | lobbyParticipantId |+| ROOM_CREATION_CALLBACK_CACHE_TIMEOUT | Room creation callback cache timeout | 600 (10 minutes) |+| ROOM_TELEPHONY_ENABLED | Enable SIP telephony feature | false |+| ROOM_TELEPHONY_PIN_LENGTH | Telephony PIN length | 10 |+| ROOM_TELEPHONY_PIN_MAX_RETRIES | Telephony PIN maximum retries | 5 |