https://github.com/solveditnpc/manga-server
manga management server with user facing frontend , additional support to web-scraper 1200+ websites(download and present on your server/machine)
https://github.com/solveditnpc/manga-server
comik docker-deployment doujinshi flask gunicorn manga manga-downloader manga-reader nhentai server sqlite3 user-friendly user-interface webscraper
Last synced: about 2 months ago
JSON representation
manga management server with user facing frontend , additional support to web-scraper 1200+ websites(download and present on your server/machine)
- Host: GitHub
- URL: https://github.com/solveditnpc/manga-server
- Owner: solveditnpc
- License: agpl-3.0
- Created: 2025-08-01T23:44:45.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-02-07T21:59:26.000Z (4 months ago)
- Last Synced: 2026-02-08T05:59:39.915Z (4 months ago)
- Topics: comik, docker-deployment, doujinshi, flask, gunicorn, manga, manga-downloader, manga-reader, nhentai, server, sqlite3, user-friendly, user-interface, webscraper
- Language: TypeScript
- Homepage:
- Size: 55.9 MB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# UNDER CONSTRUCTION ONLY SPECIFIC WEBSITES WORKING AT THE MOMENT, AND ONLY UI ON PORT 5001 , PORT 3000 UI IS UNDER CONSTRUCTION
# Manga Downloader & Server
This project allows you to download manga from 1000+ websites by author or from specific pages, and provides a web interface to view,read and download your collection.
## Prerequisites
Before you begin, ensure you have Docker and Docker Compose installed on your system. If you don't have them installed, follow the official installation guides below:
* **Windows**: [Install Docker Desktop on Windows](https://docs.docker.com/desktop/setup/install/windows-install/)
* **macOS**: [Install Docker Desktop on Mac](https://docs.docker.com/desktop/setup/install/mac-install/)
* **Linux**: [Install Docker Desktop on Linux](https://docs.docker.com/desktop/setup/install/linux/)
## How to Run
Follow these steps to get the project up and running:
### 1. Verify File Integrity (creates missing directories and files)
```bash
python3 checksum.py
```
### 2. Build the Docker Images
Before running the services for the first time, it's best to build the images separately. This can also be used to rebuild the images if you make changes to the Dockerfiles or the source code.
```bash
docker compose build
```
### 3. Start the Web Scraper Service
The web scraper is responsible for fetching manga from nhentai.xxx. Open a terminal in the project's root directory and run the following command:
```bash
docker compose up web-scraper
```
This command will build the Docker image for the scraper and start the service at `port 5002` . You can leave this terminal running to see the scraper's logs.
### 4. Start the Server Service
Once the scraper is running, open a **new** terminal in the same directory and start the frontend service:
```bash
docker compose up server
```
This will build and start the web server at `port 5001`
> This port is also temporarily serving a web-interface. Functional until frontend work is not stable.
### 5. Start the Frontend Service
Once the scraper is running, open a **new** terminal in the same directory and start the frontend service:
```bash
docker compose up frontend
```
This will build and start the web interface at `port 3000`
### 6. You can also run scripts in the background to repair any mangas that are missing any pages
TO do this , instead of running docker compose up web-scraper ,run the below
```bash
docker compose up web-scraper python repairing_manga.py
```
### 7. Access the Web Interface
After the frontend service has started, you can access the web interface by opening your browser and navigating to:
[http://localhost:5001](http://localhost:5001)
In order to access from a different device on teh same network, replace localhost with the ip address of the machine running the server.(192.x.x.x:3000)
From the web interface, you can queue downloads and view your manga collection.
This implementation is ready for hosting for public.(adjust the number of cores in docker-compose.yml to match your server's capabilities and link to a domain)