Download Perkeep

The latest release is 0.12 (“Toronto”), released 2025-11-11.

Or, using the latest code from git:

$ git clone https://github.com/perkeep/perkeep.git perkeep.org

Build

If you have downloaded one of the binary archives (for Darwin, Linux, or Windows), skip this section.

Download and install Go if you don’t have that installed already. Perkeep requires Go 1.25 or newer.

$ cd perkeep.org
$ go run make.go

Download

Binaries are available at https://github.com/perkeep/perkeep/releases/tag/v0.12 for Linux and Windows. (macOS binaries are omitted from this release due to signing + notarization requirements by macOS which we haven’t set up automation for yet)

Containers are available at https://github.com/perkeep/perkeep/pkgs/container/perkeep

Getting started

Once you’ve successfully built the Perkeep components, you can run the server with:

$ ./bin/perkeepd

This will create configuration and public/private key information in $HOME/.config/perkeep/ (or where pk env configdir points). You can start and stop perkeepd as you see fit.

You’re done setting up! Running perkeepd should open a new browser window pointed at your keep where you can start uploading and interacting with data.

Developers typically use the ./bin/devcam wrapper to isolate their test environment from their production instance and to simplify common development tasks. If you have questions, you can ask the mailing list.

Release Notes

Previous release notes: