# Memos

Note-taking service for short Markdown notes shown on a timeline.

- Replaces: [Google Keep](https://openlogs.fyi/alternatives/google-keep), [Notion](https://openlogs.fyi/alternatives/notion)
- Summary: Paid note-taking services, such as Notion and Google Keep.
- Stack: Go (language)
- Deployment: docker_compose
- License: MIT (osi) [source](https://github.com/usememos/memos/blob/9576bd53ac5922f3b8e680c03eb42be0d74252de/LICENSE)
- Business model: unknown. The README at the pinned commit does not state a business model, so it stays unknown. ([source](https://github.com/usememos/memos/blob/9576bd53ac5922f3b8e680c03eb42be0d74252de/README.md), read 2026-10-22)
- Difficulty: easy. 1 service, 1 volume mount, no env values to set, no elevated host access. Heuristic score 0 of 11: easy.
- Requirements: not stated
- Repository: [usememos/memos](https://github.com/usememos/memos)

## Install

1. Docker with the Compose plugin ([source](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx#L10-L24))

   ```text
   A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
   ```

2. Save the code block as compose.yaml ([source](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx))

   ```yaml
   services:
     memos:
       image: neosmemo/memos:stable
       container_name: memos
       restart: unless-stopped
       ports:
         - "5230:5230"
       volumes:
         - ./data:/var/opt/memos
       environment:
         MEMOS_PORT: 5230
         MEMOS_DRIVER: sqlite
         MEMOS_INSTANCE_URL: https://memos.example.com
   ```

3. What the compose file check ran with ([source](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx#L10-L24))

   ```text
   This compose file is copied unchanged from the code block in https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx#L10-L24. The check ran on that block alone. The Docker Compose deployment guide of the project shows this file and tells the reader to run docker compose up -d.
   ```

4. Start it ([source](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx))

   ```bash
   docker compose up -d
   ```

5. Open the app ([source](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx))

   ```text
   Open http://localhost:5230. The compose file publishes host port 5230 for the memos service.
   ```

Compose file check: config_ok on 2026-10-22.

## Gotchas and maintenance

### Gotchas

- The compose file publishes host ports: Host ports: 5230 (memos). A port without a host address listens on all host network interfaces. ([source](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx), checked 2026-10-22)
- The compose file mounts host folders: Host paths mounted into containers: ./data at /var/opt/memos (memos). ([source](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx), checked 2026-10-22)

### Signals

Computed from a GitHub snapshot taken 2026-10-22.

- Open issues and pull requests: 90
- Stars: 64001, forks: 4878
- Last push: 2026-10-22 (0 days ago)
- Latest release: v0.31.0 on 2026-09-19 (33 days ago)

## Sources

- [Repository: https://github.com/usememos/memos](https://github.com/usememos/memos)
- [License: https://github.com/usememos/memos/blob/9576bd53ac5922f3b8e680c03eb42be0d74252de/LICENSE](https://github.com/usememos/memos/blob/9576bd53ac5922f3b8e680c03eb42be0d74252de/LICENSE)
- [Business model: https://github.com/usememos/memos/blob/9576bd53ac5922f3b8e680c03eb42be0d74252de/README.md](https://github.com/usememos/memos/blob/9576bd53ac5922f3b8e680c03eb42be0d74252de/README.md)
- [Compose file: https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx)
- [Install step: https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx#L10-L24](https://github.com/usememos/dotcom/blob/bcce2169d04ecef7ffa966a15ee7bfa52d532fa1/content/docs/deploy/docker-compose.mdx#L10-L24)

---
Canonical: https://openlogs.fyi/tools/memos  
Last updated: 2026-10-22
