Shiori — Simple Self-Hosted Bookmark Manager

What it is

Shiori is a self-hosted bookmark manager written in Go. It saves bookmarks with full-text search, archives web page content for offline reading, and provides a clean web interface for organizing your saved links. It runs as a single binary with an embedded SQLite database or optional PostgreSQL/MySQL backend.

Shiori targets users who want control over their bookmarks without relying on browser sync services or third-party bookmark tools. It is lightweight enough to run on a Raspberry Pi.

How it saves time or tokens

Shiori archives the full content of bookmarked pages, so you never lose access to content that goes offline or changes. The full-text search means you can find bookmarks by content, not just title or URL. This eliminates the frustration of knowing you saved something but not remembering what you called it.

The CLI and REST API enable automation: batch-import bookmarks from browsers, integrate with RSS readers, or build custom workflows.

How to use

1. Run Shiori with Docker:

docker run -d --name shiori \
  -p 8080:8080 \
  -v /path/to/data:/shiori \
  ghcr.io/go-shiori/shiori

1. Open http://localhost:8080 and log in with default credentials (shiori/gopher).

1. Add bookmarks via the web UI or CLI:

# CLI usage
shiori add https://example.com --title 'Example Site' --tags 'reference,docs'
shiori search 'kubernetes deployment'

Example

Using Shiori's REST API to manage bookmarks programmatically:

# Login and get session token
TOKEN=$(curl -s -X POST http://localhost:8080/api/login \
  -d '{"username":"shiori","password":"gopher"}' | jq -r '.session')

# Add a bookmark
curl -X POST http://localhost:8080/api/bookmarks \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "url": "https://docs.anthropic.com",
    "title": "Anthropic Docs",
    "tags": [{"name": "ai"}, {"name": "docs"}]
  }'

# Search bookmarks
curl http://localhost:8080/api/bookmarks?keyword=ai \
  -H "Authorization: Bearer $TOKEN"

Related on TokRepo

• Self-hosted tools -- Self-hosted applications for personal productivity
• AI tools for knowledge graph -- Knowledge management and organization tools

Common pitfalls

• Not changing the default password. The default credentials (shiori/gopher) are well-known. Change them immediately after first login.
• Running without persistent storage. Without mounting a volume to /shiori, all bookmarks are lost when the container restarts.
• Expecting browser extension quality. Shiori has a basic bookmarklet but no polished browser extension. Adding bookmarks via the web UI or API is more reliable.