Shiori Simple Bookmark Manager

Key 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

Common Use Cases

• 1Development teams maintaining shared technical documentation and reference links
• 2Research organizations archiving web resources for long-term academic projects
• 3Content creators building private libraries of inspiration and reference materials
• 4Small businesses creating centralized knowledge bases from web resources
• 5Privacy-conscious individuals replacing cloud bookmark services with self-hosted alternatives
• 6Educational institutions providing students with curated, archived web resources
• 7Remote 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

1services: 
2  shiori: 
3    image: ghcr.io/go-shiori/shiori:latest
4    ports: 
5      - "8080:8080"
6    volumes: 
7      - shiori_data:/shiori
8    environment: 
9      SHIORI_DIR: /shiori
10    networks: 
11      - shiori-net
12    restart: unless-stopped
13
14  nginx: 
15    image: nginx:alpine
16    ports: 
17      - "80:80"
18      - "443:443"
19    volumes: 
20      - ./nginx.conf:/etc/nginx/nginx.conf:ro
21    depends_on: 
22      - shiori
23    networks: 
24      - shiori-net
25    restart: unless-stopped
26
27volumes: 
28  shiori_data: 
29
30networks: 
31  shiori-net: 
32    driver: bridge

.env Template

1# Shiori Configuration
2# Default login: shiori / gopher

Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

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

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  shiori:
5    image: ghcr.io/go-shiori/shiori:latest
6    ports:
7      - "8080:8080"
8    volumes:
9      - shiori_data:/shiori
10    environment:
11      SHIORI_DIR: /shiori
12    networks:
13      - shiori-net
14    restart: unless-stopped
15
16  nginx:
17    image: nginx:alpine
18    ports:
19      - "80:80"
20      - "443:443"
21    volumes:
22      - ./nginx.conf:/etc/nginx/nginx.conf:ro
23    depends_on:
24      - shiori
25    networks:
26      - shiori-net
27    restart: unless-stopped
28
29volumes:
30  shiori_data:
31
32networks:
33  shiori-net:
34    driver: bridge
35EOF
36
37# 2. Create the .env file
38cat > .env << 'EOF'
39# Shiori Configuration
40# Default login: shiori / gopher
41EOF
42
43# 3. Start the services
44docker compose up -d
45
46# 4. View logs
47docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/shiori-bookmark-manager/run | bash

Troubleshooting