Skip to main content

Getting Started

A ready-to-use development environment that works the same on Windows, Mac, and Linux.

Prerequisites​

All Platforms​

  1. Docker - Install Rancher Desktop (free and open source)

    • Why not Docker Desktop? Docker Desktop requires a paid subscription for companies. Rancher Desktop is 100% free.

  2. VS Code with Dev Containers extension

Windows Users​

Before installing Rancher Desktop, you need WSL (Windows Subsystem for Linux):

# Run in PowerShell as Administrator
wsl --install

Restart your computer after the command completes, then install Rancher Desktop.

Note: This works on Windows 10 (build 19041+) and Windows 11.

Mac/Linux Users​

Just install Rancher Desktop - no additional setup needed.

Installation (3 Steps)​

Step 1: Install in Your Project​

Open a terminal in your project directory and run:

Mac/Linux:

curl -fsSL https://raw.githubusercontent.com/terchris/devcontainer-toolbox/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/terchris/devcontainer-toolbox/main/install.ps1 | iex

If you see "running scripts is disabled on this system":

powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/terchris/devcontainer-toolbox/main/install.ps1 | iex"

This creates a .devcontainer/devcontainer.json in your project and pulls the pre-built container image.

Step 2: Open in VS Code and Reopen in Container​

Open the project in VS Code. When prompted "Reopen in Container", click it.

The container starts in seconds since the image was already pulled during install. Run dev-setup inside the container to install development tools.

That's it! You're ready to start developing.

What's Next?​

Run dev-help in the terminal to see all available commands.