Keybase is a key directory that maps social media identities to encryption keys (including, but not limited to PGP keys) in a publicly auditable manner. Keybase offers an end-to-end encrypted chat and cloud storage system,[2][3] called Keybase Chat and the Keybase filesystem respectively. Files placed in the public portion of the filesystem are served from a public endpoint,[3] as well as locally from a filesystem mounted by the Keybase client.[4]

Keybase supports publicly connecting Twitter, GitHub, Facebook, Reddit, and Hacker News identities to encryption keys, along with Bitcoin and Zcash wallet addresses.[5][2][6] Keybase has supported Coinbase identities since initial public release, but ceased to do so on March 17, 2017 when Coinbase terminated public payment pages.[7]

Identity Proofs

Keybase allows users to "prove" a link between certain online identities (such as a Twitter or reddit account) and their encryption keys. Instead of using a system such as OAuth, identities are proven by posting a signed statement as the account a user wishes to prove ownership of. This makes identity proofs publicly verifiable – instead of having to trust that the service is being truthful, a user can find and check the relevant proof statements themselves, and the Keybase client does this automatically.


In addition to the web interface, Keybase offers a client application for Windows,[8][9] Mac,[8][9] Android,[10][9] iOS,[9] and most desktop Linux distributions,[9] written in Go with an Electron front end. The app offers additional features to the website, such as the end-to-end encrypted chat, teams feature, and the ability to add files to and access private files in their personal and team Keybase filesystem storage. Each device running the client app is authorized by a signature made either by another device or the user's PGP key. Each device is also given a per-device NaCl key to perform cryptographic operations.


Keybase Chat is an end-to-end encrypted chat built in to Keybase launched in February 2017. A distinguishing feature of Keybase Chat is that it allows Keybase users to send messages to someone using their online aliases (for example a reddit account), even if they haven't signed up to Keybase yet.[2]

If the recipient (the online alias owner) has an account on Keybase, they will seamlessly receive the message. If the recipient doesn't have a Keybase account, and later signs up and proves the link between the online account and their devices, the sender's device will rekey the message for the recipient based on the public proof they posted, allowing them to read the message. Since the Keybase app checks the proof, it avoids trust on first use.[11]

Keybase Filesystem (KBFS)

Keybase allows users to store up to 250 GB of files in a cloud storage called the Keybase Filesystem. The filesystem is divided into three parts: public files, private files, and team files. On Unix-like machines, the filesystem is mounted to /keybase, and on Microsoft Windows systems it is usually mounted to the K drive.[12] Currently, mobile versions of the Keybase client do not have any user interface for interacting with the filesystem. However, they do support operations such as rekeying files as necessary.

Public Files

Public files are stored in /public/username, and are publicly visible. All files in the public filesystem are automatically signed by the client.[4] Only the user who the folder is named after can edit its contents, however, a folder may be named after a list of comma-separated users (e.g. a folder /public/foo,bar,three would be editable by the users foo, bar, and three.)[4]

Public files can be accessed by any user. Single user folders are displayed at keybase.pub and are also accessible by opening the directory in the mounted version of the filesystem. Multi user folders (such as /public/foo,bar,three) are only accessible through the mounted version of the system.

Private Files

Private files are stored in /private/username, and are only visible to username. Private files, like public files, can be named after more than one user (e.g. a folder /private/foo,bar,three would be readable and editable by the users foo, bar, and three.) Unlike public files, all private files are both encrypted and signed before being uploaded, making them end-to-end encrypted.[3]


In September 2017, Keybase launched Keybase Teams.[13] A team is described as "...a named group of people."[14] Each team has a private folder in the Keybase filesystem, and a number of chat channels (similar to Slack.) Teams can also be divided into "subteams" by placing a . in the team name. For example, wikipedia.projects would be a subteam of wikipedia, while wikipedia.projects.foobar would be a subteam of wikipedia.projects (and therefore, also of wikipedia.)

Team Administration

Teams are largely administrated by adding signatures to a chain. Each signature can add, remove, or change the membership of a user in a team, as well as when changes are made to subteams.

Each chain starts with a signature made by the team owner, with subsequent actions signed on by team admins or users.[15] This ensures that every action is made by an authorized user, and that actions can be verified by anyone in possession of the public key used.


  1. ^ "keybase/client", Github, 2014-12-12  The Keybase client Github repository.
  2. ^ a b c Dalton, Andrew (2017-09-02). "Keybase's encrypted chat works with accounts you already have". Engadget. Retrieved 2017-06-05. 
  3. ^ a b c Russell, Jon (2016-05-02). "Keybase Introduces End-To-End Encrypted File Sharing Service". TechCrunch. Retrieved 2017-05-06. 
  4. ^ a b c "Understanding the Keybase filesystem". Keybase. Retrieved 2017-09-26. 
  5. ^ Fleishman, Glenn. "Keybase Wants To Make Serious Encryption Accessible To Mere Mortals". Fast Company. Fast Company. Retrieved 5 June 2017. 
  6. ^ "Keybase chooses Zcash". The Keybase Blog. Retrieved 2018-02-06. 
  7. ^ "Abrupt Termination of Coinbase Support". The Keybase Blog. Keybase, Inc. Retrieved 5 June 2017. 
  8. ^ a b Fleishman, Glenn (Feb 15, 2017). "Keybase offers encrypted chat where you control all the pieces". Macworld. Retrieved June 8, 2017. 
  9. ^ a b c d e Dunn, John E (May 31, 2017). "Keybase adds end-to-end encryption to messages on the web". Naked Security. Retrieved June 8, 2017. 
  10. ^ Hoff, John (May 12, 2017). "Keybase encrypted chat now available on Android". androidcommunity.com. Retrieved June 8, 2017. 
  11. ^ "Introducing Keybase Chat". The Keybase Blog. Retrieved February 12, 2018. 
  12. ^ "Introducing the Keybase filesystem". Keybase. Retrieved 2017-09-26. 
  13. ^ Hackett, Robert (18 September 2017). "First They Made OkCupid and SparkNotes. Now They're Taking on Slack". Fortune Tech. Retrieved 21 September 2017. 
  14. ^ "Teams for Keybase". Keybase.io. Retrieved September 21, 2017. 
  15. ^ "Teams: Naming, Merkle Tree Integration, And Signature Chains". Keybase. Retrieved 2017-09-26.