Configuration

Create mograder.toml in the course directory to customise settings:

config_url = "https://raw.githubusercontent.com/user/course/main/mograder.toml"
transport = "moodle"   # or "https" — selects the active transport for student/grader

# Transport-agnostic assignment list (written by `moodle sync` or `https sync`)
[[assignments]]
name = "HW1"
id = "10"
cmid = "42"
duedate = 1700000000
  [[assignments.files]]
  name = "hw1.py"
  url = "https://..."

[dirs]
source = "source"       # default directory names
release = "release"
submitted = "submitted"
autograded = "autograded"
feedback = "feedback"
import = "import"       # Moodle worksheets for export

[moodle]
url = "https://moodle.uni.ac.uk"  # Moodle site URL (for API commands)
course_id = 12345                  # Moodle course ID (for API commands)
csv = "moodle.csv"                 # default Moodle worksheet (for export)
match_column = "Username"
name_column = "Full name"

[https]
url = "http://localhost:8080"      # HTTPS transport server URL
token = ""                         # cached auth token

[defaults]
jobs = 4
timeout = 300
no_edit = false                    # disable "Edit" buttons in grader
no_actions = false                 # disable action buttons in grader
headless_edit = false              # open marimo edit in headless mode

[rlimits]                          # resource caps for notebook subprocesses
cpu = 600                          # CPU time limit in seconds
nproc = 64                         # max user processes
nofile = 256                       # max open file descriptors

[gradebook]
path = "gradebook.db"

[sync]
remote = "sciml"                                    # SSH host alias
remote_course_dir = "/home/svc_user/courses/es98e"  # course dir on remote
remote_venv_dir = "~/marimo-server"                 # uv venv dir on remote (optional)

[penalties]                        # late submission penalties
enabled = true                     # enable late penalty computation (default: false)
grace_minutes = 5                  # grace period in minutes (default: 5)
per_day = 5                        # percentage points per calendar day late (default: 5)
max = 100                          # maximum penalty percentage (default: 100)

[edit_links]                       # custom "Edit in ..." links for the student dashboard
molab = "https://molab.marimo.io/new/#code/{content_lz}"

[hub]                              # multi-user hub server settings
port = 8080
notebooks_dir = "hub-notebooks"
release_dir = "hub-release"
session_ttl = 3600
trusted_header = "X-Remote-User"
uv_cache_dir = ""

Section reference

transport

Top-level string selecting the active transport: "moodle" or "https". This determines which backend the student dashboard and grader use for fetching/submitting assignments.

[dirs]

Override default directory names for the nbgrader-style layout. All paths are relative to the course directory.

[moodle]

Moodle API connection settings. Required for mograder moodle subcommands.

[https]

HTTPS transport settings. The url is the base URL of the assignment server.

[defaults]

Default values for command-line flags: jobs (parallel workers), timeout (per-notebook), and grader UI options.

[rlimits]

POSIX resource limits applied to notebook subprocesses during autograde. See Security for details.

[gradebook]

Path to the SQLite gradebook file (default: gradebook.db in the course directory).

[sync]

Settings for mograder sync — SSH remote host, course directory on the remote, and optional uv venv directory.

[penalties]

Late submission penalty configuration. Penalties are applied during mograder feedback (not during autograde), so raw marks are always preserved.

Key	Default	Description
enabled	false	Enable late penalty computation
grace_minutes	5	Grace period in minutes (accounts for clock skew)
per_day	5	Percentage points deducted per calendar day late
max	100	Maximum penalty percentage (100 = can lose all marks)

Partial days are rounded up to the next whole day (e.g. 1.1 days late = 2-day penalty). The due date is read from the duedate field in [[assignments]]. Both raw and penalised marks are stored in the gradebook. Use --no-penalties on the feedback command to skip, or --due-date to override the deadline.

[hub]

Multi-user hub server settings. See Hub for usage details.

Key	Default	Description
port	8080	Server port
notebooks_dir	hub-notebooks	Directory for student work
release_dir	hub-release	Directory for published assignments
session_ttl	3600	Edit session idle timeout (seconds)
trusted_header	X-Remote-User	SSO proxy header name
uv_cache_dir	""	Custom uv cache location (empty = default ~/.cache/uv)

[edit_links]

Custom "Edit in ..." link templates for the student dashboard. The {content_lz} placeholder is replaced with the lzstring-compressed notebook content.