# 04-memos.md

kstack:
  book: Centerpoint Home Lab
  chapter: Documents & Organization
  page: Memos
  tags: [memos, notes, journal, productivity]
---

## Overview

Memos is a lightweight, self-hosted note-taking and micro-journaling app.
It provides a simple Twitter/Mastodon-style feed of notes, supports Markdown,
tags, and public/private visibility per memo. Internal-only access — no external
route is configured.

## Access

| Type     | URL                          | Auth                       |
|----------|------------------------------|----------------------------|
| Internal | `https://memos.home.local`   | Memos own auth (Step-CA TLS) |

No external route — accessible only on the LAN.

## Configuration

**Image:** `neosmemo/memos:stable`

### Environment Variables

| Variable              | Value                             | Purpose             |
|-----------------------|-----------------------------------|---------------------|
| `MEMOS_INSTANCE_URL`  | `https://memos.home.local`        | Canonical URL       |
| `MEMOS_PORT`          | `5230`                            | Listen port         |
| `TZ`                  | `America/Toronto`                 | Timezone            |

### Traefik Labels

```yaml
traefik.http.routers.memos.rule: Host(`memos.home.local`)
traefik.http.routers.memos.entrypoints: websecure
traefik.http.routers.memos.tls.certresolver: step-ca
traefik.http.services.memos.loadbalancer.server.port: 5230
```

## Volumes / Bind Mounts

| Host Path                          | Container Path     | Purpose             |
|------------------------------------|--------------------|---------------------|
| `/home/jeeves/docker/memos/data`   | `/var/opt/memos`   | Database and assets |

Memos uses SQLite stored in `/var/opt/memos`. No external database dependency.

## Notes / Gotchas

- `neosmemo/memos:stable` tracks the stable release tag. Upgrading the image
  will migrate the SQLite database automatically on first startup.
- There is no Authentik integration on this service — Memos manages its own
  accounts internally.
- Memos supports public content sharing via short links; ensure private memos
  are set to private if personal content is being stored.

---
*Last Updated: 2026-06-17*