|Burst Reference Software - MacOS Installation|
Table Of Contents
- 1 Table Of Contents
- 2 Installation of MacOS Burst Wallet
- 2.1 Quick Start
- 2.2 Dependencies
- 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
- 2.3.4 4. Install 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 How to run a full node on MacOS?
- 4 References
Installation of MacOS Burst Wallet
This tutorial will walk you through the steps required to run a Burst wallet locally on MacOS.
Note: A simple bash script is available to complete all of the steps for you if you prefer using a script. Simply download a .zip of the code located here and follow the directions in the README file. If you prefer to execute each step without using a script, begin the process with the dependencies section.
There are a few dependencies that you should check on prior to starting the install process.
- 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 in order to allow the full blockchain to synchronize.
1. Install HomebrewHomebrew (brew) is an excellent package manager for MacOS. To install, open a new terminal and run the following command. Note: You may be asked for your password in order to complete.
$ /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 is used to store the blockchain and other wallet information. Install MariaDB by typing the following.
$ brew install mariadb
3. Start MariaDB and create a user for the wallet
$ 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. Install Java 8 SDK
Brew gives you the latest version of all packages, but the latest version of Java may not work without issue. You can install the latest verified version (Java 8) by following these steps.Install brew cask.
$ brew tap caskroom/cask
$ brew cask install java8
5. Download and setup the walletThe wallet package from PoC Consortium is located here. Unzip the release (burstcoin-1.3.6.zip) and open the
nxt.propertiesfile from the
confdirectory in a text editor. Add the following lines to the end of the file
nxt.dbUrl=jdbc:mariadb://localhost:3306/burstwallet nxt.dbUsername=burstwallet nxt.dbPassword=<YOUR PASSWORD>
6. Start the wallet
In your open terminal window verify that you are in the same directory as the burst.sh startup script. If you run
ls in your terminal window you should see a response similar to the following:
In your terminal window, use the following command to make sure you have permission to execute the startup script.
chmod +x burst.sh
Launch the wallet script. Note: You will need to leave this terminal window running until the full blockchain has synchronized. This could take several hours or days depending on your processor speed and 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, check to see if it is running successfully by entering
http://localhost:8125/index.html in your browser. You should see a page that looks like this:
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.
If so, congratulations! You are up and running.
8. Wait for the blockchain to download
Now that you have your wallet running locally and have created an account, you will need to wait for the blockchain to fully synchronize before you can see your up-to-date Burst balance. This may take a few hours or a few days depending on your processor and internet connection speed. Please note: Your Account Id is listed in the top left corner of your wallet. This address is necessary for sending and receiving Burst.
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.