Let's get Started -

1. Obtain Root Access to a Linux Server. Ubuntu 14.04 Works the Best
2. Install/Compile your chosen coin daemon, create the coin configuration file, note the rpcusername, rpcport and rpcpassword for later use. If the coin is a POS coin, please add

enableaccounts=1 staking=0 to the coin config file.

3. Install the necessary modules

sudo apt-get update sudo apt-get install git sudo apt-get install apache2 sudo apt-get install php5 php5-mysql php5-gd sudo apt-get install mysql-server Please make a note of the mySQL Root password you just set.

4. Download the latest version of piWallet from GitHub

cd ~ sudo git clone https://github.com/johnathanmartin/piWallet/ sudo mv piWallet/* /var/www/html/

5. Setup mySQL Database

I recommend copying the code located in https://github.com/johnathanmartin/piWallet/blob/master/users.sql and pasting it into the mySQL shell by using the commands below.

mysql -u root -p create database wallet; use wallet; COPY AND PASTE THE DATA FROM THE users.sql FILE exit;

6. Edit the config file using an editor of your choice, I prefer VIM but will use nano for this tutorial. sudo nano /var/www/html/common.php There are quite a few lines we have to change here.

$server_url = "/"; // ENTER WEBSITE URL ALONG WITH A TRAILING SLASH The Server URL needs to be replaced with the full domain of the piWallet instance. The domain must point to the IP address of the server.

$db_pass = "password"; Replace password with your mySQL root password you setup in Step 3

$rpc_port = "8332"; $rpc_user = "bitcoinrpc"; $rpc_pass = "Cp68nBkCAADKkskaKSskaDKdmSYLtLJ"; Replace the RPC Port, RPC Username & RPC Password with the ones you provided in Step 2

$fullname = "Bitcoin"; //Website Title (Do Not include 'wallet') $short = "BTC"; //Coin Short (BTC) Replace the infromation with the information about the coin you will be using this wallet for.

$blockchain_url = "http://blockchain.info/tx/"; //Blockchain Url Replace the blockchain URL with the transaction blockchain for your coin. Please include the trailing slash. piWallet will automatically append the transaction id # to the end of the url.

$support = "support@yourwebsite.com"; //Your support eMail Enter your email that you wish for users to contact you.

$donation_address = "13jy6rHB7HMgQBoYxQQXSM7TFTZZ6CDAAZ"; //Donation Address Replace this with your own address for the same coin you will be hosting, you can change this later after you have your own wallet with piWallet

$reserve = "0"; The reserve prevents the user from spending more than they have, the reserve should not be set to anything higher than to cover the fee of the daemon.

7. Login to piWallet

Visit your hostname in a web browser and login using the following credentials

username = piWallet password = changeme If you are greeted with a white screen, please go directly to the debugging section at the bottom of this guide. Otherwise, IMMEDIETLY change the password associated with this account to something more secure. We also recommend downloading the Google Authenticator app to a smart phone and enabling Two-Factor Authentication inside piWallet.

Please test that piWallet is working by attempting to generate a new address.

If you are able to see your new address, that means everything is likely up and running. Congratulations!

Debugging If you are greeted with a white screen, more commonly known as the White Screen of Death, this means there is one of the following issues.

The Daemon is not setup, the credentials are invalid, the daemon is not fully synced MySQL is not completely setup or the credentials are invalid. For more information please enable error debugging by uncommenting the first three lines (not including <?php) and reloading the page. If you are not able to continue, you may paste this error message and open an issue.