FolioSpace Library

Docker Install

Run FolioSpace Library on your own NAS or Docker host.

FolioSpace Library is self-hosted. Mount your local folders into the container, create an access key on first run, then index the container paths shown in the setup page.

Pull the image

docker pull funland/foliospace-library:0.88

The current Docker Hub tag is funland/foliospace-library:0.88. Release 0.88 is published for linux/amd64 and linux/arm64. The latest tag also points to the current public release. 

0.88 manifest: sha256:5103cb56177ea481f000c72e0c180d135e0956295295a6d384379dbcc2be5e24
amd64:         sha256:80a9d88c397711f3296f0dd307aadb668eacb1efa2944daf14dcf557e098ca62
arm64:         sha256:b18cae5dde2e35e36014639000defb69711b4f5ba6dd6ae5773112da65ade658

Run with mounted libraries

docker run -d \
  --name foliospace-library \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /volume1/docker/foliospace-library/config:/config \
  -v /volume2/ComicCenter:/library:ro \
  -v /volume2/Books:/books:ro \
  -v /volume2/GameROMS:/games:ro \
  -v /volume2/MovieCollection/Movies:/videos:ro \
  -e FOLIOSPACE_DIRECTORY_ROOTS=/library,/books,/games,/videos \
  funland/foliospace-library:0.88

Open http://localhost:8080 or your NAS address. The setup page creates the first access key and library.

The /config mount must be a persistent writable directory. FolioSpace Library stores SQLite data, generated covers, thumbnails, and cache files there. The current image also attempts to repair common bind-mount ownership issues during startup.

Docker Compose

services:
  foliospace-library:
    image: funland/foliospace-library:0.88
    ports:
      - "8080:8080"
    volumes:
      - ./data/config:/config
      - ./data/library:/library:ro
      - ./data/books:/books:ro
      - ./data/games:/games:ro
      - ./data/videos:/videos:ro
    environment:
      FOLIOSPACE_CONFIG_DIR: /config
      FOLIOSPACE_LIBRARY_DIR: /library
      FOLIOSPACE_DIRECTORY_ROOTS: /library,/books,/games,/videos
      FOLIOSPACE_ADDR: :8080
      FOLIOSPACE_API_TOKEN: ""
      FOLIOSPACE_SCAN_WORKERS: "2"

Important path rule

The path selected in the web UI is the path inside the container. If a NAS folder does not appear in the setup picker, add a Docker volume mapping first and include the container path in FOLIOSPACE_DIRECTORY_ROOTS. Video folders work the same way: mount the host path and select the container-visible path such as /videos.

Keep content mounts read-only when possible. FolioSpace Library indexes user-owned local files and does not provide cloud hosting, ROM downloads, or built-in copyrighted resources.