Installation
By Amr
Prerequisites and setup steps for running Zer0-Mistakes locally.
Estimated reading time: 1 minutes
Table of Contents
Installation
Get up and running with Zer0-Mistakes in minutes using our Docker-first approach.
Requirements
Recommended: Docker (Zero Configuration)
- Docker Desktop - Works on macOS, Windows, and Linux
- No Ruby, Bundler, or gem management required
Alternative: Native Ruby
If you prefer local Ruby development:
- Ruby 3.0+ with development headers
- Bundler 2.0+ for dependency management
- Platform-specific build tools (Xcode CLI on macOS, build-essential on Linux)
Quick Start with Docker
# Clone the repository
git clone https://github.com/bamr87/zer0-mistakes.git
cd zer0-mistakes
# Start the development server
docker-compose up
Open http://localhost:4000 in your browser.
Platform-Specific Guides
macOS
# Install Docker Desktop
brew install --cask docker
# Or install Ruby natively
brew install ruby
gem install bundler jekyll
For detailed macOS setup: Jekyll macOS Installation
Windows
- Install Docker Desktop for Windows
- Enable WSL 2 backend for better performance
- Clone and run in PowerShell or WSL terminal
For native Ruby: Jekyll Windows Installation
Linux (Ubuntu/Debian)
# Install Docker
sudo apt-get update
sudo apt-get install docker.io docker-compose
# Or install Ruby natively
sudo apt-get install ruby-full build-essential
gem install bundler jekyll
For detailed Linux setup: Jekyll Ubuntu Installation
Verifying Installation
After starting the server, verify everything works:
# Check Jekyll version (in Docker)
docker-compose exec jekyll jekyll --version
# Check for configuration issues
docker-compose exec jekyll jekyll doctor
Next Steps
- Docker Development Guide - Learn Docker commands and workflows
- Jekyll Configuration - Customize your site
- Troubleshooting - Common issues and solutions