Deploying#

These guides help you deploy marimo notebooks.

Running the marimo backend programmatically

Programmatically run the marimo backend for customization

Deploying with Docker

Deploying marimo notebooks and apps with Docker

Deploying to our public gallery

Deploying marimo notebooks and apps to our public gallery

Sharing notebooks on the public web

To share notebooks on the public web, try using WASM notebooks, an implementation of marimo that runs entirely in the browser – no backend required.

WASM notebooks support most but not all Python features and packages. See our guide on WASM notebooks to learn more.

Programmatically running the marimo backend#

When deploying marimo notebooks, you can run the marimo backend programmatically. This allows you to customize the backend to your needs and deploy it in your own environment.

See the programmatically running the marimo backend guide for more information.

Health and status endpoints#

The following endpoints may be useful when deploying your application:

  • /health - A health check endpoint that returns a 200 status code if the application is running as expected

  • /healthz - Same as above, just a different name for easier integration with cloud providers

  • /api/status - A status endpoint that returns a JSON object with the status of the server

Configuration#

If you would like to deploy your application at a subpath, you can set the --base-url flag when running your application.

marimo run app.py --base-url /subpath

Including code in your application#

You can include code in your application by using the --include-code flag when running your application.

marimo run app.py --include-code