search

keybase / keybase-issues

A single repo for managing publicly recognized issues with the keybase client, installer, and website.
900 stars 37 forks source link

Add per-platform instructions? First-run setup could use a lot of UX improvement #776

Open cbowns opened 10 years ago

cbowns commented 10 years ago

I found the first-run setup of Keybase to be insanely complicated. I'm very well-versed in working in the command-line, I've got a working homebrew install, an up-to-date npm install, etc etc… but I still found several points in the installation instructions where I had to simply figure out how to accomplish something Keybase needed set up.

To be fair, I think a lot of this is platform-specific, but if we want to have Keybase be fairly turn-key to setup, a good per-platform installation guide is key. (Think: links and one-liners for installing things like homebrew (needed to get gpg installed), etc.)

I'll update this issue with notes from a meeting about Keybase I'm having with a couple of friends this weekend.

boegh commented 10 years ago

I actually found it to be rather straightforward (since you mention homebrew I assume you are on a MacOS X?), following the steps in first Prerequisites and Installation. It basically boiled down to:

  1. Installing node.js
  2. Installing GPG Suite
  3. Installing keybase

Took something like 10-15 minutes including downloads and writing down for my much more detailed description. But perhaps I'm missing something here?

cbowns commented 10 years ago

I was looking at this through a lens of barely-technical person. It leaves a lot to be desired.