Table of Contents

Installation

This is the recommended path for a new developer:

  1. install the runtime package for your database
  2. install the datalinq CLI
  3. generate models from your schema
  4. start querying and mutating through the generated model surface

Choose a Provider

DataLinq currently ships with two runtime provider packages:

  • DataLinq.MySql
    • use this for both MySQL and MariaDB
  • DataLinq.SQLite
    • use this for SQLite

There is no separate MariaDB runtime package. MariaDB support lives in DataLinq.MySql.

Install the Runtime Package

For MySQL or MariaDB:

dotnet add package DataLinq.MySql

For SQLite:

dotnet add package DataLinq.SQLite

Install the CLI

The CLI is used for configuration-driven tasks such as model generation and schema SQL generation.

dotnet tool install --global DataLinq.CLI

Target Frameworks

Current package and repo builds target:

  • .NET 8
  • .NET 9
  • .NET 10

If your application is on an older target framework, do not assume compatibility just because many .NET libraries happen to support it. DataLinq currently does not document that as a supported path.

What to Do Next

After installation, move straight to:

That is where the real onboarding starts, because DataLinq becomes useful once your generated model surface exists.