Deploy a lightweight comic server for your home network
GitHub RepoImpressions186

Deploy a lightweight comic server for your home network

@githubprojectsPost Author

Project Description

View on 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. Open your browser and navigate to http://your-machine-ip:3000.

  3. The first-time setup wizard will guide you through the initial configuration.

For more detailed instructions, including native installation options, check out the full documentation on the GitHub repository.

Final Thoughts

LANraragi is one of those tools that feels immediately useful. It takes a common, slightly annoying problem—managing a personal digital comics collection—and provides a clean, modern solution. It's perfect for tinkerers who want to keep their media local, for setting up a shared library for a household, or just for organizing a personal archive in a more enjoyable way. It's a great example of a focused open-source project that does one thing and does it very well.

If you've got a stash of digital comics, it's absolutely worth an afternoon of setup.


@githubprojects

Back to Projects
Project ID: ba66187d-f68f-420b-aa48-850a6fbce270Last updated: January 3, 2026 at 02:14 PM