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/helpers-no/devcontainer-toolbox/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/helpers-no/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/helpers-no/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.

Migrating from an Older Version​

If your project has an older .devcontainer/ folder with many files (Dockerfile, manage/, additions/), you can switch to the new image-based approach:

  1. Back up your current config:

    mv .devcontainer .devcontainer.old

  2. Run the installer again from your project directory:

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

  3. Your .devcontainer.extend/ and .devcontainer.secrets/ are preserved — all tool selections and credentials carry over.

  4. Delete the old backup when everything works:

    rm -rf .devcontainer.old

The new approach uses a pre-built image so your .devcontainer/ folder contains only devcontainer.json instead of 100+ files.

What's Next?​

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