Self-host marimo with Docker

A reactive Python notebook that is reproducible, git-friendly, and shareable as an app.

This page describes the Levelrail template for marimo (Developer Tools). It deploys the services below as one Docker Compose app on your own server.

Project site: https://marimo.io/.

Recommended memory: about 1024 MiB.

Services, ports and volumes

Service	Image	Container ports	Volumes
marimo	ghcr.io/marimo-team/marimo:latest-sql	8080	marimo_data -> /app

Environment variables

This template sets no environment variables.

Passwords and keys marked as generated are created for you when the app is deployed and stored as secrets. Values are not shown here.

This template needs configuration before it can deploy. Open it in the dashboard, set each variable marked "You must provide" in the Compose body, then deploy.

Deploy marimo with Levelrail

In the dashboard, open Apps, choose New app, then Browse templates, and select marimo. Review the Compose body and deploy.

With the CLI:

levelrail-cli templates get marimo --output json | jq -r .compose > marimo.compose.yaml
# edit marimo.compose.yaml to set the variables you must provide
levelrail-cli apps deploy-compose my-marimo --file marimo.compose.yaml

See Service template catalog for how templates work, and Getting started if you have not installed Levelrail yet.

More Developer Tools templates

• Appsmith
• Appwrite
• Browserless
• ByteStash
• code-server
• ConvertX

All templates are listed in the self-host gallery.