# Download Perkeep

The latest release is [0.10 ("Bellingham")](/doc/release/0.10), released 2018-05-02.

Or, using the latest code from git:

    $ cd $GOPATH/src
    $ 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](http://golang.org/doc/install) if you don't
have that installed already. As of revision
[2e46fca5cc](https://github.com/perkeep/perkeep/commit/2e46fca5cc1179dbd90bec49fec3870e6eca6c45),
Perkeep requires [Go 1.10 or newer](https://golang.org/dl/).

Build Perkeep by making sure you git cloned it to a directory named
"`perkeep.org`" and that directory is in the right place in your
`$GOPATH`. If you haven't set `$GOPATH` explicitly, then Go uses
`$HOME/go` by default, which means your `perkeep.org` directory should
be at `$HOME/go/src/perkeep.org`. Then from that `perkeep.org`
directory, run:

    $ 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](/doc/server-config) 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](https://groups.google.com/group/camlistore).

## Synology

We are also starting to [provide packages](/doc/synology) for Synology appliances.

## 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](https://play.google.com/store/apps/details?id=org.camlistore).
A [debug version](https://storage.googleapis.com/camlistore-release/android/app-debug.apk)
is regularly built and uploaded.

## Release Notes

Previous release notes:

-   [0.10 ("Bellingham")](/doc/release/0.10), 2018-05-02
-   [2017-05-05](docs/release/monthly/2017-05-05.html)
-   [2017-03-01](docs/release/monthly/2017-03-01.html)
-   [0.9 ("Astrakhan")](/doc/release/0.9), 2015-12-30
-   [0.8 ("Tokyo")](/doc/release/0.8), 2014-08-03
-   [0.7 ("Brussels")](/doc/release/0.7), 2014-02-27
-   [0.6 ("Cannon Beach")](/doc/release/0.6), 2013-12-25
-   [0.5 ("Castletownbere")](/doc/release/0.5), 2013-09-21
-   [0.4 ("Oyens")](/doc/release/0.4), 2013-08-26
-   [0.3 ("Glebe")](/doc/release/0.3), 2013-07-28
-   [0.2 ("Portland")](/doc/release/0.2), 2013-06-22
-   [0.1 ("Grenoble")](/doc/release/0.1), 2013-06-11