BlameDocs
WebsiteCloudDownload

Linux

Set up Docker for Blame's previews and project services, and find the logs on Linux.

On Linux, worktrees stay native, and previews and project services run in Docker on your machine. Blame needs Docker Engine with the Compose plugin, on x86_64.

"Missing development requirements"

Blame uses Docker Engine and Docker Compose from your system. Install Docker Engine with the Docker Compose plugin (Docker's instructions), start it, then choose Check again.

"Docker Engine is not running"

Start Docker Engine, then check again.

"Docker Engine is running, but Blame cannot access its socket"

Add your user to the docker group, or set up rootless Docker, then check again. Docker's post-installation steps explain both.

The AppImage does not start

Make it executable first:

chmod +x blame-linux-x86_64.AppImage && ./blame-linux-x86_64.AppImage

On Arch Linux, use the AppImage until the AUR package is published.

Logs

  • The app's log: ~/.config/dev.blame.desktop/logs/blame-live.log
  • Each story's setup, agent, and merge logs: .blame/logs/ in its worktree
  • A story's preview: its Run logs

Still stuck?

Ask on Discord or in GitHub Discussions, or open an issue with your distribution, Blame version, and the relevant logs.

Edit this page on GitHub

Windows

SmartScreen warnings, WSL 2, Blame Runtime, and where the logs are on Windows.

FAQ

Answers to the questions people ask most about Blame.

On this page

"Missing development requirements""Docker Engine is not running""Docker Engine is running, but Blame cannot access its socket"The AppImage does not startLogsStill stuck?