2017-12-15 17:57:42 +00:00
|
|
|
# Download Perkeep
|
2016-06-03 01:59:20 +00:00
|
|
|
|
2020-11-19 01:21:19 +00:00
|
|
|
The latest release is [0.11 ("Seattle")](/doc/release/0.11), released 2020-11-11.
|
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
|
|
|
|
2019-06-05 16:37:42 +00:00
|
|
|
$ git clone https://github.com/perkeep/perkeep.git 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
|
2020-11-19 01:21:19 +00:00
|
|
|
[cb96bb8bd3](https://github.com/perkeep/perkeep/commit/cb96bb8bd32ce5f1a882b6d06a869a1a1925c57d),
|
2023-01-01 04:38:54 +00:00
|
|
|
Perkeep requires [Go 1.19 or newer](https://golang.org/dl/).
|
2016-06-03 01:59:20 +00:00
|
|
|
|
2020-11-19 01:21:19 +00:00
|
|
|
$ cd perkeep.org
|
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-06-29 05:44:44 +00:00
|
|
|
`pk 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
|
