Deploying#

These guides help you deploy marimo notebooks and apps to your cloud or ours.

Deploying with Docker

Deploying marimo notebooks and apps with Docker

Deploying to marimo cloud

Deploying marimo notebooks and apps to marimo cloud

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