search

keybase / kbfs

Keybase Filesystem (KBFS)
https://keybase.io/docs/kbfs
BSD 3-Clause "New" or "Revised" License
1.21k stars 137 forks source link

Add mounting instructions to the website (install section) #1340

Open jpaugh opened 6 years ago

jpaugh commented 6 years ago

For those on Linux who don't use a package manager (or use an uncommon one), it would be good to have generic installation instructions based around tarballs on the website. I had difficulty tracking down the mounting instructions for kbfs, as well as the fact that I needed it at all. (The error output of keybase-gui was very instructive in this regard.)

Since I'm using nix, here's the sequence of commands which worked for me:

$ nix-env --install keybase keybase-gui kbfs
$ keybase ctl start
$ sudo mkdir /keybase && sudo chown $USER /keybase
$ kbfsfuse /keybase

Sorry for the noise. If there's a separate bug reporter for the website or docs; I missed it.

songgao commented 6 years ago

Thanks for the suggestion. Sorry the instructions are not clear. Did you know about https://github.com/keybase/client/blob/master/packaging/linux/run_keybase ? It's what's used by package manager installations.

jpaugh commented 6 years ago

Ah! I see run_keybase is mentioned on the install page, but I skipped over everything after the word update, mainly because I didn't understand that sentence, yet (and hoped it would not apply to new installs). I'm not sure if finding that file would have been an easier route or not.

Notwithstanding, I can see that keybase is a high quality product overall. :-) It's quite a pleasure to make changes with the command line and see them take effect immediately in the GUI.