Deploying¶
These guides help you deploy marimo notebooks.
Programmatically run the marimo backend for customization |
|
Deploy with Docker |
|
Deploy our public gallery |
|
Deploy to Marimo Cloud |
|
Deploy to Ploomber Cloud |
|
Deploy to Railway |
|
Authentication and security |
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.
Marimo Cloud
For a turnkey cloud solution, try Marimo Cloud.
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