|Burst Reference Software - MacOS Installation|
Table Of Contents
- 1 Table Of Contents
- 2 Installation of MacOS Burst Wallet
- 2.1 Dependencies
- 2.2 Quick Start
- 2.3 Steps
- 2.3.1 1. Install Homebrew
- 2.3.2 2. Install MariaDB
- 2.3.3 3. Start MariaDB and create a user for the wallet to use
- 2.3.4 4. Installing the Java 8 SDK
- 2.3.5 5. Download and setup the wallet
- 2.3.6 6. Start the wallet
- 2.3.7 7. Creating your account and signing in.
- 2.3.8 8. Wait for the blockchain to download
- 2.3.9 9. References
- 3 10. From BRS Main
- 4 References
Installation of MacOS Burst Wallet
This tutorial will walk you through the steps required to get started with the Burst wallet on macOS. A link to a simple bash script which can be run that should take care of all the work for you. Skip to the Quick Start section to use a setup script provided which should be quicker than following each step below.
There are a few dependencies you should check on prior to starting the install.
- OSX 10.10 or higher
- Sufficient disk space for the full blockchain (~8Gb or so)
- The ability to leave your computer up and running for several hours (to synchronize the full blockchain)
If you’d rather not bother with all the steps below, a script to do all the work for you has been created. Simply download a .zip of the code here and follow the few steps in the README file.
1. Install HomebrewThe first step is installing Homebrew (brew) which is an excellent package manager for macOS. You can install it by opening a new terminal and running the following command. Note: You may be asked for your password in order to complete the install.
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew update
2. Install MariaDBMariaDB is an open-source fork of the MySQL relational database. It will be used to store the blockchain and other relevant information for the wallet. You can install MariaDB by typing the following once brew has finished installing.
$ brew install mariadb
3. Start MariaDB and create a user for the wallet to useYou can use brew to start the MariaDB service for you by typing.
$ brew services start mariadb
$ mysql -u root -p -h localhost
CREATE DATABASE burstwallet; CREATE USER 'burstwallet'@'localhost' IDENTIFIED BY '<YOUR PASSWORD>'; GRANT ALL PRIVILEGES ON burstwallet.* TO 'burstwallet'@'localhost';
\qand hitting Enter.
4. Installing the Java 8 SDKThis step was a bit confusing as brew would always like to give you the latest version of all packages. I’m not entirely sure if the latest version of Java will work without issue, but I didn’t want to risk it. First you need to install brew cask.
$ brew tap caskroom/cask
$ brew cask install java8
5. Download and setup the walletYou can download the wallet package from PoC Consortium here. Once you’ve unzipped the release (burstcoin-1.3.6.zip) you should open the directory and open the
nxt.propertiesfile in the
confdirectory in a text editor. At the bottom of the file add the following lines.
nxt.dbUrl=jdbc:mariadb://localhost:3306/burstwallet nxt.dbUsername=burstwallet nxt.dbPassword=<YOUR PASSWORD>
6. Start the wallet
Finally it’s time to start the wallet. In your open terminal window make sure you’re in the same directory as the burst.sh startup script. If you run
ls in your terminal window you should see a response like this.
In your terminal window you should use the following command to make sure you have permission to execute the startup script.
chmod +x burst.sh
Finally you can launch the wallet script. Note: You need to leave this terminal window up and running while the wallet synchronizes the full block chain which could take several hours or days depending on your personal setup and internet connection.
You should see a lot of output flying by pretty quickly as the wallet starts up.
7. Creating your account and signing in.
Assuming you see no obvious errors while the wallet is starting up. You should check to see if it’s successfully running by entering
http://localhost:8125/index.html in your browser. You should see a page that looks like this.
Click the ‘
New? Create Your Account!’ button. The wallet will generate a passphrase of 12 words. WRITE THESE WORDS DOWN AND DO NOT SHARE THEM. This passphrase is your private key and will be how you access your wallet and Burst funds. Please review the section on securing your Burst. Follow the confirmation step on the next page and click
You should now see the wallet dashboard which looks like this.
Congratulations! You’re up and running.
8. Wait for the blockchain to download
Now that you have your wallet running locally and have created an account, you’ll need to wait for the blockchain to synchronize before you see your up to date burst balance. This may take quite a while depending on your connection speed. Make sure you take note of your Account Id listed at the top and on the left side of the wallet. This address is how you will send/receive Burst in the future.
10. From BRS Main
In order to run the wallet locally, we need a database to store the blochchain information. The following guide shows the setup of MariaDB as database and the installation of the Burst Reference Software on MacOS.
MariaDB is used as database to store the blockchain. The following steps will guide you through the installation of MariaDB on MacOS.
First check that Xcode is up to date by typing the following and pressing enter.
After installing Xcode, install MariaDB by typing the following and pressing enter.
brew install mariadb
Once MariaDB is finished installing, start MariaDB with the following.
brew services start mariadb
As soon as MariaDB is successfully installed, we can log into the MariaDB interface and setup database like explained in Setup MariaDB
- Now, download the lateste release from the Github release section
- Find the folder you downloaded from github and double click it. Archive utility will now extract it to a new folder.
- Rename the extracted folder to
- Open the
conffolder inside the extracted folder
- Right click the file
brs-default.propertiesand select "Open With → TextEdit".
- Find the following lines and enter
burstwalletas database user and your password (assigned beforehand) as database password brs.dbUsername=burstwallet brs.dbPassword=<your password>
- Move that folder to your home folder. This may appear as your username.
- Back in terminal, navigate to the
burstcoinfolder. cd ~/burstcoin
burst.shexecutable. chmod +x burst.sh
- Now execute
burst.sh. This is how you will start the wallet in the future. To execute this command you must be inside the burtscoin folder in the terminal. ./burst.sh
- The wallet should now be running. In your web browser navigate to http://localhost:8125/ to access the wallet interface.
How to run a full node on MacOS?
Why Run a Full Node ?
Running a full node is one of the most important ways to help support the Burst network. This allows other peers to connect to your wallet and synchronize the blockchain if they are not using an imported DB. When light clients are released, Full Nodes maintain a copy of the blockchain, in the decentralized manner that crypto currencies are designed to run, while light clients will not. Below are the steps for setting up a full node.
- Once you have a local wallet installed and running you need to forward port 8123 to allow other peers to connect to your wallet.
- Now you will set the machine to have a static IP address. This is so that if the machine restarts, it will not change IP addresses and negate the port forwarding rule we will set up later.
Steps on MacOS
Firstly, if you have the latest BRS version, UPnP should be enabled and you already run a full node. Otherwise, following these steps :
- Open "System Preferences"
- Select "Network"
- Select "Advanced"
- Select "TCP/IP"
- Note down your "IPv4 Address"
- Note down the "Router" address, this is your default gateway.
- Leave "Configure IPv6" set to "Automatic".
- Change "Configure IPv4" to "Manual".
- Now in the "IPv4 Address" field, enter the IPv4 address you copied down before switching to manual.
- Make sure "Subnet Mask" is still 255.255.255.0
- Make sure "Router" still matches the router number you copied down before switching to manual.
- Click "Ok"
- Click "Apply"
- Close "System Preferences"
Now open your network router settings by entering your default gateway IP in the URL field of your browser. Login to your router.
- If you have never used these settings before, most ISPs have default username/password combinations. A quick google search will help you find it.
- If you do not remember your username/password combo, you will need to factory reset your router. Be mindful, this will force you to re-setup your entire network.
- Find the "Port Forwarding" option. Note, "Port Forwarding" and "Port Triggering" are NOT the same. "Port Forwarding" is generally under the "Advanced" tab.
- Select "Add Service", "Add Rule", or anything along those lines.
- Set "Common Service" as "Other".
- Set service name to "Burstcoin".
- Set "Service Type" to "TCP/UDP".
- Set IPv4 Address to your machines address which is the address you just made static.
- Disregard the IPv6 Address field.
- Set your "Start Port" and "End Port" to "8123".>
- Save the new service.
The local wallet must remain running for your full node to be accessible to the network.