# Shiori Simple Bookmark Manager

> Simple bookmark manager with archive functionality, written in Go.

- Category: Productivity & Collaboration
- Difficulty: beginner
- Components: shiori, nginx
- Tags: shiori, bookmarks, archiving, simple, self-hosted
- Source: https://docker.recipes/productivity/shiori-bookmark-manager

## Overview

Shiori is a lightweight, self-hosted bookmark manager written in Go that allows users to save, organize, and archive web pages locally. Originally inspired by Pocket but designed for self-hosting enthusiasts, Shiori automatically creates offline copies of bookmarked pages, making your saved content accessible even when the original websites are down. The application features a clean web interface, full-text search capabilities, and the ability to organize bookmarks with tags and folders. This Docker stack combines Shiori with nginx to provide a production-ready deployment with proper reverse proxy handling, SSL termination capabilities, and improved performance through static file caching. The nginx layer adds professional-grade features like rate limiting, compression, and security headers that make Shiori suitable for team usage or public-facing deployments. This combination is particularly valuable for organizations wanting to provide their teams with a centralized, private bookmark management solution that doesn't rely on external services like Google Bookmarks or Pocket, ensuring complete data ownership and privacy.

## Features

- Automatic webpage archiving with full content preservation including images and CSS
- Full-text search across bookmark titles, content, and tags with instant results
- RESTful API for programmatic bookmark management and bulk operations
- Browser extension support for Chrome and Firefox with one-click bookmarking
- Command-line interface for batch importing bookmarks from other services
- Tag-based organization system with hierarchical folder structure support
- nginx-powered static file caching for faster bookmark thumbnail and archive loading
- Built-in duplicate detection to prevent saving the same URL multiple times

## Use cases

- Development teams maintaining shared technical documentation and reference links
- Research organizations archiving web resources for long-term academic projects
- Content creators building private libraries of inspiration and reference materials
- Small businesses creating centralized knowledge bases from web resources
- Privacy-conscious individuals replacing cloud bookmark services with self-hosted alternatives
- Educational institutions providing students with curated, archived web resources
- Remote teams collaborating on project research with shared bookmark collections

## Prerequisites

- Minimum 512MB RAM for Shiori application and bookmark indexing operations
- Available ports 80 and 443 for nginx web server and SSL termination
- Port 8080 free for direct Shiori access during initial setup and configuration
- Basic understanding of nginx configuration for SSL certificate setup and domain routing
- Docker Compose version 3.8+ for proper volume mounting and networking features

## docker-compose.yml

```yaml
services:
  shiori:
    image: ghcr.io/go-shiori/shiori:latest
    ports:
      - "8080:8080"
    volumes:
      - shiori_data:/shiori
    environment:
      SHIORI_DIR: /shiori
    networks:
      - shiori-net
    restart: unless-stopped

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      - shiori
    networks:
      - shiori-net
    restart: unless-stopped

volumes:
  shiori_data:

networks:
  shiori-net:
    driver: bridge
```

## .env

```bash
# Shiori Configuration
# Default login: shiori / gopher
```

## Usage notes

- Web UI at http://localhost:8080
- Default login: shiori / gopher
- Lightweight and fast
- CLI and browser extensions available

## Troubleshooting

- Shiori login fails with default credentials: Check if initialization completed by examining shiori container logs with 'docker-compose logs shiori'
- Bookmark archiving fails or times out: Increase Docker memory allocation to at least 1GB as webpage archiving is memory-intensive
- nginx returns 502 Bad Gateway: Verify shiori container is running and accessible on port 8080 within the shiori-net network
- Bookmarks lose archived content after restart: Ensure shiori_data volume is properly mounted and has sufficient disk space for archives
- Browser extension cannot connect to server: Configure nginx.conf to properly proxy API endpoints and WebSocket connections to Shiori backend
- Search functionality returns incomplete results: Rebuild Shiori's search index using the CLI command 'shiori update' within the container

