go/

directory
v1.0.3-0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 24, 2015 License: BSD-3-Clause, BSD-3-Clause

README

Keybase

This repository contains the Keybase core crypto libraries, command-line utility, and local Keybase service. All code is written in the Go Language, making heavy use of Go's OpenPGP and NaCl Library implementation.

Our intended architecture is that keybase runs a local service on Desktop environments, which can be connected to over a local Unix domain sockets on OSX/Linux, and over named pipes on Windows. The persistent service will eventually listen for asynchronous server updates, and will serve several clients, like the command-line utility, the graphical desktop app (see electron), and the Keybase FUSE-mounted file system.

For now, the only client ready for production is the command-line utility.

Status

The Keybase service/client is approaching a release-ready state on OSX and Linux, with Windows shortly behind. Code in this repository is safe to run against either our production site or our staging server.

Install production client

Mac
brew tap keybase/beta
brew update
brew install keybase/beta/keybase
Linux

Download the appropriate package:

Building

cd $GOPATH/src/github.com/keybase/client/go
export GO15VENDOREXPERIMENT=1 # all dependencies are vendored
go install

Run the service

cd keybase
./keybase service

Or specify a custom home directory (and use -d for debug):

./keybase -H ~/Projects/Keybase/dev -d service

Run the client

./keybase id max

Or you can run the client in "Standalone" Mode

./keybase --standalone id max

Testing

To test install Boot2Docker and run (if you have access to our server code):

docker build -t kbweb .
make test

License

Most code is released under the New BSD (3 Clause) License.

Directories

Path Synopsis
Code used to support authentication tokens for arbitrary purposes.
Code used to support authentication tokens for arbitrary purposes.
cache
this is the list of commands for the devel version of the client.
this is the list of commands for the devel version of the client.
encoding
PaperKeyPrimary creates the initial paper backup key for a user.
PaperKeyPrimary creates the initial paper backup key for a user.
Code used in populating JSON objects to generating Keybase-style signatures.
Code used in populating JSON objects to generating Keybase-style signatures.
Package minterm implements minimal terminal functions.
Package minterm implements minimal terminal functions.
tools

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL