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.993

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

FolioSpace Library 0.993

Release 0.993 adds Nintendo Virtual Boy catalog support and lets native clients discover the server's game-platform catalog dynamically while keeping the service self-hosted on your NAS or Docker host.

Authenticated platform catalog: GET /api/client/games/platforms.
Canonical Virtual Boy platform and local box-art matching.
Client capability flag: gamePlatformCatalog: true in /api/client/info.

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.993

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

Download the ready-to-run package. It includes a version-pinned Compose file, an environment template, and a quick-start guide.

Download Compose package Compose file Environment template

unzip FolioSpace-Library-Compose-0.993.zip
cd FolioSpace-Library-Compose-0.993-20260803
cp .env.example .env
mkdir -p data/config data/library data/books data/games data/videos
docker compose up -d

Edit .env before starting when your media already lives in NAS folders. The package supports Linux AMD64 and ARM64 and was verified against the public 0.993 image on ARM64 Docker.

SHA-256: 157fd0b4719de0ce5cd9d5ffe87155668b74d3635ae8383b4ed95dde6995509c

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.