OpenBazaar - ArchWiki

# OpenBazaar

From ArchWiki

Related articles

- ZeroNet
- Tor

This article or section needs language, wiki syntax or style improvements. See Help:Style for reference.

Reason: No citation for experimental warning. Pro: & Con: instead of proper English sentences. Some sentences miss articles. (Discuss in Talk:OpenBazaar#)

OpenBazaar is an open source project developing a protocol for e-commerce transactions in a fully decentralized marketplace using cryptocurrencies.

This is experimental software. Use at your own risk.

## Installation

The openbazaarAUR package provides the client and openbazaardAUR provides the server.

## Start server

You can view the configuration options with `openbazaard start --help`.

We will use Tor for more anonymity and `--allowip=127.0.0.1` so only you have access to your OB server.

Also consider the options `--password=` to encrypt the database, and `--disablewallet` to disable the wallet functionality of the node.

### As user

We will store the OB server files in `~/.local/share/openbazaar`.

#### As user with Tor Browser

Pro: less configuration, con: you must start Tor Browser first. see torbrowser-launcher-gitAUR

Run as user:

    $ openbazaard start -d ~/.local/share/openbazaar --tor --allowip=127.0.0.1 --verbose

with the `--tor` option, OB server will use your Tor Browser as the Tor entry node.

#### As user with Tor

To use your system-wide Tor proxy, you must configure Tor first.

Choose a password to secure your Tor Control Port. Run

    $ tor --hash-password password

to get the password hash.

Add to your `/etc/tor/torrc` file:

    ControlPort 9051
    HashedControlPassword hash

setting `HashedControlPassword` to your password hash.

Now you can start the OB server as user:

    $ openbazaard start -d ~/.local/share/openbazaar --torpassword=your_tor_control_password --allowip=127.0.0.1 --verbose

setting `--torpassword` to your Tor password.

### System-wide

We will store the OB server files in `/var/lib/openbazaar`.

openbazaard will run as user `openbazaar` in group `openbazaar`.

We will use system-wide Tor, not Tor Browser.

Read section #As user with Tor to configure tor.

Edit server configuration file `/etc/conf.d/openbazaard` as root

    # OB_ARGS="-d /var/lib/openbazaar --torpassword=your_tor_control_password --allowip=127.0.0.1 --verbose"

To init the server files run as root

    # mkdir /var/lib/openbazaar
    # chown openbazaar:openbazaar /var/lib/openbazaar
    # chmod 0700 /var/lib/openbazaar

The `openbazaard` systemd service seems broken at the moment. It will look good, but not start the OB server. `openbazaard status` will only show your database status, and whether tor is available. it will not show, whether OB server is running.

Instead, run as root

    # source /etc/conf.d/openbazaard
    # sudo -u openbazaar openbazaard start $OB_ARGS

You should see some ASCII art

    ________                      __________
    \_____  \ ______   ____   ____\______   \_____  _____________  _____ _______
     /   |   \\____ \_/ __ \ /    \|    |  _/\__  \ \___   /\__  \ \__  \\_  __ \
    /    |    \  |_> >  ___/|   |  \    |   \ / __ \_/    /  / __ \_/ __ \|  | \/
    \_______  /   __/ \___  >___|  /______  /(____  /_____ \(____  (____  /__|
            \/|__|        \/     \/       \/      \/      \/     \/     \/

... along with error-free log messages

Wait for

    [INFO] [cmd/newHTTPGateway] Gateway/API server listening on /ip4/127.0.0.1/tcp/4002

For more server configuration, see

    openbazaard gencerts --help
    openbazaard setapicreds --help

To generate SSL certificates, or set username and password for 'API access' to allow clients to connect. Both will need the option `-d dir` or `--datadir=dir`

## Start client

Run `openbazaar` as user.

The default server configuration should be fine.

If your server admin did configure a login with `openbazaard setapicreds` then fill the Username and Password fields.

To connect to a tor-hidden OB server, set Server IP to the `.onion` address, activate Use Tor, and enter your_tor_control_password to connect via your system tor node.

Otherwise, when using the localhost OB server, the Use Tor setting should not be needed.

## See also

- Official website

Category:

- Networking

Hidden category:

- Pages or sections flagged with Template:Style