Skip to content

Setup

This tutorial runs in your local terminal. Install the .NET 10 SDK first, then install the B2R2 launcher as a .NET global tool.

B2R2 tutorial scripts and tools require the .NET 10 SDK. Installing the SDK is enough; you do not need a separate runtime installation.

Use Microsoft’s official pages for the current installer and OS-specific instructions:

Check the SDKs available on your machine:

Terminal window
dotnet --info
dotnet --list-sdks
Install the latest .NET SDK with dotnet-install

If your package manager provides an older SDK than the latest .NET 10 SDK, you can install the latest SDK directly with Microsoft’s dotnet-install.sh script:

Terminal window
curl -sSL https://dot.net/v1/dotnet-install.sh -o dotnet-install.sh
bash dotnet-install.sh --channel 10.0 --quality GA

The script installs dotnet under $HOME/.dotnet. Add both the SDK directory and the .NET global tools directory to PATH:

Terminal window
export DOTNET_ROOT="$HOME/.dotnet"
export PATH="$HOME/.dotnet:$HOME/.dotnet/tools:$PATH"

Then verify the installed SDK:

Terminal window
dotnet --info
dotnet --list-sdks

Install the B2R2 launcher from NuGet as a .NET global tool:

Terminal window
dotnet tool install --global B2R2.RearEnd.Launcher

If B2R2 is already installed, update it instead:

Terminal window
dotnet tool update --global B2R2.RearEnd.Launcher

.NET global tools are installed into your user profile. If b2r2 is not found after installation, make sure the global tool directory is on PATH.

Windows PowerShell:

Terminal window
$env:PATH += ";$env:USERPROFILE\.dotnet\tools"

macOS and Linux:

Terminal window
export PATH="$PATH:$HOME/.dotnet/tools"

For a permanent setup, add the matching line to your shell profile.

Run the launcher help command from any local terminal:

Terminal window
b2r2 --help

Download the tutorial archive from the setup page:

Download tutorial.zip

After extracting the archive, you should have these directories:

cli/
findme/
evalme/
loginme/

The CLI tools page uses the cli/ directory. Each problem page uses the matching findme/, evalme/, or loginme/ directory.

dotnet not found: restart the terminal after installation, then confirm that the SDK install directory is on PATH.

b2r2 not found: add the .NET global tool directory to PATH, or reinstall the tool with dotnet tool install --global B2R2.RearEnd.Launcher.