Unable to load DuckDB native library in Metabase Docker

[deepapt]

I am running Metabase v0.56.5 in Docker and attempting to connect to DuckDB using the community DuckDB driver. When trying to connect, I get the following error:

Caused by: java.lang.NoClassDefFoundError: Could not initialize class org.duckdb.DuckDBNative
    at org.duckdb.DuckDBConnection.newConnection(DuckDBConnection.java:58)
    at org.duckdb.DuckDBDriver.connect(DuckDBDriver.java:117)
    at metabase.plugins.jdbc_proxy$proxy_driver$reify__98695.connect(jdbc_proxy.clj:37)
    at java.sql/java.sql.DriverManager.getConnection(Unknown Source)
    at java.sql/java.sql.DriverManager.getConnection(Unknown Source)
    at clojure.java.jdbc$get_driver_connection.invokeStatic(jdbc.clj:271)
    at clojure.java.jdbc$get_driver_connection.invoke(jdbc.clj:250)
    at clojure.java.jdbc$get_connection.invokeStatic(jdbc.clj:411)
    at clojure.java.jdbc$get_connection.invoke(jdbc.clj:274)
    at clojure.java.jdbc$db_query_with_resultset_STAR_.invokeStatic(jdbc.clj:1111)
    at clojure.java.jdbc$db_query_with_resultset_STAR_.invoke(jdbc.clj:1093)
    at clojure.java.jdbc$query.invokeStatic(jdbc.clj:1182)
    at clojure.java.jdbc$query.invoke(jdbc.clj:1144)
    at clojure.java.jdbc$query.invokeStatic(jdbc.clj:1160)
    at clojure.java.jdbc$query.invoke(jdbc.clj:1144)
    at metabase.driver.sql_jdbc.connection$can_connect_with_spec_QMARK_.invokeStatic(connection.clj:368)
    at metabase.driver.sql_jdbc.connection$can_connect_with_spec_QMARK_.invoke(connection.clj:365)
    at metabase.driver.sql_jdbc.connection$can_connect_QMARK_$fn__95712.invoke(connection.clj:377)
    at metabase.driver.sql_jdbc.connection$do_with_connection_spec_for_testing_connection$fn__95694.invoke(connection.clj:353)
    at metabase.driver.sql_jdbc.connection.ssh_tunnel$do_with_ssh_tunnel.invokeStatic(ssh_tunnel.clj:152)
    at metabase.driver.sql_jdbc.connection.ssh_tunnel$do_with_ssh_tunnel.invoke(ssh_tunnel.clj:141)
    at metabase.driver.sql_jdbc.connection$do_with_connection_spec_for_testing_connection.invokeStatic(connection.clj:348)
    at metabase.driver.sql_jdbc.connection$do_with_connection_spec_for_testing_connection.invoke(connection.clj:344)
    at metabase.driver.sql_jdbc.connection$can_connect_QMARK_.invokeStatic(connection.clj:376)
    at metabase.driver.sql_jdbc.connection$can_connect_QMARK_.invoke(connection.clj:372)
    at metabase.driver.sql_jdbc$fn__97952.invokeStatic(sql_jdbc.clj:52)
    at metabase.driver.sql_jdbc$fn__97952.invoke(sql_jdbc.clj:50)
    at clojure.lang.MultiFn.invoke(MultiFn.java:234)
    at metabase.driver.util$can_connect_with_details_QMARK_$fn__55932.invoke(util.clj:135)
    at clojure.core$binding_conveyor_fn$fn__5844.invoke(core.clj:2047)
    at clojure.lang.AFn.call(AFn.java:18)
    at java.base/java.util.concurrent.FutureTask.run(Unknown Source)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source)
    ... 1 more

Docker image: METABASE_IMAGE_TAG=v0.56.5

[staticlibs]

Hi, thanks for the report!

AFAICS, Metabase Docker images do not include DuckDB by default:

Can you provide more details how are you loading the DuckDB JDBC driver into the Metabase Docker container and which exact JAR file (version and arch) do you use?

Metabase Docker images are based on Alpine Linux, so it requires to use the JDBC driver build for Musl libc, the one with linux_amd64_musl classifier.

Also, these images do not include C++ standard library, so apk add libstdc++ needs to be run there before loading the driver.

[deepapt]

Hi, docker-compose.yaml loads all plugins as follows: duckdb.metabase-driver.jar is loaded from this location <https://github.com/motherduckdb/metabase_duckdb_driver/releases/tag/0.4.1> environment: - MB_PLUGINS_DIR=plugins volumes: - ./plugins:/plugins ls -l plugins/ total 694128

…

-rw-r--r-- 1 pt staff 28330266 Sep 10 12:52 athena.metabase-driver.jar

-rw-r--r-- 1 pt staff 46571001 Sep 10 12:52 bigquery-cloud-sdk.metabase-driver.jar

-rw-r--r-- 1 pt staff 2804435 Sep 10 12:51 clickhouse.metabase-driver.jar

-rw-r--r-- 1 pt staff 22287441 Sep 10 12:52 databricks.metabase-driver.jar

-rw-r--r-- 1 pt staff 8025500 Sep 10 12:51 druid-jdbc.metabase-driver.jar

-rw-r--r-- 1 pt staff 525961 Sep 10 12:51 druid.metabase-driver.jar

-rw-r--r--@ 1 pt staff 76349972 Sep 17 12:00 duckdb.metabase-driver.jar

-rw-r--r-- 1 pt staff 48906376 Sep 10 12:52 hive-like.metabase-driver.jar

-rw-r--r-- 1 pt staff 3422921 Sep 10 12:51 mongo.metabase-driver.jar

-rw-r--r-- 1 pt staff 144147 Sep 10 12:51 oracle.metabase-driver.jar

-rw-r--r-- 1 pt staff 14062676 Sep 10 12:52 presto-jdbc.metabase-driver.jar

-rw-r--r-- 1 pt staff 2285146 Sep 10 12:51 redshift.metabase-driver.jar

-rw-r--r-- 1 pt staff 3497984 Sep 10 12:47 sample-database.db.mv.db

-rw-r--r-- 1 pt staff 60981882 Sep 10 12:52 snowflake.metabase-driver.jar

-rw-r--r-- 1 pt staff 70268 Sep 10 12:51 sparksql.metabase-driver.jar

-rw-r--r-- 1 pt staff 14416913 Sep 10 12:52 sqlite.metabase-driver.jar

-rw-r--r-- 1 pt staff 1659470 Sep 10 12:52 sqlserver.metabase-driver.jar

-rw-r--r-- 1 pt staff 13085650 Sep 10 12:52 starburst.metabase-driver.jar

-rw-r--r-- 1 pt staff 85815 Sep 10 12:52 vertica.metabase-driver.jar Thanks, -Deepa R

On Wed, Sep 17, 2025 at 4:42 PM Alex Kasko ***@***.***> wrote: *staticlibs* left a comment (duckdb/duckdb-java#391) <#391 (comment)> Hi, thanks for the report! AFAICS, Metabase Docker images do not include DuckDB by default: 01.png (view on web) <https://github.com/user-attachments/assets/f53d7543-b812-4322-8301-86cc6277c596> Can you provide more details how are you loading the DuckDB JDBC driver into the Metabase Docker container and which exact JAR file (version and arch) do you use? Metabase Docker images are based on Alpine Linux, so it requires to use the JDBC driver build for Musl libc, the one with linux_amd64_musl classifier. Also, these images do not include C++ standard library, so apk add libstdc++ needs to be run there before loading the driver. — Reply to this email directly, view it on GitHub <#391 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AU3WO32DEY74G2V6EA4UA7D3TE6Y5AVCNFSM6AAAAACGXSTXM6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTGMBSGUYDANZQGM> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[staticlibs]

@deepapt

Please make sure that libstdc++ package is installed inside the Metabase container image:

# cat /etc/os-release 
NAME="Alpine Linux"
ID=alpine
VERSION_ID=3.22.1
PRETTY_NAME="Alpine Linux v3.22"
HOME_URL="https://alpinelinux.org/"
BUG_REPORT_URL="https://gitlab.alpinelinux.org/alpine/aports/-/issues"

# apk add libstdc++
fetch https://dl-cdn.alpinelinux.org/alpine/v3.22/main/x86_64/APKINDEX.tar.gz
fetch https://dl-cdn.alpinelinux.org/alpine/v3.22/community/x86_64/APKINDEX.tar.gz
(1/2) Installing libgcc (14.2.0-r6)
(2/2) Installing libstdc++ (14.2.0-r6)
OK: 172 MiB in 91 packages

# apk list | grep libstdc++
libstdc++-14.2.0-r6 x86_64 {gcc} (GPL-2.0-or-later AND LGPL-2.1-or-later) [installed]
libstdc++-dev-14.2.0-r6 x86_64 {gcc} (GPL-2.0-or-later AND LGPL-2.1-or-later)