Downloads are available in 3 forms, in order of convenience:

  1. Ubuntu Packages
  2. Generic Linux Binaries
  3. Source

After download

  1. Build and Install binaries if applicable/desirable.
  2. Edit the provided template-config
    • Make sure to set a unique name.
    • Configure cache-directory, and cache-size limit.
    • Configure friend-nodes, keys and encryption-level if applicable.
    • If testing for the first time, keep the bhdemo-friend.
  3. Start BitHorde with /path/to/bithorded <my.config>.
    • For Ubuntu, BitHorde (and the BHFuse-proxy) can be controlled using the provided upstart-service scripts. Just sudo {start|stop|restart} bithorde.
    • Otherwise, if you want to use the fuse-interface, start it manually using /path/to/bhfuse </path/to/mountpoint>.
    • -d activates debug-mode on both bithorded and bhfuse.
  4. If you kept the bhdemo-friend (and activated BHFuse), you can now test BitHorde out with xdg-open <bhfuse-mountpoint>/'magnet:?dn=sintel-1024-surround.mp4&xt=urn:tree:tiger:O6Q45A2VIJJ5DHPA6DUFUHNCOQJHYVTBYRSYRRY' (mind the quotation marks to prevent shell-expansions.)
  5. To test uploading assets, just bhupload <path/to/asset>. When done, it will print a magnet-link, which can be used with bhget and/or through the bhfuse mount-point.

Good luck, and please give feedback!

Comments on this post
  1. By Anonymous on Sat, 12/31/2011 - 16:23

    What, run filesharing as root?

  2. By rawler on Sat, 12/31/2011 - 16:35

    If the daemon sees it's euid being root, the first thing it will do is to drop privileges to a configurable unprivileged account. (The daemon can also be started as any user. Root is not a requirement, and not recommended).