You can download the Perkeep command line tools for Linux, Mac, and Windows at:
You will need to use the following client configuration in order to access this server using the command line tools.
{{ .ClientConfigJSON }}
{{ .SecringDownloadHint }}
See the Perkeep online documentation and community contacts.
` // HelpHandler publishes information related to accessing the server type HelpHandler struct { clientConfig *clientconfig.Config // generated from serverConfig serverConfig jsonconfig.Obj // low-level config goTemplate *template.Template // for rendering serverSecRing string } // SetServerConfig enables the handler to receive the server config // before InitHandler, which generates a client config from the server config, is called. func (hh *HelpHandler) SetServerConfig(config jsonconfig.Obj) { if hh.serverConfig == nil { hh.serverConfig = config } } func init() { blobserver.RegisterHandlerConstructor("help", newHelpFromConfig) } // fixServerInConfig checks if cc contains a meaningful server (for a client). // If not, a newly allocated clone of cc is returned, except req.Host is used for // the hostname of the server. Otherwise, cc is returned. func fixServerInConfig(cc *clientconfig.Config, req *http.Request) (*clientconfig.Config, error) { if cc == nil { return nil, errors.New("nil client config") } if len(cc.Servers) == 0 || cc.Servers["default"] == nil || cc.Servers["default"].Server == "" { return nil, errors.New("no Server in client config") } listen := strings.TrimPrefix(strings.TrimPrefix(cc.Servers["default"].Server, "http://"), "https://") if !(strings.HasPrefix(listen, "0.0.0.0") || strings.HasPrefix(listen, ":")) { return cc, nil } newCC := *cc server := newCC.Servers["default"] if req.TLS != nil { server.Server = "https://" + req.Host } else { server.Server = "http://" + req.Host } newCC.Servers["default"] = server return &newCC, nil } func (hh *HelpHandler) InitHandler(hl blobserver.FindHandlerByTyper) error { if hh.serverConfig == nil { return fmt.Errorf("HelpHandler's serverConfig must be set before calling its InitHandler") } clientConfig, err := clientconfig.GenerateClientConfig(hh.serverConfig) if err != nil { return fmt.Errorf("error generating client config: %v", err) } hh.clientConfig = clientConfig hh.serverSecRing = clientConfig.IdentitySecretRing clientConfig.IdentitySecretRing = "/home/you/.config/perkeep/identity-secring.gpg" tmpl, err := template.New("help").Parse(helpHTML) if err != nil { return fmt.Errorf("error creating template: %v", err) } hh.goTemplate = tmpl return nil } func newHelpFromConfig(ld blobserver.Loader, conf jsonconfig.Obj) (h http.Handler, err error) { return &HelpHandler{}, nil } func (hh *HelpHandler) ServeHTTP(rw http.ResponseWriter, req *http.Request) { suffix := httputil.PathSuffix(req) if !httputil.IsGet(req) { http.Error(rw, "Illegal help method.", http.StatusMethodNotAllowed) return } switch suffix { case "": cc, err := fixServerInConfig(hh.clientConfig, req) if err != nil { httputil.ServeError(rw, req, err) return } if clientConfig := req.FormValue("clientConfig"); clientConfig != "" { if clientConfigOnly, err := strconv.ParseBool(clientConfig); err == nil && clientConfigOnly { httputil.ReturnJSON(rw, cc) return } } hh.serveHelpHTML(cc, rw, req) default: http.Error(rw, "Illegal help path.", http.StatusNotFound) } } func (hh *HelpHandler) serveHelpHTML(cc *clientconfig.Config, rw http.ResponseWriter, req *http.Request) { jsonBytes, err := json.MarshalIndent(cc, "", " ") if err != nil { httputil.ServeError(rw, req, fmt.Errorf("could not serialize client config JSON: %v", err)) return } var hint template.HTML if strings.HasPrefix(hh.serverSecRing, "/gcs/") { bucketdir := strings.TrimPrefix(hh.serverSecRing, "/gcs/") bucketdir = strings.TrimSuffix(bucketdir, "/identity-secring.gpg") hint = template.HTML(fmt.Sprintf("Download your GnuPG secret ring from https://console.developers.google.com/storage/browser/%s/ and place it in your Perkeep client config directory. Keep it private. It's not encrypted or password-protected and anybody in possession of it can create Perkeep claims as your identity.
\n", bucketdir, bucketdir)) } hh.goTemplate.Execute(rw, struct { ClientConfigJSON string SecringDownloadHint template.HTML }{ ClientConfigJSON: string(jsonBytes), SecringDownloadHint: hint, }) }