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.
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.
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.service3. Initialize and start
Choose the admin password when prompted. Initialize authentication once per catalog. Run both probes after starting the unit.
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.
ssh -N -L 7337:127.0.0.1:7337 graph-hostSign in as admin, then create a model and add your first data source. For shared access, see HTTPS and access control.