Installation¶

Download¶

Each version is published on the repository's Releases page, with one file per platform:

The archive holds two self-contained executables: SMAD-X, the simulator, and SMAD-X Studio, lab authoring for trainers. The .NET runtime, graphics libraries, teaching sheets, labs and the PDF report fonts are included. Nothing to install.

1. Unzip the archive anywhere.
2. Run SMAD-X.exe (Windows) or SMAD-X (Linux, macOS); SMAD-X.Studio the same way.

chmod +x SMAD-X SMAD-X.Studio && xattr -d com.apple.quarantine SMAD-X SMAD-X.Studio

chmod +x SMAD-X SMAD-X.Studio

On first launch, SMAD-X opens the contoso.com sample domain, with three AD sites.

Version and updates¶

The version is shown in Help > About. It is defined in a single place in the source code (<Version> in Directory.Build.props, shared by SMAD-X and SMAD-X Studio), and each release matches a vX.Y.Z tag.

Build from source¶

Prerequisite: the .NET 10 SDK.

git clone https://github.com/JM2K69/SMAD-X.git
cd SMAD-X
dotnet run --project SMAD-X/SMAD-X.csproj

To produce the self-contained executable, like the release:

dotnet publish SMAD-X/SMAD-X.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

Same command with SMAD-X.Studio/SMAD-X.Studio.csproj for Studio. Replace win-x64 with linux-x64, osx-x64 or osx-arm64 as needed.

Tests¶

dotnet test SMAD-X.slnx

The PowerShell import script tests really run its functions: PowerShell 7 (pwsh) must be installed, plus Windows PowerShell 5.1 on Windows. A test fails if they are missing, rather than passing without checking anything.

Error log¶

An unexpected error is shown in a window and written to the log folder: