Linux
macOS · Linux · Windows · Containers · iOS and iPadOS · Android · ChromeOS · Browser · Node (WebAssembly)
potluckdb ships four Linux targets: x86_64 and arm64, each with glibc and musl. The machine’s C library determines which artifact a package manager selects. The tables name each artifact.
Requirements
Section titled “Requirements”glibc 2.28 or newer, or musl 1.2 or newer, on x86_64 or arm64.
What ships
Section titled “What ships”| Language | Package | What it selects here | Pages |
|---|---|---|---|
| Python | potluckdb on PyPI | wheels manylinux_2_28_x86_64, manylinux_2_28_aarch64, musllinux_1_2_x86_64, musllinux_1_2_aarch64 | Install · Quickstart |
| JavaScript | @potluckdb/potluckdb on npm | runtime packages @potluckdb/potluckdb-linux-x64-gnu, @potluckdb/potluckdb-linux-arm64-gnu, @potluckdb/potluckdb-linux-x64-musl, @potluckdb/potluckdb-linux-arm64-musl | Install · Quickstart |
| TypeScript | @potluckdb/potluckdb on npm | runtime packages @potluckdb/potluckdb-linux-x64-gnu, @potluckdb/potluckdb-linux-arm64-gnu, @potluckdb/potluckdb-linux-x64-musl, @potluckdb/potluckdb-linux-arm64-musl | Install · Quickstart |
| Java | dev.potluckdb:potluckdb-jvm | runtime resources linux-x86_64, linux-arm64 | Install · Quickstart |
| Kotlin | dev.potluckdb:potluckdb-jvm | runtime resources linux-x86_64, linux-arm64 | Install · Quickstart |
| Dart | potluckdb on pub.dev | the requested target’s C SDK archive, verified by the build hook (GNU only) | Install · Quickstart |
| Flutter | potluckdb on pub.dev | the requested target’s C SDK archive, verified by the build hook (GNU only) | Install · Quickstart |
| Go | github.com/potluckdb/potluckdb-go | the static runtime library the module carries for linux/amd64, linux/arm64 | Install · Quickstart |
| Rust | potluckdb on crates.io | engine catalog rows linux-x86_64-gnu, linux-arm64-gnu, linux-x86_64-musl, linux-arm64-musl | Install · Quickstart |
| C# (.NET) | potluckdb on NuGet | runtime identifiers linux-x64, linux-arm64, linux-musl-x64, linux-musl-arm64 | Install · Quickstart |
| C++ | the C SDK archive | the C SDK archive of the target | Install · Quickstart |
| C | the C SDK archive | the C SDK archive of the target | Install · Quickstart |
Not shipped for this platform: Swift, Objective-C.
| Target | Python wheel | npm runtime package | Rust crate | NuGet RID | JVM resource | Go module library | C SDK archive |
|---|---|---|---|---|---|---|---|
linux-x86_64-gnu | manylinux_2_28_x86_64 | @potluckdb/potluckdb-linux-x64-gnu | potluckdb | linux-x64 | linux-x86_64 | linux/amd64 | potluckdb-c-sdk-0.1.0-linux-x86_64-gnu.zip |
linux-arm64-gnu | manylinux_2_28_aarch64 | @potluckdb/potluckdb-linux-arm64-gnu | potluckdb | linux-arm64 | linux-arm64 | linux/arm64 | potluckdb-c-sdk-0.1.0-linux-arm64-gnu.zip |
linux-x86_64-musl | musllinux_1_2_x86_64 | @potluckdb/potluckdb-linux-x64-musl | potluckdb | linux-musl-x64 | — | — | potluckdb-c-sdk-0.1.0-linux-x86_64-musl.zip |
linux-arm64-musl | musllinux_1_2_aarch64 | @potluckdb/potluckdb-linux-arm64-musl | potluckdb | linux-musl-arm64 | — | — | potluckdb-c-sdk-0.1.0-linux-arm64-musl.zip |
Install
Section titled “Install”Each language installs from its registry. The installation pages give each command. pip selects a wheel for the machine’s C library. npm selects a runtime package by os, cpu and libc.
Java and Kotlin support glibc only because the JVM package has no musl runtime. Go also supports glibc only. Its module contains its libraries, and Go build constraints cannot distinguish glibc from musl. The module therefore contains only the glibc library. The containers page explains the resulting image choices.
Quickstart
Section titled “Quickstart”Each quickstart is self-contained. Two databases represent a laptop and phone sharing one remote. They modify the same row before either synchronizes, then reach the same state. See Concepts for these terms.
The shortest route here uses Python:
- Install the package.
- Save the quickstart as
quickstart.py. - Run
python quickstart.py.
It prints Use query for this statement. and then quickstart: ok.
Every language shipped here has a quickstart: Python, JavaScript, TypeScript, Java, Kotlin, Dart, Flutter, Go, Rust, C# (.NET), C++, C.
Analytics
Section titled “Analytics”Analytical reads use DuckDB. No core package contains it. Python, Node and Rust install it through a package or crate feature.
Other languages load the library listed for this platform on the analytics engine page, with its URL and digest. Name that library in the open options. Each language’s installation page gives the exact line.
Verified by the release
Section titled “Verified by the release”Each release candidate builds every target in the table and passes every required check of the release matrix before promotion. The packages that this page names are the packages that the release tested.
Each release also runs framework quickstarts on this platform: Electron, Tauri, Qt, Flutter. Each framework page describes its verification.