README: PATH step and a Linux (Debian/Ubuntu) quick start

Adds the copy-paste prerequisites for Linux (Docker group, Go from go.dev,
OpenCode), the PATH line for the installed CLI, and enable-linger so the
systemd --user service survives logout.
This commit is contained in:
2026-11-02 18:17:16 +00:00
parent 37b67c84df
commit b535e9a8f3
+33 -2
View File
@@ -34,8 +34,39 @@ compiler, a **running Docker** (the web app is built in Docker; the install
refuses without it) and an existing OpenCode on `PATH`. The installer never
installs these for you. See [Installation](docs/install.md).
Then open the URL the installer prints (default `http://localhost:8082/`) and
sign in with the password you chose.
Then put the CLI on your `PATH`, open the URL the installer prints (default
`http://localhost:8082/`) and sign in with the password you chose:
```sh
export PATH="$HOME/.local/share/pipelines/bin:$PATH" # add to ~/.bashrc or ~/.zshrc
pipelines status
```
### Linux quick start (Debian/Ubuntu)
```sh
# Prerequisites: git, curl, a C compiler, Python 3, Node.js 18+ and Docker.
sudo apt update
sudo apt install -y git curl build-essential python3 nodejs npm docker.io
sudo usermod -aG docker "$USER" # then log out and back in (or: newgrp docker)
# Go: the version in go.mod is newer than most distro packages; use go.dev.
curl -fsSL "https://go.dev/dl/$(curl -fsSL 'https://go.dev/VERSION?m=text' | head -1).linux-amd64.tar.gz" \
| sudo tar -C /usr/local -xz
export PATH="/usr/local/go/bin:$PATH"
# OpenCode (required: it runs pipeline stages and chat by default).
curl -fsSL https://opencode.ai/install | bash
git clone https://git.a-wan.net/alan/pipelines.git && cd pipelines
./install
# Keep the server running after you log out (systemd --user service).
sudo loginctl enable-linger "$USER"
```
Check `node --version` is 18 or newer (older distros: install Node from
nodejs.org or NodeSource). On ARM machines use `linux-arm64` in the Go URL.
### Set up harnesses