Install
A .NET tool, or a single executable for your platform.
.NET tool
dotnet tool install --global Badger.SqlMigrate
bsm --version
Requires the .NET 10 SDK. Pin a version per repository with a local tool manifest (dotnet new tool-manifest, then dotnet tool install Badger.SqlMigrate) and run it as dotnet bsm.
Standalone executable
Download the archive for your platform and put bsm on your PATH. The executables are self-contained: no .NET runtime needed. Builds exist for Windows (x64, Arm64), macOS (Apple silicon, Intel) and Linux (x64, Arm64, Alpine x64), plus a portable build for any OS with the .NET 10 runtime.
Check it works
bsm --help
bsm doctor -C path/to/project -e dev # configuration, sign-in, connection, journal
Platform notes
- macOS: binaries are signed ad hoc but not notarized; clear the quarantine flag once with
xattr -d com.apple.quarantine bsm. - Linux: Kerberos (integrated) authentication needs the system GSSAPI library. Entra interactive sign-in caches tokens with libsecret; without it, use device code or set
entra.allowUnencryptedTokenCache. - Windows: Windows authentication uses SSPI; the Windows certificate store, CNG and CSP key stores for Always Encrypted are available.