Deploy a lightweight comic server for your home network
D

Deploy a lightweight comic server for your home network

Deploy a lightweight comic server for your home network

3,006 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Host Your Own Comic Library with LANraragi

Ever have a folder full of digital comics, CBZ files, or scanned manga that's just sitting there, disorganized and hard to browse? Sharing them with friends or family on the same network usually means passing around a USB drive or dealing with clunky file explorers. There's got to be a better way.

Enter LANraragi. It's a self-hosted web server that takes your local archive of comics and turns it into a sleek, personal online library. Think of it as a lightweight, private Comic Server for your home network, accessible from any device with a browser.

What It Does

LANraragi is a Perl-based web application that indexes and serves comic book archives (like CBZ, CBR, PDF) from a folder on your machine. Once it's running, you can point your browser to its address, and you'll get a clean, searchable interface to read your comics from. It automatically fetches metadata from sites like MangaDex and AniList, tagging your collection so you can easily find what you're looking for.

Why It's Cool

The beauty of LANraragi is in its simplicity and focus. It's not a bloated media server; it's a dedicated, streamlined tool for a specific purpose. You run it on a local machine (like a Raspberry Pi, a NAS, or even your main desktop), and anyone on your Wi-Fi can access it without any complex setup.

Some standout features include:

  • Auto-Tagging: It scans your archives and pulls in tags, descriptions, and cover art, organizing your collection automatically.
  • Progress Tracking: It remembers your reading progress across devices.
  • Full-Text Search: You can search through the metadata and even the contents of your archives.
  • No Cloud Required: Everything stays on your local network. Your collection is yours, private and offline.
  • Docker-Friendly: It's packaged as a Docker image, making deployment a one-command affair on most systems.

It solves a niche problem elegantly, and it's built with the kind of straightforward, hackable approach that developers appreciate.

How to Try It

The easiest way to get started is with Docker. If you have Docker installed, you can be up and running in minutes.

  1. Pull the image and run the container:

    docker run -d \ --name lanraragi \ -p 3000:3000 \ -v /path/to/your/comics:/home/koyomi/lanraragi/content \ -v /path/to/your/database:/home/koyomi/lanraragi/database \ difegue/lanraragi
    

    Replace /path/to/your/comics with the directory where your comic archives live.

  2. O

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Jan 2, 2026