Shiori — Simple Self-Hosted Bookmark Manager

Introduction

Shiori is a simple bookmark manager written in Go, inspired by Pocket. It archives web pages locally so you can read them later even if the original site goes down. With a clean web UI, browser extension, and CLI, Shiori makes it easy to save, tag, search, and organize bookmarks on your own server.

What Shiori Does

• Saves bookmarks with automatic page content archiving for offline reading
• Provides full-text search across bookmark titles, URLs, and archived content
• Supports tagging, starring, and bulk operations for organizing bookmarks
• Offers a browser extension for Chrome and Firefox for one-click saving
• Includes a CLI for scripting and batch-importing bookmarks

Architecture Overview

Shiori is a single Go binary that serves a web UI and REST API. It stores bookmark metadata in SQLite, PostgreSQL, or MySQL and archives page content using a built-in readability parser. Archived pages are stored on the local filesystem. The frontend is a lightweight Vue.js application bundled into the binary for zero-dependency deployment.

Self-Hosting & Configuration

• Run as a single Docker container with a volume for persistent data storage
• Supports SQLite by default with optional PostgreSQL or MySQL backends
• Configure the listening address and port via command-line flags or environment variables
• Import bookmarks from Netscape HTML files exported by browsers
• Deploy behind a reverse proxy with basic auth or SSO for additional security

Key Features

• Offline page archiving with readability parsing for distraction-free reading
• Full-text search powered by the database engine across all saved content
• Browser extensions for Chrome and Firefox with one-click bookmark saving
• REST API for building custom integrations and automation workflows
• Lightweight single binary with no external runtime dependencies

Comparison with Similar Tools

• Linkwarden — More collaborative features; Shiori is simpler and lighter for personal use
• Wallabag — PHP-based with more integrations; Shiori is a single Go binary with easier setup
• Pocket — Cloud service by Mozilla; Shiori is fully self-hosted with no tracking
• Raindrop.io — Polished SaaS with team features; Shiori is free and privacy-focused
• Hoarder (Karakeep) — AI-powered tagging; Shiori focuses on simplicity and archiving

FAQ

Q: Can I import my existing bookmarks? A: Yes. Shiori supports importing from Netscape HTML bookmark files, which all major browsers can export.

Q: Does it work without an internet connection? A: Saved bookmarks with archived content can be read offline. New bookmarks require connectivity to fetch page content.

Q: What browsers have extensions? A: Chrome and Firefox extensions are available for quick bookmark saving from the browser toolbar.

Q: Can I use it with a mobile device? A: The web UI is responsive and works on mobile browsers. There is no dedicated native mobile app.

Sources

• https://github.com/go-shiori/shiori
• https://github.com/go-shiori/shiori/wiki