# marimohub – self-hostable marimo notebooks

> Source: <https://github.com/marimo-team/marimohub>
> Published: 2026-10-04 00:55:59+00:00

marimohub is a self-hostable platform for storing, managing, and running
[marimo](https://marimo.io) notebooks. It is built for teams that want to run
notebooks on their own infrastructure while choosing their own storage, compute,
and identity providers.

The hub has no separate database. Notebook metadata, versions, snapshots, and system records live in an object store, so the object store is the source of truth you back up and recover. External systems sit behind TypeScript ports, so operators can swap providers without changing the domain logic.

- Bring your own **storage** : CoreWeave CAIOS, S3-compatible storage, Google Cloud
Storage, Azure Blob Storage, filesystem, or Cloudflare R2.
- Bring your own **compute** : CoreWeave Sandboxes, Modal, AWS ECS Fargate,
Kubernetes, Docker, Podman, E2B, Cloudflare Containers, or local subprocesses.
- Bring your own **identity** : OpenID Connect, trusted SSO proxies, Google IAP,
or Cloudflare Access.
- Optional managed AI, versioned integrations, encrypted values, external secret references, and short-lived federated cloud access.

Use marimohub when you want a self-hosted notebook hub with a small operational surface and explicit provider choices. If you want a hosted SaaS or do not want to operate storage, compute, and auth, this is probably not the right shape yet.

Requirements: Node >= 24.11, pnpm 10.34.5, and `uv` plus Python if you want to
start local notebook kernels.

```
pnpm install --frozen-lockfile
pnpm dev
```

`pnpm dev` watches the TypeScript server and runs it with the Vite web app in
parallel. It skips the production server build. The local stack uses:

- `memory` storage, which is non-durable
- `local` compute, which starts`uv run marimo edit`
- `dev` auth, which signs everyone in as a fixed local super admin
- integrations and metadata browsing, with a welcome notebook and sample environment

Set `MARIMOHUB_DEV_PERSIST=true` to keep local state in the Git-ignored
`.context/dev-storage` directory. Run `pnpm dev:reset` after stopping the dev
stack to clear it.

See [Testing locally](https://github.com/marimo-team/marimohub/blob/main/docs/testing-locally.md) for the full local path and the
production swaps for each backend.

Most deployments use the config-driven server image: set `MARIMOHUB_*`
environment variables and let `@marimo-hub/config` select the adapters. Custom
runtimes can compose the packages directly as a library.

Start with [Getting started](https://github.com/marimo-team/marimohub/blob/main/docs/getting-started.md), then choose a deployment
guide:

Useful references:

- [Configuration](https://github.com/marimo-team/marimohub/blob/main/docs/configuration.md) - every`MARIMOHUB_*` variable
- [Storage](https://github.com/marimo-team/marimohub/blob/main/docs/storage.md) ,[Compute](https://github.com/marimo-team/marimohub/blob/main/docs/compute.md) , and[Auth](https://github.com/marimo-team/marimohub/blob/main/docs/auth.md) - backend choices
- [Security](https://github.com/marimo-team/marimohub/blob/main/docs/security.md) ,[Operations](https://github.com/marimo-team/marimohub/blob/main/docs/operations.md) , and[Troubleshooting](https://github.com/marimo-team/marimohub/blob/main/docs/troubleshooting.md) - production operation
- [API & client](https://github.com/marimo-team/marimohub/blob/main/docs/api.md) - HTTP response envelope and generated client

This is a pnpm and vite-plus TypeScript monorepo.

```
pnpm check
pnpm test
pnpm build
```

Read [CONTRIBUTING.md](https://github.com/marimo-team/marimohub/blob/main/CONTRIBUTING.md) before opening a pull request. For
architecture and internal design, start with
[development_docs/architecture.md](https://github.com/marimo-team/marimohub/blob/main/development_docs/architecture.md) and
[development_docs/bucket_spec.md](https://github.com/marimo-team/marimohub/blob/main/development_docs/bucket_spec.md). Integration
kind contributors should also read
[development_docs/integrations.md](https://github.com/marimo-team/marimohub/blob/main/development_docs/integrations.md).

marimohub is licensed under the Apache License, Version 2.0. See
[LICENSE](https://github.com/marimo-team/marimohub/blob/main/LICENSE).