Web Mirror

Web Mirror is a self-hosted tool for homelab users that saves a configured website as local HTML and video files, using Playwright and BeautifulSoup to crawl…

  • Backup
  • Development
  • Network Services
  • Tools & Utilities
Web Mirror is a self-hosted tool for homelab users that saves a configured website as local HTML and video files, using Playwright and BeautifulSoup to crawl pages and rewrite links for offline browsing.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

67/100 Good

Maintained
100last commit 12 days ago
Popular
2211 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
89no serious findings, 1 minor, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 27 days ago

GitHub stars
11
Open issues
0
Last commit
2026-11-09
Latest release
v1.0.3
License
GPL-3.0
Activity
rising

Checked 9 days ago - source: GitHub (GeiserX/web-mirror)

Resources & Compatibility

Minimum requirements: 500 MB disk. ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Setup and serving Edit src/main2.py to set the target site and page list before building; the container writes the mirror to /data and can be served with the included nginx config. source

Fetched 45 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

How do I choose which website and pages web-mirror should mirror?

Set the target domain and page list in src/main2.py before building the image. Replace the placeholder domain and edit line 34, or swap that line to return links so it uses the site's sitemap.xml.

Where does web-mirror store the mirrored files?

The Docker container writes the mirror to /data. Mount a host directory such as ./data to /data so the finished copy is saved in that local directory.

Why does the Docker build or run fail on Apple Silicon?

Add --platform linux/amd64 to both docker build and docker run, and enable amd64 emulation with Rosetta. The base image is amd64 only, and Chromium crashes under QEMU.

How do I serve the mirrored website locally?

Run an nginx container with ./data mounted to /usr/share/nginx/html and the provided nginx/default.conf mounted to /etc/nginx/conf.d/default.conf. It publishes port 8080, so open localhost:8080 to browse the copy.

Can I use the published Docker image without editing the code first?

No, the published image still contains the placeholder domain. It only works as a base for building your own customized image.

Answers sourced from github.com

Community

Collected 53 days ago - public community threads