Running Marimo notebooks inside ShinyProxy

ShinyProxy supports running Marimo notebooks using the marimo Docker image.

Building the Docker image

To build the marimo Docker image, run the following command:

docker build -t openanalytics/shinyproxy-marimo-demo .

ShinyProxy configuration

Create a ShinyProxy configuration file (see application.yml for a complete file)

proxy:
  specs:
    - id: marimo
      container-image: openanalytics/shinyproxy-marimo-demo
      port: 8081
      container-cmd: ["marimo", "edit", "--host", "0.0.0.0", "-p", "8081", "--headless", "--no-token"]
      websocket-reconnection-mode: None

You can add persistent storage by mounting a volume:

proxy:
  specs:
    - id: marimo
      container-image: openanalytics/shinyproxy-marimo-demo
      port: 8081
      container-cmd: ["marimo", "edit", "--host", "0.0.0.0", "-p", "8081", "--headless", "--no-token"]
      container-volumes: [ "/tmp/marimo/#{proxy.userId}/work:/app"]
      websocket-reconnection-mode: None

Screenshots

(c) Copyright Open Analytics NV, 2026.