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

1. Install Docker Desktop for Windows
2. Enable WSL 2 backend for better performance
3. 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

Technical Reference

For contributor-level details (installer architecture, profile system, AI-powered setup):

• Installation Guide → docs/installation/index.md
• Forking Guide → docs/installation/forking.md

See also

• [[Docker]]
• [[Ruby]]
• [[Jekyll]]
• [[front-matter]]
• [[Customization]]