Install on Linux

Set up a standalone GraphLake service on Debian 12 or a compatible glibc-based Linux host with systemd.

On this page

1. Download and verify

Use a host with sudo access and glibc 2.36 or newer. The v1.1.1 release includes the CLI, the admin service, the built workbench, and systemd assets. Download the archive and checksum matching uname -m.

Or use the following commands in a download directory. Continue after the checksum reports OK. Keep the same shell for the installation steps.

Shell
uname -m
artifact=graphlake-v1.1.1-82a661f2a132-linux-$(uname -m)
base=https://github.com/SamuelSupe/graphlake/releases/download/v1.1.1
curl -fLO "$base/$artifact.tar.gz"
curl -fLO "$base/$artifact.tar.gz.sha256"
sha256sum -c "$artifact.tar.gz.sha256"

2. Install the service

Use these commands for a fresh installation. For an existing service, follow the upgrade procedure first. If you downloaded the files manually, set artifact to the archive filename without .tar.gz and verify the checksum before continuing. The release directory holds the binaries and UI. The catalog under /var/lib/graphlake holds models and service state.

Shell
release_dir="/opt/graphlake/releases/${artifact#graphlake-}"
if ! id graphlake >/dev/null 2>&1; then
  sudo useradd --system --user-group --home-dir /var/lib/graphlake \
    --shell /usr/sbin/nologin graphlake
fi
sudo install -d -m 0755 /opt/graphlake/releases
sudo install -d -m 0700 -o graphlake -g graphlake \
  /var/lib/graphlake /var/lib/graphlake/catalog
sudo install -d -m 0750 /etc/graphlake
sudo mkdir -- "$release_dir"
sudo tar -xzf "$artifact.tar.gz" --strip-components=1 -C "$release_dir"
sudo ln -s "$release_dir" /opt/graphlake/current.next
sudo mv -Tf /opt/graphlake/current.next /opt/graphlake/current
sudo install -m 0644 /opt/graphlake/current/graphlake.service \
  /etc/systemd/system/graphlake.service

3. Initialize and start

Choose the admin password when prompted. Initialize authentication once per catalog. Run both probes after starting the unit.

Shell
sudo -u graphlake /opt/graphlake/current/bin/graphlake-admin \
  --catalog-dir /var/lib/graphlake/catalog auth init
sudo systemctl daemon-reload
sudo systemctl enable --now graphlake
curl -fsS http://127.0.0.1:7337/healthz
curl -fsS http://127.0.0.1:7337/readyz

/healthz reports the running build. /readyz reports service readiness. If startup fails, inspect sudo journalctl -u graphlake -n 80 --no-pager.

4. Open the workbench

Open http://127.0.0.1:7337 on the service host. From another machine, replace graph-host with your SSH host, run the tunnel below, and open the same URL on your computer.

Shell
ssh -N -L 7337:127.0.0.1:7337 graph-host

Sign in as admin, then create a model and add your first data source. For shared access, see HTTPS and access control.