Skip to main content
gaal ships as a single static binary. Pick the install method that matches your environment.

​
Quick install (macOS / Linux)

Installs the latest release to ~/.local/bin/gaal. Make sure ~/.local/bin is on your $PATH.

​
Pin a version

​
Install elsewhere

​
Verbose output

​
Help

​
With Go

If you have a Go 1.26+ toolchain installed:
The binary lands in $GOBIN (or $GOPATH/bin if GOBIN is unset).

​
From source

Requires Go 1.26+ and make.
The binary is written to dist/gaal. Move it to your $PATH:

​
Verify the install

If the command isn’t found, ~/.local/bin is probably not on your $PATH. Add this to your shell profile:

​
Shell completion

gaal ships completion scripts for bash, zsh, fish, and PowerShell. See the gaal completion reference.

​
Next

Quickstart

Run your first sync in five minutes.

How gaal works

Understand the model before you write YAML.