Marimo

Development1024MB+ RAM

Open-source reactive Python notebooks — reproducible, git-friendly, runnable as scripts or apps

Download Server Compass Install Marimo to server

developmentdevtoolsmarimoopen-sourceself-hosteddocker

Deploy Marimo in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select Marimo

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Step-by-step deployment guide

Deploy Marimo on a VPS with Server Compass

Use the Marimo template in Server Compass to deploy a self-hosted reactive Python notebook editor on your VPS, then verify the web UI in a browser.

About 10 minutesBrowser verified

Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Marimo app

Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template

Step 3

Search for Marimo

Use the template picker search to find Marimo in the Server Compass template catalog.

Searching for Marimo in the Server Compass template picker

Step 4

Select the Marimo template

Choose the Marimo template. Server Compass fills the Marimo web service, notebook volume, token password, and public web port.

Marimo template selected in Server Compass

Step 5

Review the Marimo settings

Confirm the app name, web UI port, and token setting. In this run, the app was named marimo-demo and used host web port 4071.

Reviewing Marimo project settings and compose service

Step 6

Deploy Marimo

Review the generated compose settings, confirm the Marimo web port is available, and click Deploy.

Reviewing Marimo web port before deployment

Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Marimo image, starts the container, and verifies the stack.

Server Compass deploying the Marimo template on the VPS

Step 8

Confirm Marimo is running

After deployment finishes, return to the Apps tab and confirm the Marimo app is marked Running with its application URL available.

Marimo template running in the Server Compass Apps tab

Step 9

Open Marimo in the browser

Open the application URL in a browser. The Marimo token login or notebook editor page confirms the service is reachable.

The deployed Marimo web UI loaded in a browser

After Marimo Opens

Sign in with the configured Marimo token.
Create a new notebook or open notebooks stored in the persistent volume.
Put Marimo behind HTTPS and an additional auth layer before exposing it publicly.
Treat Marimo as code execution infrastructure; do not expose it broadly to untrusted users.
Back up the Marimo notebook volume if the notebooks are important.

Verified Result

The Marimo web interface loaded successfully from the deployed container.

Download Server Compass Docs

Marimo deployment questions

What does the Marimo template deploy?

It deploys Marimo as a single-container reactive Python notebook editor with a persistent notebooks volume.

Which port did the tutorial use?

The tutorial used host port 4071, which maps to the Marimo web UI on container port 2718.

Does Marimo need setup after deployment?

Yes. Open the web UI, enter the configured token password, then create or open a notebook.

Should this become a blog post?

No. The deployment guide should live on the Marimo template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Marimo with Server Compass, complete these steps to finish setup

Visit the application URL

Enter MARIMO_TOKEN to log in

Create a new notebook or open an existing one from /notebooks

Optionally run a notebook as an app with `marimo run`

Need help? Check out our documentation for detailed guides.

Marimo FAQ

Common questions about self-hosting Marimo

How do I deploy Marimo with Server Compass?

Simply download Server Compass, connect to your VPS, and select Marimo from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Marimo?

Marimo requires a minimum of 1024MB RAM. We recommend a VPS with at least 2048MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Marimo data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Marimo backup and restore procedures.

How do I update Marimo to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Marimo image will be pulled and deployed with zero downtime.

Is Marimo free to self-host?

Marimo is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Related Templates

View all Development

PocketBase

Open-source backend in a single file with realtime database, auth, and file storage

Appwrite

Open-source backend-as-a-service - self-hosted Firebase alternative

Parse Server

Open-source backend framework with dashboard

Supabase

Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio

Ready to Self-Host Marimo?

Download Server Compass and deploy Marimo to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass