Configuration

marimo offers two types of configuration: User Configuration and App Configuration. Both can be easily managed through the Settings menu in the marimo editor.

App Configuration

App Configuration is specific to each notebook and is stored in the notebook.py file. This allows you to customize various aspects of your notebook, including:

  • Notebook width

  • Notebook title

  • Custom CSS

  • Automatically download HTML snapshots

Configure these settings through the notebook menu.


User Configuration

User Configuration applies globally across all marimo notebooks and is stored in a .marimo.toml file.

While you can edit the .marimo.toml file directly, we recommend using the marimo UI for a more user-friendly experience.

You can customize the following:

  • Runtime, including whether notebooks autorun

  • Hotkeys

  • Completion (auto-completion, AI copilot, etc.)

  • Display (theme, font size, output placement, etc.)

  • Autosave

  • Package management

  • Server settings

  • VIM keybindings

  • Formatting settings

  • AI assistance

User configuration file

marimo searches for the .marimo.toml file in the following order:

  1. Current directory

  2. Parent directories (moving up the tree)

  3. Home directory (~/.marimo.toml)

  4. XDG directory (~/.config/marimo/marimo.toml or $XDG_CONFIG_HOME/marimo/marimo.toml)

If no .marimo.toml file is found, marimo creates one for you in an XDG config compliant way.

View your current configuration and locate the config file with:

marimo config show

Environment Variables

There are some configuration options that can be set via environment variables. These are:

Environment Variable

Description

Default Value

MARIMO_OUTPUT_MAX_BYTES

Maximum size of output that marimo will display. Outputs larger than this will be truncated.

5,000,000 (5MB)

MARIMO_STD_STREAM_MAX_BYTES

Maximum size of standard stream (stdout/stderr) output that marimo will display. Outputs larger than this will be truncated.

1,000,000 (1MB)

MARIMO_SKIP_UPDATE_CHECK

If set to “1”, marimo will skip checking for updates when starting.

Not set

MARIMO_SQL_DEFAULT_LIMIT

Default limit for SQL query results. If not set, no limit is applied.

Not set