# Shiori — Simple Self-Hosted Bookmark Manager

> Shiori is a lightweight self-hosted bookmark manager written in Go with full-text search, archiving, and a clean web interface for organizing your saved links.

## Install

Save as a script file and run:

# Shiori — Simple Self-Hosted Bookmark Manager

## Quick Use
```bash
docker run -d --name shiori 
  -p 8080:8080 
  -v /path/to/data:/shiori 
  ghcr.io/go-shiori/shiori
# Default login: shiori / gopher
```

## 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

---
Source: https://tokrepo.com/en/workflows/2a480908-39f2-11f1-9bc6-00163e2b0d79
Author: Script Depot