Platform Selection
Foundry is distributed as a family of platform-specific NuGet packages. Each package targets a particular operating system and architecture and includes the native database drivers required for that platform.
Available Packages
| Package | Platform | Architecture |
|---|---|---|
YndigoBlue.Foundry |
Any (cross-platform) | x64 / Arm64 |
YndigoBlue.Foundry.Windows |
Windows | x64 |
YndigoBlue.Foundry.Linux |
Linux | x64 |
YndigoBlue.Foundry.MacOS |
macOS | Arm64 |
YndigoBlue.Foundry.RaspberryPi |
Linux (Raspberry Pi) | Arm64 |
Database Support by Package
| Database | Cross‑Platform | Windows | Linux | macOS | Raspberry Pi |
|---|---|---|---|---|---|
| MySQL | ✓ | ✓ | ✓ | ✓ | ✓ |
| Oracle | ✓ | ✓ | ✓ | ✓ | ✓ |
| PostgreSQL | ✓ | ✓ | ✓ | ✓ | ✓ |
| SQLite | — | ✓ | ✓ | ✓ | ✓ |
| SQL Server | ✓ | ✓ | ✓ | ✓ | ✓ |
| Teradata | ✓ | ✓ | ✓ | ✓ | ✓ |
| IBM DB2 LUW | — | ✓ | ✓ | ✓ | — |
Important
IBM DB2 requires the IBM Data Server Driver (clidriver), which is bundled with the Windows, Linux, and macOS packages. The cross-platform and Raspberry Pi packages do not include it.
SQLite is excluded from the cross-platform package because the native SQLite library must be compiled for each operating system.
Choosing a Package
Use YndigoBlue.Foundry (cross-platform) when:
- You are working in a mixed team across operating systems
- Your CI/CD agent platform varies or is not fixed
- You only need MySQL, Oracle, PostgreSQL, SQL Server, or Teradata
Use a platform-specific package when:
- You need IBM DB2 support
- You need SQLite support
- You want to ensure the exact native driver version is locked to the package
Installing
# Cross-platform
dotnet tool install -g YndigoBlue.Foundry
# Windows
dotnet tool install -g YndigoBlue.Foundry.Windows
# Linux
dotnet tool install -g YndigoBlue.Foundry.Linux
# macOS (Apple Silicon)
dotnet tool install -g YndigoBlue.Foundry.MacOS
# Raspberry Pi
dotnet tool install -g YndigoBlue.Foundry.RaspberryPi
All packages are available from the YndigoBlue NuGet feed. See Getting Started for instructions on adding the feed.
DB-Type Identifiers
When using --db or foundry create, the following identifiers are accepted (case-insensitive):
| Database | Accepted identifiers |
|---|---|
| IBM DB2 | DB2, db2 |
| MySQL | MySQL, mysql |
| Oracle | Oracle, oracle |
| PostgreSQL | PostgreSQL, PostgreSql, postgres, pg |
| SQLite | Sqlite, sqlite |
| SQL Server | SQLServer, SqlServer, mssql, sql-server |
| Teradata | Teradata, teradata |
Note
Identifiers that name databases not supported by the installed package are rejected at startup with a clear error message indicating which types are available in the current build.