[← Home]

DOCS

Install LastDB

Install the local LastDB node and the daily apps on macOS.

Last reviewed: 2026-08-18. Product status: alpha.

[Docs index] [Install] [Apps] [Developer]

FULL STACK INSTALL

This path installs LastDB plus the common first-party app CLIs and the read-only LastDB Browser UI (its launcher is linked as lastdb-browser).

Paste-safe for macOS zsh (no # comment lines — interactive zsh does not treat them as comments). Skip the Bun line if already installed; skip the node line if npm --version already works. Needs Homebrew + Apple Silicon.

curl -fsSL https://bun.sh/install | bash
export PATH="$HOME/.bun/bin:$HOME/.local/bin:$PATH"
brew install node

test "$(uname -m)" = "arm64" || { echo "LastDB needs macOS Apple Silicon" >&2; exit 1; }
for tool in brew git bun node npm; do command -v "$tool" >/dev/null || { echo "Missing $tool" >&2; exit 1; }; done
node --version
git --version

git clone https://github.com/EdgeVector/last-stack ~/.last-stack
~/.last-stack/setup
~/.last-stack/bin/last-stack-install-apps

brew services start lastdb
lastdb status
curl --fail --silent --show-error --unix-socket ~/.lastdb/data/folddb.sock http://localhost/health
brain init --grant-consent
kanban init
situations init
lastsecrets init
org init
search init --quiet

The installer prints RESULT: PASS or RESULT: FAIL. Stop on a failure.

Apps install by proof (LastDB 0.23.5+). last-stack-install-apps asks lastdb app resolve for each app: the newest app commit the LastDB app registry proved with the LastDB build on your machine, read from a static signed index on the Homebrew tap (no account, no live service). It checks out that commit, not main. lastdb app list shows the shelf; lastdb app install brain installs one app; lastdb app upgrade brain kanban situations moves to the newest proved pair. Each night the release loop installs every app at a fixed commit in an isolated home and runs this path; after a 24 h clean soak it publishes that set to brew stable and to the index together. If no row is proved with your build yet, install stops and names the remedy (brew upgrade lastdb, or wait for the next proved set).

DATABASE ONLY

brew install edgevector/lastdb/lastdb
brew services start lastdb

The Homebrew package ships lastdbd, the local daemon, and lastdb, the control CLI.

CONFIRM IT IS RUNNING

HEALTH

curl -s --unix-socket ~/.lastdb/data/folddb.sock \
  http://localhost/health

Expect {"status":"ok"}.

VERSIONS

lastdb status
lastdb --version
lastdbd --version

The owner socket is ~/.lastdb/data/folddb.sock. TCP :9001 is retired.

WHAT IS NOT INCLUDED

No desktop app, DMG, or file-ingestion product surface ships in the current Homebrew path. Use the local node plus app CLIs.

RELATED DOCS

Use

Daily Loop

Brain for durable context, Kanban for live work, MCP for agents.

Operate

Node Health

Health checks, status, socket expectations, and the safe restart boundary.