# 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 pages and rewrite links for offline browsing. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2361/web-mirror

## Description

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.

## Health score

67/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 12 days ago)
- Popular: 22 (11 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 89 (no serious findings, 1 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/drumsergio/web-mirror
- GitHub: https://github.com/GeiserX/web-mirror
- Official website: https://geiserx.github.io/web-mirror/
- Unraid: https://ca.unraid.net/apps/web-mirror-1eetagx14wqn7h?q=web-mirror

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

---
Source: Our Local Host (https://ourlocalhost.com/app/2361/web-mirror), the self-hosted and open-source app directory.
