perkeep/website/content/download.md

2.3 KiB

Download Perkeep

The latest release is 0.11 ("Seattle"), released 2020-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. As of revision cb96bb8bd3, Perkeep requires Go 1.19 or newer.

$ cd perkeep.org
$ go run make.go

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.

Mobile

The project also has an Android app to upload your files (mainly photos) to a Perkeep instance. The official build is on Google Play. A debug version is regularly built and uploaded.

Release Notes

Previous release notes: