From b83d1ccc4ec4bd474df05cae5000b8159e6bfa09 Mon Sep 17 00:00:00 2001 From: Chang Liu Date: Mon, 29 Sep 2025 18:05:58 -0400 Subject: [PATCH 1/2] Add instructions for hosting a custom extension server in air-gapped environments --- src/content/docs/extensions/index.mdx | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/src/content/docs/extensions/index.mdx b/src/content/docs/extensions/index.mdx index 1f199766..c536cc6e 100644 --- a/src/content/docs/extensions/index.mdx +++ b/src/content/docs/extensions/index.mdx @@ -120,3 +120,22 @@ UNINSTALL ; :::note[Note] Uninstalling a currently loaded extension won't affect the running database instance, but you won't be able to load it again in a new Kuzu instance until it's reinstalled. ::: + +Here's the reviewed and improved version: + +### Host your own extension server + +By default, Kuzu installs official extensions from `https://extension.kuzudb.com/`. However, if you are running Kuzu in an environment without internet access (e.g., an air-gapped environment), you can host your own extension server using Docker. + +The extension server is based on NGINX and is hosted on [GitHub](https://ghcr.io/kuzudb/extension-repo). You can pull the Docker image and run it in your environment: + +```bash +docker pull ghcr.io/kuzudb/extension-repo:latest +docker run -d -p 8080:80 ghcr.io/kuzudb/extension-repo:latest +``` + +In this example, the extension server will be available at `http://localhost:8080`. You can then install extensions from your server by appending the `FROM` clause to the `INSTALL` command: + +```cypher +INSTALL FROM 'http://localhost:8080/'; +``` From 6bb8a86c06386277a35e663c4fae358302c4cf1a Mon Sep 17 00:00:00 2001 From: Chang Liu Date: Mon, 29 Sep 2025 18:07:02 -0400 Subject: [PATCH 2/2] Remove redundant text and add instructions for hosting an extension server in air-gapped environments --- src/content/docs/extensions/index.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/src/content/docs/extensions/index.mdx b/src/content/docs/extensions/index.mdx index c536cc6e..7eecc6c1 100644 --- a/src/content/docs/extensions/index.mdx +++ b/src/content/docs/extensions/index.mdx @@ -121,8 +121,6 @@ UNINSTALL ; Uninstalling a currently loaded extension won't affect the running database instance, but you won't be able to load it again in a new Kuzu instance until it's reinstalled. ::: -Here's the reviewed and improved version: - ### Host your own extension server By default, Kuzu installs official extensions from `https://extension.kuzudb.com/`. However, if you are running Kuzu in an environment without internet access (e.g., an air-gapped environment), you can host your own extension server using Docker.