Dokploy

Frappe LMS

Easy to use, open source learning management system to structure courses and reach out to learners, built on the Frappe Framework.

Frappe LMS logo

Configuration

x-custom-image: &custom_image
  image: ${IMAGE_NAME:-ghcr.io/frappe/lms}:${VERSION:-v2.52.0}
  pull_policy: ${PULL_POLICY:-always}
  deploy:
    restart_policy:
      condition: always

services:
  backend:
    <<: *custom_image
    entrypoint: ["bash", "-c"]
    command:
      - >
        until [[ -f "sites/${SITE_NAME}/.create-site-done" ]]; do
          echo "Waiting for site ${SITE_NAME} to be created (first boot takes a few minutes)";
          sleep 5;
        done;
        exec /home/frappe/frappe-bench/env/bin/gunicorn --chdir=/home/frappe/frappe-bench/sites --bind=0.0.0.0:8000 --threads=4 --workers=2 --worker-class=gthread --worker-tmp-dir=/dev/shm --timeout=120 --preload frappe.app:application
    volumes:
      - sites:/home/frappe/frappe-bench/sites
    healthcheck:
      test: ["CMD", "wait-for-it", "127.0.0.1:8000"]
      interval: 2s
      timeout: 10s
      retries: 30
      start_period: 600s

  frontend:
    <<: *custom_image
    command:
      - nginx-entrypoint.sh
    depends_on:
      backend:
        condition: service_started
      websocket:
        condition: service_started
    environment:
      BACKEND: backend:8000
      FRAPPE_SITE_NAME_HEADER: ${FRAPPE_SITE_NAME_HEADER:-$$host}
      SOCKETIO: websocket:9000
      UPSTREAM_REAL_IP_ADDRESS: 127.0.0.1
      UPSTREAM_REAL_IP_HEADER: X-Forwarded-For
      UPSTREAM_REAL_IP_RECURSIVE: "off"
    volumes:
      - sites:/home/frappe/frappe-bench/sites
    healthcheck:
      test: ["CMD", "wait-for-it", "127.0.0.1:8080"]
      interval: 2s
      timeout: 30s
      retries: 30

  queue-default:
    <<: *custom_image
    command:
      - bench
      - worker
      - --queue
      - default
    volumes:
      - sites:/home/frappe/frappe-bench/sites
    healthcheck:
      test: ["CMD", "wait-for-it", "redis-queue:6379"]
      interval: 2s
      timeout: 10s
      retries: 30
    depends_on:
      configurator:
        condition: service_completed_successfully

  queue-long:
    <<: *custom_image
    command:
      - bench
      - worker
      - --queue
      - long
    volumes:
      - sites:/home/frappe/frappe-bench/sites
    healthcheck:
      test: ["CMD", "wait-for-it", "redis-queue:6379"]
      interval: 2s
      timeout: 10s
      retries: 30
    depends_on:
      configurator:
        condition: service_completed_successfully

  queue-short:
    <<: *custom_image
    command:
      - bench
      - worker
      - --queue
      - short
    volumes:
      - sites:/home/frappe/frappe-bench/sites
    healthcheck:
      test: ["CMD", "wait-for-it", "redis-queue:6379"]
      interval: 2s
      timeout: 10s
      retries: 30
    depends_on:
      configurator:
        condition: service_completed_successfully

  scheduler:
    <<: *custom_image
    healthcheck:
      test: ["CMD", "wait-for-it", "redis-queue:6379"]
      interval: 2s
      timeout: 10s
      retries: 30
    command:
      - bench
      - schedule
    depends_on:
      configurator:
        condition: service_completed_successfully
    volumes:
      - sites:/home/frappe/frappe-bench/sites

  websocket:
    <<: *custom_image
    healthcheck:
      test: ["CMD", "wait-for-it", "websocket:9000"]
      interval: 2s
      timeout: 10s
      retries: 30
    command:
      - node
      - /home/frappe/frappe-bench/apps/frappe/socketio.js
    depends_on:
      configurator:
        condition: service_completed_successfully
    volumes:
      - sites:/home/frappe/frappe-bench/sites

  configurator:
    <<: *custom_image
    deploy:
      mode: replicated
      replicas: ${CONFIGURE:-0}
      restart_policy:
        condition: none
    entrypoint: ["bash", "-c"]
    command:
      - >
        echo "[configurator] starting";
        if [[ $${REGENERATE_APPS_TXT} == "1" ]]; then
          echo "[configurator] regenerating sites/apps.txt";
          ls -1 apps > sites/apps.txt;
        fi;
        existing_db_host=$$(grep -hs '^' sites/common_site_config.json | jq -r ".db_host // empty" 2>/dev/null || true);
        if [[ -n "$${existing_db_host}" ]]; then
          echo "[configurator] common_site_config.json already configured, skipping";
          exit 0;
        fi;
        echo "[configurator] applying bench global config";
        bench set-config -g db_host $$DB_HOST;
        bench set-config -gp db_port $$DB_PORT;
        bench set-config -g redis_cache "redis://$$REDIS_CACHE";
        bench set-config -g redis_queue "redis://$$REDIS_QUEUE";
        bench set-config -g redis_socketio "redis://$$REDIS_SOCKETIO";
        bench set-config -gp socketio_port $$SOCKETIO_PORT;
        echo "[configurator] done";
    environment:
      DB_HOST: "${DB_HOST:-db}"
      DB_PORT: "3306"
      REDIS_CACHE: redis-cache:6379
      REDIS_QUEUE: redis-queue:6379
      REDIS_SOCKETIO: redis-socketio:6379
      SOCKETIO_PORT: "9000"
      REGENERATE_APPS_TXT: "${REGENERATE_APPS_TXT:-0}"
    volumes:
      - sites:/home/frappe/frappe-bench/sites

  create-site:
    <<: *custom_image
    deploy:
      mode: replicated
      replicas: ${CREATE_SITE:-0}
      restart_policy:
        condition: none
    entrypoint: ["bash", "-c"]
    command:
      - >
        wait-for-it -t 300 $${DB_HOST}:$${DB_PORT};
        wait-for-it -t 120 redis-cache:6379;
        wait-for-it -t 120 redis-queue:6379;
        export start=`date +%s`;
        until [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".db_host // empty"` ]] && \
          [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".redis_cache // empty"` ]] && \
          [[ -n `grep -hs ^ sites/common_site_config.json | jq -r ".redis_queue // empty"` ]];
        do
          echo "Waiting for sites/common_site_config.json to be created";
          sleep 5;
          if (( `date +%s`-start > 120 )); then
            echo "could not find sites/common_site_config.json with required keys";
            exit 1
          fi
        done;
        echo "sites/common_site_config.json found";
        [[ -d "sites/${SITE_NAME}" ]] && echo "${SITE_NAME} already exists" && touch sites/${SITE_NAME}/.create-site-done && exit 0;
        sed -i "s/^required_apps.*/required_apps = []/" apps/lms/lms/hooks.py;
        bench new-site --mariadb-user-host-login-scope='%' --admin-password=$${ADMIN_PASSWORD} --db-root-username=root --db-root-password=$${DB_ROOT_PASSWORD} $${INSTALL_APP_ARGS} $${SITE_NAME} || exit 1;
        if [[ $${ENABLE_SCHEDULER} == "1" ]]; then
          bench --site $${SITE_NAME} enable-scheduler;
        else
          echo "Skipping scheduler enable";
        fi;
        bench --site $${SITE_NAME} clear-cache;
        touch sites/$${SITE_NAME}/.create-site-done;
    volumes:
      - sites:/home/frappe/frappe-bench/sites
    environment:
      SITE_NAME: ${SITE_NAME}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD}
      DB_HOST: ${DB_HOST:-db}
      DB_PORT: "${DB_PORT:-3306}"
      DB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
      INSTALL_APP_ARGS: ${INSTALL_APP_ARGS}
      ENABLE_SCHEDULER: "${ENABLE_SCHEDULER}"

  migration:
    <<: *custom_image
    deploy:
      mode: replicated
      replicas: ${MIGRATE:-0}
      restart_policy:
        condition: none
    entrypoint: ["bash", "-c"]
    command:
      - >
        curl -f -H "Host: ${SITE_NAME}" http://frontend:8080/api/method/ping || { echo "Site not reachable yet, skipping migration"; exit 0; };
        bench --site all set-config -p maintenance_mode 1;
        bench --site all set-config -p pause_scheduler 1;
        bench --site all migrate;
        bench --site all set-config -p maintenance_mode 0;
        bench --site all set-config -p pause_scheduler 0;
    volumes:
      - sites:/home/frappe/frappe-bench/sites

  db:
    image: mariadb:${DB_VERSION:-11.8.6}
    deploy:
      mode: replicated
      replicas: ${ENABLE_DB:-0}
      restart_policy:
        condition: always
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      start_period: 120s
      interval: 5s
      timeout: 5s
      retries: 30
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
      - --skip-character-set-client-handshake
    environment:
      - MARIADB_ROOT_PASSWORD=${DB_ROOT_PASSWORD}
    volumes:
      - db-data:/var/lib/mysql

  redis-cache:
    deploy:
      restart_policy:
        condition: always
    image: redis:6.2-alpine
    volumes:
      - redis-cache-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 5s
      retries: 3

  redis-queue:
    deploy:
      restart_policy:
        condition: always
    image: redis:6.2-alpine
    volumes:
      - redis-queue-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 5s
      retries: 3

  redis-socketio:
    deploy:
      restart_policy:
        condition: always
    image: redis:6.2-alpine
    volumes:
      - redis-socketio-data:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 5s
      retries: 3

volumes:
  db-data:
  redis-cache-data:
  redis-queue-data:
  redis-socketio-data:
  sites:
    driver_opts:
      type: "${SITE_VOLUME_TYPE}"
      o: "${SITE_VOLUME_OPTS}"
      device: "${SITE_VOLUME_DEV}"
[variables]
main_domain = "${domain}"
db_root_password = "${password:32}"
admin_password = "${password:32}"

[config]
[[config.domains]]
serviceName = "frontend"
port = 8_080
host = "${main_domain}"

[config.env]
SITE_NAME = "${main_domain}"
ADMIN_PASSWORD = "${admin_password}"
DB_ROOT_PASSWORD = "${db_root_password}"
MIGRATE = "1"
ENABLE_DB = "1"
DB_HOST = "db"
CREATE_SITE = "1"
CONFIGURE = "1"
REGENERATE_APPS_TXT = "1"
INSTALL_APP_ARGS = "--install-app lms"
ENABLE_SCHEDULER = "1"
IMAGE_NAME = "ghcr.io/frappe/lms"
VERSION = "v2.52.0"
FRAPPE_SITE_NAME_HEADER = ""
DB_VERSION = "11.8.6"
SITE_VOLUME_TYPE = ""
SITE_VOLUME_OPTS = ""
SITE_VOLUME_DEV = ""

Base64

To import this template in Dokploy: create a Compose service → Advanced → Base64 import and paste the content below:

ewogICJjb21wb3NlIjogIngtY3VzdG9tLWltYWdlOiAmY3VzdG9tX2ltYWdlXG4gIGltYWdlOiAke0lNQUdFX05BTUU6LWdoY3IuaW8vZnJhcHBlL2xtc306JHtWRVJTSU9OOi12Mi41Mi4wfVxuICBwdWxsX3BvbGljeTogJHtQVUxMX1BPTElDWTotYWx3YXlzfVxuICBkZXBsb3k6XG4gICAgcmVzdGFydF9wb2xpY3k6XG4gICAgICBjb25kaXRpb246IGFsd2F5c1xuXG5zZXJ2aWNlczpcbiAgYmFja2VuZDpcbiAgICA8PDogKmN1c3RvbV9pbWFnZVxuICAgIGVudHJ5cG9pbnQ6IFtcImJhc2hcIiwgXCItY1wiXVxuICAgIGNvbW1hbmQ6XG4gICAgICAtID5cbiAgICAgICAgdW50aWwgW1sgLWYgXCJzaXRlcy8ke1NJVEVfTkFNRX0vLmNyZWF0ZS1zaXRlLWRvbmVcIiBdXTsgZG9cbiAgICAgICAgICBlY2hvIFwiV2FpdGluZyBmb3Igc2l0ZSAke1NJVEVfTkFNRX0gdG8gYmUgY3JlYXRlZCAoZmlyc3QgYm9vdCB0YWtlcyBhIGZldyBtaW51dGVzKVwiO1xuICAgICAgICAgIHNsZWVwIDU7XG4gICAgICAgIGRvbmU7XG4gICAgICAgIGV4ZWMgL2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9lbnYvYmluL2d1bmljb3JuIC0tY2hkaXI9L2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9zaXRlcyAtLWJpbmQ9MC4wLjAuMDo4MDAwIC0tdGhyZWFkcz00IC0td29ya2Vycz0yIC0td29ya2VyLWNsYXNzPWd0aHJlYWQgLS13b3JrZXItdG1wLWRpcj0vZGV2L3NobSAtLXRpbWVvdXQ9MTIwIC0tcHJlbG9hZCBmcmFwcGUuYXBwOmFwcGxpY2F0aW9uXG4gICAgdm9sdW1lczpcbiAgICAgIC0gc2l0ZXM6L2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9zaXRlc1xuICAgIGhlYWx0aGNoZWNrOlxuICAgICAgdGVzdDogW1wiQ01EXCIsIFwid2FpdC1mb3ItaXRcIiwgXCIxMjcuMC4wLjE6ODAwMFwiXVxuICAgICAgaW50ZXJ2YWw6IDJzXG4gICAgICB0aW1lb3V0OiAxMHNcbiAgICAgIHJldHJpZXM6IDMwXG4gICAgICBzdGFydF9wZXJpb2Q6IDYwMHNcblxuICBmcm9udGVuZDpcbiAgICA8PDogKmN1c3RvbV9pbWFnZVxuICAgIGNvbW1hbmQ6XG4gICAgICAtIG5naW54LWVudHJ5cG9pbnQuc2hcbiAgICBkZXBlbmRzX29uOlxuICAgICAgYmFja2VuZDpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX3N0YXJ0ZWRcbiAgICAgIHdlYnNvY2tldDpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX3N0YXJ0ZWRcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIEJBQ0tFTkQ6IGJhY2tlbmQ6ODAwMFxuICAgICAgRlJBUFBFX1NJVEVfTkFNRV9IRUFERVI6ICR7RlJBUFBFX1NJVEVfTkFNRV9IRUFERVI6LSQkaG9zdH1cbiAgICAgIFNPQ0tFVElPOiB3ZWJzb2NrZXQ6OTAwMFxuICAgICAgVVBTVFJFQU1fUkVBTF9JUF9BRERSRVNTOiAxMjcuMC4wLjFcbiAgICAgIFVQU1RSRUFNX1JFQUxfSVBfSEVBREVSOiBYLUZvcndhcmRlZC1Gb3JcbiAgICAgIFVQU1RSRUFNX1JFQUxfSVBfUkVDVVJTSVZFOiBcIm9mZlwiXG4gICAgdm9sdW1lczpcbiAgICAgIC0gc2l0ZXM6L2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9zaXRlc1xuICAgIGhlYWx0aGNoZWNrOlxuICAgICAgdGVzdDogW1wiQ01EXCIsIFwid2FpdC1mb3ItaXRcIiwgXCIxMjcuMC4wLjE6ODA4MFwiXVxuICAgICAgaW50ZXJ2YWw6IDJzXG4gICAgICB0aW1lb3V0OiAzMHNcbiAgICAgIHJldHJpZXM6IDMwXG5cbiAgcXVldWUtZGVmYXVsdDpcbiAgICA8PDogKmN1c3RvbV9pbWFnZVxuICAgIGNvbW1hbmQ6XG4gICAgICAtIGJlbmNoXG4gICAgICAtIHdvcmtlclxuICAgICAgLSAtLXF1ZXVlXG4gICAgICAtIGRlZmF1bHRcbiAgICB2b2x1bWVzOlxuICAgICAgLSBzaXRlczovaG9tZS9mcmFwcGUvZnJhcHBlLWJlbmNoL3NpdGVzXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OiBbXCJDTURcIiwgXCJ3YWl0LWZvci1pdFwiLCBcInJlZGlzLXF1ZXVlOjYzNzlcIl1cbiAgICAgIGludGVydmFsOiAyc1xuICAgICAgdGltZW91dDogMTBzXG4gICAgICByZXRyaWVzOiAzMFxuICAgIGRlcGVuZHNfb246XG4gICAgICBjb25maWd1cmF0b3I6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9jb21wbGV0ZWRfc3VjY2Vzc2Z1bGx5XG5cbiAgcXVldWUtbG9uZzpcbiAgICA8PDogKmN1c3RvbV9pbWFnZVxuICAgIGNvbW1hbmQ6XG4gICAgICAtIGJlbmNoXG4gICAgICAtIHdvcmtlclxuICAgICAgLSAtLXF1ZXVlXG4gICAgICAtIGxvbmdcbiAgICB2b2x1bWVzOlxuICAgICAgLSBzaXRlczovaG9tZS9mcmFwcGUvZnJhcHBlLWJlbmNoL3NpdGVzXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OiBbXCJDTURcIiwgXCJ3YWl0LWZvci1pdFwiLCBcInJlZGlzLXF1ZXVlOjYzNzlcIl1cbiAgICAgIGludGVydmFsOiAyc1xuICAgICAgdGltZW91dDogMTBzXG4gICAgICByZXRyaWVzOiAzMFxuICAgIGRlcGVuZHNfb246XG4gICAgICBjb25maWd1cmF0b3I6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9jb21wbGV0ZWRfc3VjY2Vzc2Z1bGx5XG5cbiAgcXVldWUtc2hvcnQ6XG4gICAgPDw6ICpjdXN0b21faW1hZ2VcbiAgICBjb21tYW5kOlxuICAgICAgLSBiZW5jaFxuICAgICAgLSB3b3JrZXJcbiAgICAgIC0gLS1xdWV1ZVxuICAgICAgLSBzaG9ydFxuICAgIHZvbHVtZXM6XG4gICAgICAtIHNpdGVzOi9ob21lL2ZyYXBwZS9mcmFwcGUtYmVuY2gvc2l0ZXNcbiAgICBoZWFsdGhjaGVjazpcbiAgICAgIHRlc3Q6IFtcIkNNRFwiLCBcIndhaXQtZm9yLWl0XCIsIFwicmVkaXMtcXVldWU6NjM3OVwiXVxuICAgICAgaW50ZXJ2YWw6IDJzXG4gICAgICB0aW1lb3V0OiAxMHNcbiAgICAgIHJldHJpZXM6IDMwXG4gICAgZGVwZW5kc19vbjpcbiAgICAgIGNvbmZpZ3VyYXRvcjpcbiAgICAgICAgY29uZGl0aW9uOiBzZXJ2aWNlX2NvbXBsZXRlZF9zdWNjZXNzZnVsbHlcblxuICBzY2hlZHVsZXI6XG4gICAgPDw6ICpjdXN0b21faW1hZ2VcbiAgICBoZWFsdGhjaGVjazpcbiAgICAgIHRlc3Q6IFtcIkNNRFwiLCBcIndhaXQtZm9yLWl0XCIsIFwicmVkaXMtcXVldWU6NjM3OVwiXVxuICAgICAgaW50ZXJ2YWw6IDJzXG4gICAgICB0aW1lb3V0OiAxMHNcbiAgICAgIHJldHJpZXM6IDMwXG4gICAgY29tbWFuZDpcbiAgICAgIC0gYmVuY2hcbiAgICAgIC0gc2NoZWR1bGVcbiAgICBkZXBlbmRzX29uOlxuICAgICAgY29uZmlndXJhdG9yOlxuICAgICAgICBjb25kaXRpb246IHNlcnZpY2VfY29tcGxldGVkX3N1Y2Nlc3NmdWxseVxuICAgIHZvbHVtZXM6XG4gICAgICAtIHNpdGVzOi9ob21lL2ZyYXBwZS9mcmFwcGUtYmVuY2gvc2l0ZXNcblxuICB3ZWJzb2NrZXQ6XG4gICAgPDw6ICpjdXN0b21faW1hZ2VcbiAgICBoZWFsdGhjaGVjazpcbiAgICAgIHRlc3Q6IFtcIkNNRFwiLCBcIndhaXQtZm9yLWl0XCIsIFwid2Vic29ja2V0OjkwMDBcIl1cbiAgICAgIGludGVydmFsOiAyc1xuICAgICAgdGltZW91dDogMTBzXG4gICAgICByZXRyaWVzOiAzMFxuICAgIGNvbW1hbmQ6XG4gICAgICAtIG5vZGVcbiAgICAgIC0gL2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9hcHBzL2ZyYXBwZS9zb2NrZXRpby5qc1xuICAgIGRlcGVuZHNfb246XG4gICAgICBjb25maWd1cmF0b3I6XG4gICAgICAgIGNvbmRpdGlvbjogc2VydmljZV9jb21wbGV0ZWRfc3VjY2Vzc2Z1bGx5XG4gICAgdm9sdW1lczpcbiAgICAgIC0gc2l0ZXM6L2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9zaXRlc1xuXG4gIGNvbmZpZ3VyYXRvcjpcbiAgICA8PDogKmN1c3RvbV9pbWFnZVxuICAgIGRlcGxveTpcbiAgICAgIG1vZGU6IHJlcGxpY2F0ZWRcbiAgICAgIHJlcGxpY2FzOiAke0NPTkZJR1VSRTotMH1cbiAgICAgIHJlc3RhcnRfcG9saWN5OlxuICAgICAgICBjb25kaXRpb246IG5vbmVcbiAgICBlbnRyeXBvaW50OiBbXCJiYXNoXCIsIFwiLWNcIl1cbiAgICBjb21tYW5kOlxuICAgICAgLSA+XG4gICAgICAgIGVjaG8gXCJbY29uZmlndXJhdG9yXSBzdGFydGluZ1wiO1xuICAgICAgICBpZiBbWyAkJHtSRUdFTkVSQVRFX0FQUFNfVFhUfSA9PSBcIjFcIiBdXTsgdGhlblxuICAgICAgICAgIGVjaG8gXCJbY29uZmlndXJhdG9yXSByZWdlbmVyYXRpbmcgc2l0ZXMvYXBwcy50eHRcIjtcbiAgICAgICAgICBscyAtMSBhcHBzID4gc2l0ZXMvYXBwcy50eHQ7XG4gICAgICAgIGZpO1xuICAgICAgICBleGlzdGluZ19kYl9ob3N0PSQkKGdyZXAgLWhzICdeJyBzaXRlcy9jb21tb25fc2l0ZV9jb25maWcuanNvbiB8IGpxIC1yIFwiLmRiX2hvc3QgLy8gZW1wdHlcIiAyPi9kZXYvbnVsbCB8fCB0cnVlKTtcbiAgICAgICAgaWYgW1sgLW4gXCIkJHtleGlzdGluZ19kYl9ob3N0fVwiIF1dOyB0aGVuXG4gICAgICAgICAgZWNobyBcIltjb25maWd1cmF0b3JdIGNvbW1vbl9zaXRlX2NvbmZpZy5qc29uIGFscmVhZHkgY29uZmlndXJlZCwgc2tpcHBpbmdcIjtcbiAgICAgICAgICBleGl0IDA7XG4gICAgICAgIGZpO1xuICAgICAgICBlY2hvIFwiW2NvbmZpZ3VyYXRvcl0gYXBwbHlpbmcgYmVuY2ggZ2xvYmFsIGNvbmZpZ1wiO1xuICAgICAgICBiZW5jaCBzZXQtY29uZmlnIC1nIGRiX2hvc3QgJCREQl9IT1NUO1xuICAgICAgICBiZW5jaCBzZXQtY29uZmlnIC1ncCBkYl9wb3J0ICQkREJfUE9SVDtcbiAgICAgICAgYmVuY2ggc2V0LWNvbmZpZyAtZyByZWRpc19jYWNoZSBcInJlZGlzOi8vJCRSRURJU19DQUNIRVwiO1xuICAgICAgICBiZW5jaCBzZXQtY29uZmlnIC1nIHJlZGlzX3F1ZXVlIFwicmVkaXM6Ly8kJFJFRElTX1FVRVVFXCI7XG4gICAgICAgIGJlbmNoIHNldC1jb25maWcgLWcgcmVkaXNfc29ja2V0aW8gXCJyZWRpczovLyQkUkVESVNfU09DS0VUSU9cIjtcbiAgICAgICAgYmVuY2ggc2V0LWNvbmZpZyAtZ3Agc29ja2V0aW9fcG9ydCAkJFNPQ0tFVElPX1BPUlQ7XG4gICAgICAgIGVjaG8gXCJbY29uZmlndXJhdG9yXSBkb25lXCI7XG4gICAgZW52aXJvbm1lbnQ6XG4gICAgICBEQl9IT1NUOiBcIiR7REJfSE9TVDotZGJ9XCJcbiAgICAgIERCX1BPUlQ6IFwiMzMwNlwiXG4gICAgICBSRURJU19DQUNIRTogcmVkaXMtY2FjaGU6NjM3OVxuICAgICAgUkVESVNfUVVFVUU6IHJlZGlzLXF1ZXVlOjYzNzlcbiAgICAgIFJFRElTX1NPQ0tFVElPOiByZWRpcy1zb2NrZXRpbzo2Mzc5XG4gICAgICBTT0NLRVRJT19QT1JUOiBcIjkwMDBcIlxuICAgICAgUkVHRU5FUkFURV9BUFBTX1RYVDogXCIke1JFR0VORVJBVEVfQVBQU19UWFQ6LTB9XCJcbiAgICB2b2x1bWVzOlxuICAgICAgLSBzaXRlczovaG9tZS9mcmFwcGUvZnJhcHBlLWJlbmNoL3NpdGVzXG5cbiAgY3JlYXRlLXNpdGU6XG4gICAgPDw6ICpjdXN0b21faW1hZ2VcbiAgICBkZXBsb3k6XG4gICAgICBtb2RlOiByZXBsaWNhdGVkXG4gICAgICByZXBsaWNhczogJHtDUkVBVEVfU0lURTotMH1cbiAgICAgIHJlc3RhcnRfcG9saWN5OlxuICAgICAgICBjb25kaXRpb246IG5vbmVcbiAgICBlbnRyeXBvaW50OiBbXCJiYXNoXCIsIFwiLWNcIl1cbiAgICBjb21tYW5kOlxuICAgICAgLSA+XG4gICAgICAgIHdhaXQtZm9yLWl0IC10IDMwMCAkJHtEQl9IT1NUfTokJHtEQl9QT1JUfTtcbiAgICAgICAgd2FpdC1mb3ItaXQgLXQgMTIwIHJlZGlzLWNhY2hlOjYzNzk7XG4gICAgICAgIHdhaXQtZm9yLWl0IC10IDEyMCByZWRpcy1xdWV1ZTo2Mzc5O1xuICAgICAgICBleHBvcnQgc3RhcnQ9YGRhdGUgKyVzYDtcbiAgICAgICAgdW50aWwgW1sgLW4gYGdyZXAgLWhzIF4gc2l0ZXMvY29tbW9uX3NpdGVfY29uZmlnLmpzb24gfCBqcSAtciBcIi5kYl9ob3N0IC8vIGVtcHR5XCJgIF1dICYmIFxcXG4gICAgICAgICAgW1sgLW4gYGdyZXAgLWhzIF4gc2l0ZXMvY29tbW9uX3NpdGVfY29uZmlnLmpzb24gfCBqcSAtciBcIi5yZWRpc19jYWNoZSAvLyBlbXB0eVwiYCBdXSAmJiBcXFxuICAgICAgICAgIFtbIC1uIGBncmVwIC1ocyBeIHNpdGVzL2NvbW1vbl9zaXRlX2NvbmZpZy5qc29uIHwganEgLXIgXCIucmVkaXNfcXVldWUgLy8gZW1wdHlcImAgXV07XG4gICAgICAgIGRvXG4gICAgICAgICAgZWNobyBcIldhaXRpbmcgZm9yIHNpdGVzL2NvbW1vbl9zaXRlX2NvbmZpZy5qc29uIHRvIGJlIGNyZWF0ZWRcIjtcbiAgICAgICAgICBzbGVlcCA1O1xuICAgICAgICAgIGlmICgoIGBkYXRlICslc2Atc3RhcnQgPiAxMjAgKSk7IHRoZW5cbiAgICAgICAgICAgIGVjaG8gXCJjb3VsZCBub3QgZmluZCBzaXRlcy9jb21tb25fc2l0ZV9jb25maWcuanNvbiB3aXRoIHJlcXVpcmVkIGtleXNcIjtcbiAgICAgICAgICAgIGV4aXQgMVxuICAgICAgICAgIGZpXG4gICAgICAgIGRvbmU7XG4gICAgICAgIGVjaG8gXCJzaXRlcy9jb21tb25fc2l0ZV9jb25maWcuanNvbiBmb3VuZFwiO1xuICAgICAgICBbWyAtZCBcInNpdGVzLyR7U0lURV9OQU1FfVwiIF1dICYmIGVjaG8gXCIke1NJVEVfTkFNRX0gYWxyZWFkeSBleGlzdHNcIiAmJiB0b3VjaCBzaXRlcy8ke1NJVEVfTkFNRX0vLmNyZWF0ZS1zaXRlLWRvbmUgJiYgZXhpdCAwO1xuICAgICAgICBzZWQgLWkgXCJzL15yZXF1aXJlZF9hcHBzLiovcmVxdWlyZWRfYXBwcyA9IFtdL1wiIGFwcHMvbG1zL2xtcy9ob29rcy5weTtcbiAgICAgICAgYmVuY2ggbmV3LXNpdGUgLS1tYXJpYWRiLXVzZXItaG9zdC1sb2dpbi1zY29wZT0nJScgLS1hZG1pbi1wYXNzd29yZD0kJHtBRE1JTl9QQVNTV09SRH0gLS1kYi1yb290LXVzZXJuYW1lPXJvb3QgLS1kYi1yb290LXBhc3N3b3JkPSQke0RCX1JPT1RfUEFTU1dPUkR9ICQke0lOU1RBTExfQVBQX0FSR1N9ICQke1NJVEVfTkFNRX0gfHwgZXhpdCAxO1xuICAgICAgICBpZiBbWyAkJHtFTkFCTEVfU0NIRURVTEVSfSA9PSBcIjFcIiBdXTsgdGhlblxuICAgICAgICAgIGJlbmNoIC0tc2l0ZSAkJHtTSVRFX05BTUV9IGVuYWJsZS1zY2hlZHVsZXI7XG4gICAgICAgIGVsc2VcbiAgICAgICAgICBlY2hvIFwiU2tpcHBpbmcgc2NoZWR1bGVyIGVuYWJsZVwiO1xuICAgICAgICBmaTtcbiAgICAgICAgYmVuY2ggLS1zaXRlICQke1NJVEVfTkFNRX0gY2xlYXItY2FjaGU7XG4gICAgICAgIHRvdWNoIHNpdGVzLyQke1NJVEVfTkFNRX0vLmNyZWF0ZS1zaXRlLWRvbmU7XG4gICAgdm9sdW1lczpcbiAgICAgIC0gc2l0ZXM6L2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9zaXRlc1xuICAgIGVudmlyb25tZW50OlxuICAgICAgU0lURV9OQU1FOiAke1NJVEVfTkFNRX1cbiAgICAgIEFETUlOX1BBU1NXT1JEOiAke0FETUlOX1BBU1NXT1JEfVxuICAgICAgREJfSE9TVDogJHtEQl9IT1NUOi1kYn1cbiAgICAgIERCX1BPUlQ6IFwiJHtEQl9QT1JUOi0zMzA2fVwiXG4gICAgICBEQl9ST09UX1BBU1NXT1JEOiAke0RCX1JPT1RfUEFTU1dPUkR9XG4gICAgICBJTlNUQUxMX0FQUF9BUkdTOiAke0lOU1RBTExfQVBQX0FSR1N9XG4gICAgICBFTkFCTEVfU0NIRURVTEVSOiBcIiR7RU5BQkxFX1NDSEVEVUxFUn1cIlxuXG4gIG1pZ3JhdGlvbjpcbiAgICA8PDogKmN1c3RvbV9pbWFnZVxuICAgIGRlcGxveTpcbiAgICAgIG1vZGU6IHJlcGxpY2F0ZWRcbiAgICAgIHJlcGxpY2FzOiAke01JR1JBVEU6LTB9XG4gICAgICByZXN0YXJ0X3BvbGljeTpcbiAgICAgICAgY29uZGl0aW9uOiBub25lXG4gICAgZW50cnlwb2ludDogW1wiYmFzaFwiLCBcIi1jXCJdXG4gICAgY29tbWFuZDpcbiAgICAgIC0gPlxuICAgICAgICBjdXJsIC1mIC1IIFwiSG9zdDogJHtTSVRFX05BTUV9XCIgaHR0cDovL2Zyb250ZW5kOjgwODAvYXBpL21ldGhvZC9waW5nIHx8IHsgZWNobyBcIlNpdGUgbm90IHJlYWNoYWJsZSB5ZXQsIHNraXBwaW5nIG1pZ3JhdGlvblwiOyBleGl0IDA7IH07XG4gICAgICAgIGJlbmNoIC0tc2l0ZSBhbGwgc2V0LWNvbmZpZyAtcCBtYWludGVuYW5jZV9tb2RlIDE7XG4gICAgICAgIGJlbmNoIC0tc2l0ZSBhbGwgc2V0LWNvbmZpZyAtcCBwYXVzZV9zY2hlZHVsZXIgMTtcbiAgICAgICAgYmVuY2ggLS1zaXRlIGFsbCBtaWdyYXRlO1xuICAgICAgICBiZW5jaCAtLXNpdGUgYWxsIHNldC1jb25maWcgLXAgbWFpbnRlbmFuY2VfbW9kZSAwO1xuICAgICAgICBiZW5jaCAtLXNpdGUgYWxsIHNldC1jb25maWcgLXAgcGF1c2Vfc2NoZWR1bGVyIDA7XG4gICAgdm9sdW1lczpcbiAgICAgIC0gc2l0ZXM6L2hvbWUvZnJhcHBlL2ZyYXBwZS1iZW5jaC9zaXRlc1xuXG4gIGRiOlxuICAgIGltYWdlOiBtYXJpYWRiOiR7REJfVkVSU0lPTjotMTEuOC42fVxuICAgIGRlcGxveTpcbiAgICAgIG1vZGU6IHJlcGxpY2F0ZWRcbiAgICAgIHJlcGxpY2FzOiAke0VOQUJMRV9EQjotMH1cbiAgICAgIHJlc3RhcnRfcG9saWN5OlxuICAgICAgICBjb25kaXRpb246IGFsd2F5c1xuICAgIGhlYWx0aGNoZWNrOlxuICAgICAgdGVzdDogW1wiQ01EXCIsIFwiaGVhbHRoY2hlY2suc2hcIiwgXCItLWNvbm5lY3RcIiwgXCItLWlubm9kYl9pbml0aWFsaXplZFwiXVxuICAgICAgc3RhcnRfcGVyaW9kOiAxMjBzXG4gICAgICBpbnRlcnZhbDogNXNcbiAgICAgIHRpbWVvdXQ6IDVzXG4gICAgICByZXRyaWVzOiAzMFxuICAgIGNvbW1hbmQ6XG4gICAgICAtIC0tY2hhcmFjdGVyLXNldC1zZXJ2ZXI9dXRmOG1iNFxuICAgICAgLSAtLWNvbGxhdGlvbi1zZXJ2ZXI9dXRmOG1iNF91bmljb2RlX2NpXG4gICAgICAtIC0tc2tpcC1jaGFyYWN0ZXItc2V0LWNsaWVudC1oYW5kc2hha2VcbiAgICBlbnZpcm9ubWVudDpcbiAgICAgIC0gTUFSSUFEQl9ST09UX1BBU1NXT1JEPSR7REJfUk9PVF9QQVNTV09SRH1cbiAgICB2b2x1bWVzOlxuICAgICAgLSBkYi1kYXRhOi92YXIvbGliL215c3FsXG5cbiAgcmVkaXMtY2FjaGU6XG4gICAgZGVwbG95OlxuICAgICAgcmVzdGFydF9wb2xpY3k6XG4gICAgICAgIGNvbmRpdGlvbjogYWx3YXlzXG4gICAgaW1hZ2U6IHJlZGlzOjYuMi1hbHBpbmVcbiAgICB2b2x1bWVzOlxuICAgICAgLSByZWRpcy1jYWNoZS1kYXRhOi9kYXRhXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OiBbXCJDTURcIiwgXCJyZWRpcy1jbGlcIiwgXCJwaW5nXCJdXG4gICAgICBpbnRlcnZhbDogNXNcbiAgICAgIHRpbWVvdXQ6IDVzXG4gICAgICByZXRyaWVzOiAzXG5cbiAgcmVkaXMtcXVldWU6XG4gICAgZGVwbG95OlxuICAgICAgcmVzdGFydF9wb2xpY3k6XG4gICAgICAgIGNvbmRpdGlvbjogYWx3YXlzXG4gICAgaW1hZ2U6IHJlZGlzOjYuMi1hbHBpbmVcbiAgICB2b2x1bWVzOlxuICAgICAgLSByZWRpcy1xdWV1ZS1kYXRhOi9kYXRhXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OiBbXCJDTURcIiwgXCJyZWRpcy1jbGlcIiwgXCJwaW5nXCJdXG4gICAgICBpbnRlcnZhbDogNXNcbiAgICAgIHRpbWVvdXQ6IDVzXG4gICAgICByZXRyaWVzOiAzXG5cbiAgcmVkaXMtc29ja2V0aW86XG4gICAgZGVwbG95OlxuICAgICAgcmVzdGFydF9wb2xpY3k6XG4gICAgICAgIGNvbmRpdGlvbjogYWx3YXlzXG4gICAgaW1hZ2U6IHJlZGlzOjYuMi1hbHBpbmVcbiAgICB2b2x1bWVzOlxuICAgICAgLSByZWRpcy1zb2NrZXRpby1kYXRhOi9kYXRhXG4gICAgaGVhbHRoY2hlY2s6XG4gICAgICB0ZXN0OiBbXCJDTURcIiwgXCJyZWRpcy1jbGlcIiwgXCJwaW5nXCJdXG4gICAgICBpbnRlcnZhbDogNXNcbiAgICAgIHRpbWVvdXQ6IDVzXG4gICAgICByZXRyaWVzOiAzXG5cbnZvbHVtZXM6XG4gIGRiLWRhdGE6XG4gIHJlZGlzLWNhY2hlLWRhdGE6XG4gIHJlZGlzLXF1ZXVlLWRhdGE6XG4gIHJlZGlzLXNvY2tldGlvLWRhdGE6XG4gIHNpdGVzOlxuICAgIGRyaXZlcl9vcHRzOlxuICAgICAgdHlwZTogXCIke1NJVEVfVk9MVU1FX1RZUEV9XCJcbiAgICAgIG86IFwiJHtTSVRFX1ZPTFVNRV9PUFRTfVwiXG4gICAgICBkZXZpY2U6IFwiJHtTSVRFX1ZPTFVNRV9ERVZ9XCJcbiIsCiAgImNvbmZpZyI6ICJbdmFyaWFibGVzXVxubWFpbl9kb21haW4gPSBcIiR7ZG9tYWlufVwiXG5kYl9yb290X3Bhc3N3b3JkID0gXCIke3Bhc3N3b3JkOjMyfVwiXG5hZG1pbl9wYXNzd29yZCA9IFwiJHtwYXNzd29yZDozMn1cIlxuXG5bY29uZmlnXVxuW1tjb25maWcuZG9tYWluc11dXG5zZXJ2aWNlTmFtZSA9IFwiZnJvbnRlbmRcIlxucG9ydCA9IDhfMDgwXG5ob3N0ID0gXCIke21haW5fZG9tYWlufVwiXG5cbltjb25maWcuZW52XVxuU0lURV9OQU1FID0gXCIke21haW5fZG9tYWlufVwiXG5BRE1JTl9QQVNTV09SRCA9IFwiJHthZG1pbl9wYXNzd29yZH1cIlxuREJfUk9PVF9QQVNTV09SRCA9IFwiJHtkYl9yb290X3Bhc3N3b3JkfVwiXG5NSUdSQVRFID0gXCIxXCJcbkVOQUJMRV9EQiA9IFwiMVwiXG5EQl9IT1NUID0gXCJkYlwiXG5DUkVBVEVfU0lURSA9IFwiMVwiXG5DT05GSUdVUkUgPSBcIjFcIlxuUkVHRU5FUkFURV9BUFBTX1RYVCA9IFwiMVwiXG5JTlNUQUxMX0FQUF9BUkdTID0gXCItLWluc3RhbGwtYXBwIGxtc1wiXG5FTkFCTEVfU0NIRURVTEVSID0gXCIxXCJcbklNQUdFX05BTUUgPSBcImdoY3IuaW8vZnJhcHBlL2xtc1wiXG5WRVJTSU9OID0gXCJ2Mi41Mi4wXCJcbkZSQVBQRV9TSVRFX05BTUVfSEVBREVSID0gXCJcIlxuREJfVkVSU0lPTiA9IFwiMTEuOC42XCJcblNJVEVfVk9MVU1FX1RZUEUgPSBcIlwiXG5TSVRFX1ZPTFVNRV9PUFRTID0gXCJcIlxuU0lURV9WT0xVTUVfREVWID0gXCJcIlxuIgp9

Instructions

Frappe LMS (Frappe Learning)

Initial setup

The first deployment creates the Frappe site and installs the LMS app, which can take 3-6 minutes after all containers are up. The site is ready when the domain returns the Frappe login page.

Default credentials

  • Username: Administrator
  • Password: the value of the ADMIN_PASSWORD environment variable (auto-generated, check the Environment tab of the service)

After logging in, the learning portal is available at /lms and the Frappe admin backend at /app.

Notes

  • The template pins ghcr.io/frappe/lms:v2.52.0, the latest upstream image that ships the LMS app (newer upstream tags are currently published without the app baked in).
  • The upstream image does not include the payments app, so paid-course checkout features are unavailable. Free courses, batches, quizzes and certifications work normally.

Tags

lms, learning, education, courses, frappe

Version: v2.52.0

Frappe Lending

A comprehensive loan management system built on Frappe Framework. 100% open source and customizable for managing loans, repayments, and lending operations.

FreeScout

FreeScout is a free open source help desk and shared inbox system. It's a self-hosted alternative to HelpScout, Zendesk, and similar services that allows you to manage customer communications through email and a clean web interface. FreeScout makes it easy to organize support requests, track customer conversations, and collaborate with your team.

On this page

ConfigurationBase64InstructionsFrappe LMS (Frappe Learning)Initial setupDefault credentialsNotesLinksTags