Configuration

Though there's no need for a regular user to ever touch this file, some of the Memospot behavior can be configured via memospot.yaml.

File location

Linux/macOS:

~/.memospot/memospot.yaml

Windows:
- Explorer:
  %LocalAppData%\memospot\memospot.yaml
- Powershell:
  $Env:LocalAppData\memospot\memospot.yaml

Sample configuration file

Fields that default to null are detected at runtime.

memos:
  # Memos data storage. Where the database and assets are stored.
  #
  # This setting allows you to change the data storage (database,
  # assets, and thumbnails) to a folder synced by a cloud storage 
  # provider client, like OneDrive, Dropbox, Google Drive, etc.
  data: null

  # Use this to spawn a custom Memos binary.
  binary_path: null

  # Memos working directory. This is where the `dist` folder
  # must reside (from v0.18.2 to v0.21.0).
  working_dir: null

  # Mode: [prod] | dev | demo. This changes the database file in use.
  mode: prod

  # Address where Memos will listen for connections.
  # Listening to 127.0.0.1 won't trigger Windows Firewall, and the
  # server instance will only be accessible from the host computer.
  # This is the default.
  #
  # Listening to 0.0.0.0 will make the server available 
  # at all your computer's network adapters addresses
  # if it's allowed by the Firewall.
  addr: 127.0.0.1

  # Memos' port. Managed by Memospot. You can set a custom port,
  # but it will be automatically changed if the port is in use
  # during Memospot startup.
  port: 0

  env:
    # Custom environment variables for Memos.
    # https://www.usememos.com/docs/install/runtime-options
    #
    # Make sure to always quote custom env values, 
    # so they get parsed as strings.
    enabled: false
    vars:
      MEMOS_DRIVER: 'postgres'
      MEMOS_DSN: 'postgresql://root:password@localhost:5432/memos'

memospot:
  backups:
    # Enable backups [true]. Currently, backups only run before
    # database migrations and there's no retention management.
    enabled: true
    # Backup directory.
    path: null

  env:
    # Custom environment variables for Memospot itself. 
    # May be used to override hardware acceleration on Linux.
    enabled: false
    vars:
      WEBKIT_DISABLE_DMABUF_RENDERER: '0'
      WEBKIT_DISABLE_COMPOSITING_MODE: '0'

  migrations:
    # Enable migrations [true]. These are database
    # migrations that make upgrading Memos smoother.
    enabled: true

  log:
    # Enable logging [false]. Used for advanced debugging.
    # A new file called `logging_config.yaml` will be created next 
    # to this file upon the next Memospot run.
    # Then, you can edit `logging_config.yaml` changing `root.level`
    # from `info` to `debug` to increase the logging level.
    enabled: false

  remote:
    # Use Memospot as a client for a remote Memos server [false].
    # - Added in v0.1.6.
    # The URL must point to a valid Memos server, using HTTP or HTTPS.
    # Other web apps most likely won't pass the internal health check.
    enabled: false
    url: https://demo.usememos.com/
    user_agent: 'Memospot/1.0.0'

  updater:
    # Enable auto-updater [true].
    # - Added in v0.1.7.
    # Can be used to disable the updater  
    # entirely and prevent notifications.
    enabled: true

  window:
    # Window properties.
    # - Added in v0.1.7.
    # > Managed variables store the previous state upon app close.

    # Whether the window should be centered upon creation. [true]
    center: true

    # Whether the window should be fullscreen upon creation. [false]
    fullscreen: false

    # Whether the user can resize the window. [true]
    resizable: true

    # (Managed) Whether the window should be maximized upon creation.
    maximized: false

    # (Managed) Window initial width.
    width: 0

    # (Managed) Window initial height.
    height: 0

    # (Managed) Window initial x position.
    x: 0

    # (Managed) Window initial y position.
    y: 0

    # Hide the menu bar [false].
    # * This setting is not available from the settings screen.
    hide_menu_bar: false

    # theme: [system] | light | dark
    theme: system

    # locale [system] | en | [pt-BR]
    locale: system

Last modified: 24 February 2025