Repository navigation
LibreCrawl 2.51 makes installing and starting LibreCrawl work on Mac, Windows and Linux without Docker, and adds a step-by-step install guide for each.
Fixes
Start scripts
- Mac and Linux:
start-librecrawl.shfailed withexternally-managed-environmenton Homebrew Python and on recent Ubuntu, Debian and Arch, which refuse a system-widepip install. It now installs into its own.venvin the LibreCrawl folder. - Windows:
start-librecrawl.batfound thepylauncher but never used it, and only worked if "Add Python to PATH" was ticked during the Python install. It now uses whichever Python it finds, with its own.venvtoo. - Both scripts now require Python 3.11+ and say so clearly, instead of failing later on an older Python.
- Packages are checked on every start, so updating LibreCrawl brings in any new ones.
- Docker: both scripts now check for Docker Compose and that Docker is actually running. If Docker Desktop is closed you get a message, instead of "LibreCrawl is running!" when it isn't.
start-librecrawl.shis now executable straight aftergit clone, so it no longer fails with "permission denied".- Errors in the Windows script pause the window, so you can read them when you started it by double-click.
Windows
- LibreCrawl crashed on startup when its output went to a file or pipe (logging to a file, running as a service), because Windows couldn't write the emoji in the startup warning. Output is now UTF-8.
Docs
- The README's Quick Start now has step-by-step instructions for Windows, Mac and Linux, starting from installing Python.
- The manual Python install uses a virtual environment and asks for Python 3.11+ (it said 3.8).
Testing
- New CI runs on every push: the full fixture test suite, plus the start scripts on Windows, Mac (Apple Silicon) with both Homebrew and the python.org installer, and Ubuntu. Each start-script job only passes once LibreCrawl actually answers in the browser.
Full changelog: v2.50...v2.51