Memos — Personal Voice Journal

Self-hosted journaling app with REST API, Markdown support, and Home Assistant voice integration.

Quick Start

cd /mnt/apps/docker/memos
docker compose up -d

Access at: https://journal.haiven.site

Features

Markdown-native content with auto-parsed #hashtag tagging
REST API with Bearer token authentication
Timeline view with full-text search
Voice journaling via Home Assistant ("journal entry ...")
LLM-powered transcription formatting via llama-swap
Private by default — entries visible only to creator
OIDC/SSO support via Authentik (optional)
Mobile-responsive web UI

Architecture

Voice Satellite → Home Assistant → STT (haiven-transcribe)
  → Assist Pipeline → JournalEntry intent
  → llama-swap (format) → Memos API (save)
  → smart_announce ("Journal entry saved.")

Configuration

Setting	Value
Image	`neosmemo/memos:0.26.2`
Port	5230
Domain	`journal.haiven.site`
Database	SQLite at `./data/memos.db`
Networks	web, backend
Memory Limit	512MB
Traefik	Label-based (no file-provider route)

Voice Commands

Say	Result
"journal entry [anything]"	Creates journal entry
"journal [anything]"	Creates journal entry
"write in my journal [anything]"	Creates journal entry
"add to my journal [anything]"	Creates journal entry
"dear journal [anything]"	Creates journal entry

API Usage

# Create entry (requires Bearer token from Memos UI → Settings → Access Tokens)
curl -s -X POST https://journal.haiven.site/api/v1/memos \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"content": "# My Entry\n\nSome text #journal", "visibility": "PRIVATE"}'

# List entries
curl -s -H "Authorization: Bearer <TOKEN>" \
  https://journal.haiven.site/api/v1/memos?limit=5

Backup

Daily automated backups via backup.sh:
- Daily: 7-day retention
- Weekly (Sunday): 4-week retention
- Monthly (1st): unlimited retention
- Location: /mnt/storage/memos/backups/

Manual backup: ./backup.sh

Initial Setup

Navigate to https://journal.haiven.site
Create admin account on first launch (credentials → Bitwarden)
Go to Settings → Access Tokens → Generate token
Add token to homeassistant/config/secrets.yaml:
yaml memos_api_token_bearer: "Bearer YOUR_TOKEN_HERE"
Reload Home Assistant configuration

Troubleshooting

# Container logs
docker logs -f memos

# Health check (image has wget only, not curl)
wget -qO- http://localhost:5230/healthz

# Check Traefik routing
curl -sk https://journal.haiven.site/healthz

# Check networks
docker inspect memos --format '{{range $k, $v := .NetworkSettings.Networks}}{{$k}}: {{$v.IPAddress}}{{end}}'

Implementation plan: _server-setup/08/08k-memos-journal-v2.md
HA REST commands: homeassistant/config/configuration.yaml
HA script: homeassistant/config/scripts.yaml
Custom sentences: homeassistant/config/custom_sentences/en/journal.yaml
OpenAPI spec: memos/openapi.yaml