Installation

By Amr

Prerequisites and setup steps for running Zer0-Mistakes locally.

Estimated reading time: 1 minutes

• Share on Reddit
• Share on LinkedIn
• Share on Twitter

• ---

• Article Review Review article structure, metadata, and SEO
• Code Implementation Implement a feature with production-ready code
• Code Refactoring Refactor code for quality, readability, and performance
• Debugging Diagnose and fix issues in the code
• Documentation Generate or improve technical documentation
• Requirements Analysis Convert ideas into structured technical requirements
• System Design Design a scalable system architecture
• Test Generation Generate comprehensive tests for code
• Prompt Engineering Craft an effective AI prompt for this task

Edit on GitHub

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

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