This tutorial will show users how to install OpenBazaar, navigate the network, and make purchases.
If you have problems along the way, visit our help desk. If you want to chat with someone from the OpenBazaar community for help, or to give feedback on how OpenBazaar is working for you, join our Slack community.
Step #1 – Download and install OpenBazaar
Most users will want to download a package for their operating system, which makes installation as simple as downloading and opening a file. If you have some technical expertise and want to manually install OpenBazaar, read these instructions.
The packages for release can be found on our Github releases page at this link:
Windows users use the OpenBazaar-1.X.X_Setup.exe file. After downloading and opening the file, Windows users will be guided through an installation process which should go very quickly.
OS X users use the OpenBazaar-1.X.X.dmg file.
Linux users use the .deb file.
Download and open the file.
Step #2 – Run OpenBazaar for the first time
The first time you run OpenBazaar you will be guided through an onboarding process to personalize your experience. You will be asked a few questions such as your language, country, and preferred currency.
Each user has their own page on the OpenBazaar network. You can choose a specific theme to make your store unique.
You also have the opportunity to upload an avatar for your store. Click on “Select Avatar” to choose a file from your computer.
The last part of the onboarding process is a disclaimer about using the OpenBazaar software, which you should read before continuing.
After finishing onboarding, you’ll now see your own OpenBazaar page. Here’s what an example page looks like.
Notice the long string of characters below your name, and in the navigation bar at the top of the client. This is your OpenBazaar ID, which is an address that every page on the network has. You can learn more about OpenBazaar IDs here, and how to create simpler names called “handles” here.
Step #3 – View OpenBazaar listings and stores
OpenBazaar is a network of users all over the world who host their own stores, and sell goods and services for Bitcoin.
To view a random sampling of other stores, click on the “Discover” icon (looks like an eye) on the top right of the client. This will bring you to the main Discover page where you can view listings and stores on the OpenBazaar network.
By default you’ll see listings, but if you click on the “Pages” tab you’ll be shown a list of pages which you can connect to. This isn’t a complete list of all the pages on the network; at any one time your own computer only connects to a subset of the overall network.
Note that, by default, users will have a NSFW filter turned on that will hide listings which have been labeled NSFW by the vendor. You can turn off this filter by going into Settings > General tab > clicking “No” on the “Display NSFW Content?” option at the bottom > Saving changes.
If you see a listing which is inappropriate or offensive, you can block that user. Blocking another user means you will not see their items or store on your discover page. You can block a user by hovering over the listing and clicking “Block.”
You can also use the navigation bar to find other stores or listings. Every listing and store has an address on the network, and putting in that address will take you there, just like a website.
For example, take note of the navigation bar on this image. By default, all pages have an address like this, called the OpenBazaar ID. Putting this address into the navigation bar will take you to their page if it’s online.
Since this address isn’t memorable (similar to a Bitcoin address) there is a simpler way. OpenBazaar IDs can be tied to “Handles,” which are short names that can easily be entered into the navigation bar. For example, here’s a store with the handle @drwasho. If you want to set up your own handle, read this article.
Listings have addresses as well. The address first contains the OpenBazaar ID or Handle of the store, and then /item/ followed by the address of the specific item. For example, this listing has the following address:
Copy these addresses in client with Ctrl+C, and paste them with Ctrl+V. You can use share these addresses on the web and other OpenBazaar users can navigate directly to the addresses by pasting them in their navigation bars.
Chat and following
OpenBazaar isn’t a giant ecommerce site; it’s a group of people who all want to engage in peer to peer trade. If you want to talk with those people, you can by using the built-in chat function. Chat is encrypted end-to-end for user’s privacy.
On any OpenBazaar page, you can message the owner of the page by clicking the “message” button.
This opens the chat bar on the right of the client. You’ll see the user and their avatar at the top, your messages in the middle, and then a text field to type at the bottom. There’s also a dropdown on the right which allows you to view the users page and also block the user if they are harassing you.
If you want to remember a store you found, you can follow them, which will add them to your following list. On their page, click the follow button.
Then on your own page, you can click the following tab and see the stores you’ve followed.
Step #4 – Buy something
OpenBazaar is all about creating a new peer to peer network for trade, using Bitcoin. So let’s buy something! Find an item you like and click the big “BUY NOW” button.
The first time you purchase something on OpenBazaar, you’re going to be asked if you have a Bitcoin wallet or not.
If you don’t, you’ll get a list of wallet providers to choose from. You’ll need Bitcoin to buy anything on OpenBazaar, so if you don’t have Bitcoin yet then you should either become a vendor on OpenBazaar and sell some items to earn some Bitcoin, or buy some elsewhere.
If you have Bitcoin, then you can proceed. If the vendor has chosen moderators, you’ll be asked to select from one of two payment types:
1. Direct Payment – The buyer sends the bitcoin directly to the vendor.
2. Moderated Payment – The buyer sends the bitcoin into an escrow account and they are released when the transaction is finished.
You can read more about moderators and moderated payments here. The bottom line is this: Moderated payments give the buyer some protection against the vendor taking the money and not delivering the product. But it’s important to choose a trustworthy moderator. Forums such as OpenBazaar Moderators give people a place to discuss good or bad moderators.
If you choose moderated payments, then your bitcoins will be sent into an escrow account (using a unique feature of Bitcoin called multisignature addresses) that will only allow the funds to move if two out of three parties agree. Those parties are the buyer, vendor, and the moderator. This is more secure than a direct payment, in which the vendor receives payment as soon as they process the order.
After you choose which payment type you want, you will be asked to enter a Bitcoin address that you control. This address is only used in case there is a refund. Once you’ve entered this refund address the first time, you will not be asked again, but you can change it in settings. If you choose to create a temporary address with RushWallet, please don’t forget to save the URL so that you don’t lose it.
If you are buying a physical item, you’ll now be asked to enter a shipping address. If the vendor doesn’t ship to your country then you’ll be unable to purchase the item.
You’ll then be shown a summary screen with details of your order, and quantity, shipping information and moderator details (if it’s a moderated payment). If you are satisfied and want to place and order, click the “Pay for Order” button.
You’ll now be shown the last step in the purchasing process, the payment screen. If you’re familiar with Bitcoin then you’ve seen these QR codes many times. If you have a mobile Bitcoin wallet, simply scan the code and pay. If you have a local wallet, you can click “Open in Local Wallet” and you can finish payment there, or click “Copy to Clipboard” to get the payment address easily.
After paying you should see the payment screen change to indicate successful payment in only a few seconds.
If you don’t see anything change within a few minutes, then you can click the “Refresh Payment Status” button to manually check for payment again.
You’ve bought something, what now?
Step #5 – Managing orders
You can view your purchases by clicking on the menu on the top right of the client, and then on the “Purchases” section of the dropdown menu.
This brings you to your transactions page, which shows you all of your purchases, sales (if a vendor) and cases (if a moderator). To view more details about a purchase, click on “Order Details.”
In this window you’ll see several tabs. The first is a summary tab which gives you an overview of the order. The second is a funds tab which shows the details of all the Bitcoin transactions. The third is a Discussion tab which allows you to have a conversation with the vendor, as well as open a dispute with the moderator if it was a moderated transaction.
You may also have a shipping tab if you ordered a physical item. This tab will show the shipping address you provided.
This window is also where you’ll finish up your orders if you selected a moderated payment. If the vendor shipped the item or delivered the service to your satisfaction, then you should complete the order releasing the funds to the vendor. This also gives you an opportunity to leave a rating for your transaction. After the vendor confirms the order on their end, you’ll have the opportunity press the “Complete this order” on the top left of the window.
You’ll then be asked for the rating, and can scroll down to enter a text review as well. Click save and your rating will be left on the product, and funds will be released.
What if the vendor never sends the product, or they sent something broken? If you have a problem with the vendor, the first step should be to contact them and ask for them to resolve the situation or ask for a refund.
If the vendor is unresponsive or won’t cooperate, and you’ve selected a moderated transaction, you can then open a dispute and bring your case to the moderator. To do this, open the Discussion tab (we showed this above) on the order you placed.
You’ll then be able to open a dispute by making your case to the moderator in the chat area, and checking a box on the bottom right labeled “Start a Dispute” then sending the message.
The moderator will then be able to see the conversation from that point out. They should work with both buyer and seller to determine who will receive the funds in the escrow. Eventually the moderator should close the transaction, which will display the message “END DISPUTE” in the chat and also give you the option to accept the payout if you were the winning party. Notice in this example the payout amounts mentioned on the top of the window. If they look right, then you can click the “Accept Dispute Payout” button.
As soon as you accept the payout the funds will be released to you. Note that the moderator will be paid a percentage of the overall transaction if they are called upon to settle a dispute.
If you want to go beyond just buying goods and services on OpenBazaar and become a vendor, you can learn more at the Vendor’s Guide.
If you’re still using OpenBazaar in the test phase, you’ll need to use a testnet address and testnet coins instead of regular Bitcoin. There are more instructions in the tester’s guide.
Let’s make trade free!