2017-12-15 17:57:42 +00:00
|
|
|
# Download Perkeep
|
2016-06-03 01:59:20 +00:00
|
|
|
|
2018-05-02 22:45:37 +00:00
|
|
|
The latest release is [0.10 ("Bellingham")](/doc/release/0.10), released 2018-05-02.
|
2016-06-03 01:59:20 +00:00
|
|
|
|
2018-04-30 23:31:22 +00:00
|
|
|
Or, using the latest code from git:
|
2016-06-03 01:59:20 +00:00
|
|
|
|
2018-04-30 23:31:22 +00:00
|
|
|
$ cd $GOPATH/src
|
2018-05-24 19:11:00 +00:00
|
|
|
$ git clone https://perkeep.googlesource.com/perkeep perkeep.org
|
2016-06-03 01:59:20 +00:00
|
|
|
|
2017-03-21 22:44:04 +00:00
|
|
|
## Build
|
|
|
|
|
|
|
|
|
|
If you have downloaded one of the binary archives (for Darwin, Linux, or
|
|
|
|
|
Windows), skip this section.
|
|
|
|
|
|
2016-06-03 01:59:20 +00:00
|
|
|
[Download and install Go](http://golang.org/doc/install) if you don't
|
|
|
|
|
have that installed already. As of revision
|
2018-01-06 03:49:59 +00:00
|
|
|
[2e46fca5cc](https://github.com/perkeep/perkeep/commit/2e46fca5cc1179dbd90bec49fec3870e6eca6c45),
|
2018-04-30 23:31:22 +00:00
|
|
|
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:
|
2016-06-03 01:59:20 +00:00
|
|
|
|
|
|
|
|
$ go run make.go
|
|
|
|
|
|
|
|
|
|
## Getting started
|
|
|
|
|
|
2017-12-15 17:57:42 +00:00
|
|
|
Once you've successfully built the Perkeep components, you can run
|
2016-06-03 01:59:20 +00:00
|
|
|
the server with:
|
|
|
|
|
|
2018-04-21 18:04:53 +00:00
|
|
|
$ ./bin/perkeepd
|
2016-06-03 01:59:20 +00:00
|
|
|
|
|
|
|
|
This will create [configuration](/doc/server-config) and public/private
|
2018-05-03 04:35:37 +00:00
|
|
|
key information in `$HOME/.config/perkeep/` (or where
|
2018-04-21 18:04:53 +00:00
|
|
|
`camtool env configdir` points). You can start and stop perkeepd as
|
2016-06-03 01:59:20 +00:00
|
|
|
you see fit.
|
|
|
|
|
|
2018-04-21 18:04:53 +00:00
|
|
|
You're done setting up! Running perkeepd should open a new browser
|
2017-12-15 17:57:42 +00:00
|
|
|
window pointed at your keep where you can start uploading and
|
2016-06-03 01:59:20 +00:00
|
|
|
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).
|
|
|
|
|
|
2018-03-12 18:51:20 +00:00
|
|
|
## 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.
|
|
|
|
|
|
2016-06-03 01:59:20 +00:00
|
|
|
## Release Notes
|
|
|
|
|
|
|
|
|
|
Previous release notes:
|
|
|
|
|
|
2018-05-02 22:45:37 +00:00
|
|
|
- [0.10 ("Bellingham")](/doc/release/0.10), 2018-05-02
|
|
|
|
|
- [2017-05-05](docs/release/monthly/2017-05-05.html)
|
2017-04-05 15:29:55 +00:00
|
|
|
- [2017-03-01](docs/release/monthly/2017-03-01.html)
|
2016-06-03 01:59:20 +00:00
|
|
|
- [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
|
