Front-end Electron application for talking with the OpenBazaar-Server daemon
JavaScript HTML CSS


Build Status Slack Status

You must be running the OpenBazaar backend for the client to work! If you are using a remote server (a server on a different computer) your connection will fail on the first install, and you will need to enter the information for the remote server as a new connection.



  1. Clone the client repository into a directory of your choice:
  • git clone
  1. Navigate into the new folder created in (1)
  • cd OpenBazaar-Client
  1. Install the client
  • npm install
  1. Run the client
  • npm start

Remember you must be running the OpenBazaar-Server for the client to function properly. If you want to access the test network (testnet), run the server using the -t flag (e.g. $ python start -t). If your router blocks your port after starting and stopping the server, you can set your server to a new port with the '-p' flag (-p followed by a port number).

If the server component has not generated a GUID (which happens only once, when the server is first started), then the client will not fully start up until the GUID is created.

Current (v1 Mainnet) Release Tracker can be found here: #965

API Documentation

The client uses the following REST API calls.

Websocket API calls are yet to be documented.


Translators around the world are welcomed.

You can start translating at our Transifex project:

Many thanks!