Paytokens Servers are currently only supported on 64-Bit Ubuntu 14.04 LTS. As of this writing, it is recommend to have a system with at least 32 GB of disk space accompanied by 4 GB of RAM and an Intel i5 equivalent or better. A node targets 1,000 Users. The install user must be a sudoer or have the appropriate access rights. Core Paytokens installations are generally to be held by the home directory of the user. These instructions may change and only serve as a guideline.

To get started, begin with a clean install, enter home directory and update repositories:

sudo apt-get update
sudo apt-get upgrade

Next, install Litecoin dependencies:

sudo apt-get install -y git autoconf autogen automake build-essential software-properties-common libboost-all-dev libcurl4-openssl-dev libdb-dev libdb++-dev libgmp3-dev libminiupnpc-dev libmpfr-dev libssl-dev libcurl4-openssl-dev libjansson-dev pax-utils

Build Litecoin:

git clone
cd litecoin/src
make -f makefile.unix USE_UPNP=1
sudo cp ./litecoind /usr/bin

Litecoind First Run: Start Litecoin by typing litecoind. This will provide instructions to setup litecoin.conf in the directory ~/.litecoin. Please be aware that directory paths should be the full path and exclude ~/ when entering paths later through configuration. We may omit the full path throughout this writing. A typical litecoin.conf should resemble the following for Paytokens Nodes:


Please replace PASSWORD with the password of your choosing.

Start Litecoind to Rebuild Blockchain Index:

litecoind -reindex &

Install Paytokens Dependencies:

sudo apt-get -y install runit software-properties-common python-software-properties git-core wget cx-freeze python3 python3-setuptools python3-dev python3-pip build-essential python3-sphinx python-virtualenv libsqlite3-dev python3-apsw python3-zmq ntp ssl-cert

Install Payblock Dependencies:

sudo apt-get -y install python python-dev python-setuptools python-pip python-sphinx python-zmq libzmq3 libzmq3-dev libxml2-dev libxslt-dev zlib1g-dev libimage-exiftool-perl libevent-dev cython
git clone paytokensd_build

Install MongoDB Version 2.6.4:

sudo apt-get -y remove mongodb mongodb-server
sudo apt-key adv --keyserver hkp:// --recv 7F0CEB10
echo 'deb dist 10gen' | sudo tee /etc/apt/sources.list.d/mongodb.list
sudo apt-get update
sudo apt-get -y install mongodb-org=2.6.4 mongodb-org-server=2.6.4 mongodb-org-shell=2.6.4 mongodb-org-mongos=2.6.4 mongodb-org-tools=2.6.4

Pin this specific version of MongoDB to prevent automatic updates:

echo "mongodb-org hold" | sudo dpkg --set-selections
echo "mongodb-org-server hold" | sudo dpkg --set-selections
echo "mongodb-org-shell hold" | sudo dpkg --set-selections
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections

Install Redis:

sudo apt-get -y install redis-server

As a note, other versions of Redis may work just fine, that are just not tested within a Paytokens Environment

Install Sqlite Utilities:

sudo apt-get -y install sqlite sqlite3 libleveldb-dev

Install Node.js:

sudo apt-get -y remove nodejs npm gyp
sudo add-apt-repository -y ppa:chris-lea/node.js
sudo apt-get update
sudo apt-get -y install nodejs

Install Paytokensd:

cd ~/
git clone
cd paytokensd
sudo pip3 install -r pip-requirements.txt
mkdir data

Create Paytokensd Settings in “~/paytokensd/”:


Please match the Litecoin RPC Password to litecoind-rpc-password and Paytokens RPC Password to rpc-password.

Create a shell script to start Paytokens Server in “~/”:

cd PATH/paytokensd
./ --config-file ./ --data-dir data --blockchain-service-name blockr --blockchain-service-connect

Remember to replace PATH with the correct full path to Paytokensd installation directory. Make executable: “chmod 750 ~/”

Install Payblockd:

cd ~/
git clone
cd payblockd
sudo pip2 install -r pip-requirements.txt
mkdir data

Configure Payblockd: “~/payblockd/”:


Create “”:

cd /home/ceo/payblockd
python2.7 --config-file --data-dir data --paytokensd-rpc-user paytokensrpc --paytokensd-rpc-password PASSWORD --rpc-host --rpc-port 7800 --blockchain-service-name blockr --blockchain-service-connect

Install Paywallet:

cd ~/
git clone
cd paywallet
sudo npm install -g grunt grunt-cli bower
npm install grunt --save-dev
npm install grunt-cli --save-dev
npm install bower --save-dev
cd src; bower install; cd ..
npm install
grunt freeze
grunt --force

Note that the paywallet repository includes the correct release of livenet. Do not use the generated build as it will not work. Instead, use the included build directory ‘livenet’ for the prebuilt distribution.

Configure Paywallet: Edit ~/paywallet/livenet/paywallet.conf.json and change to localhost or the desired host.

"servers": [ "https://localhost" ],
"forceTestnet": false,
"googleAnalyticsUA": "UA-21065583-20",
"googleAnalyticsUA-testnet": "UA-21065583-20",
"rollbarAccessToken": "39d23b5a512f4169c98fc922f0d1b121",
"disabledFeatures": [ ],
"restrictedAreas": {
"pages/betting.html": ["US"],
"pages/openbets.html": ["US"],
"pages/matchedbets.html": ["US"],
"pages/rps.html": ["US"],
"dividend": ["US"]
"autoBTCEscrowServer": ""

Install Nginx:

cd ~/
sudo apt-get -y remove nginx-openresty
sudo apt-get -y remove nginx
sudo apt-get -y install make ruby1.9.1 ruby1.9.1-dev git-core libpcre3-dev libxslt1-dev libgd2-xpm-dev libgeoip-dev unzip zip build-essential libssl-dev
sudo gem install fpm
sudo rm -rf /tmp/openresty /tmp/ngx_openresty-* /tmp/nginx-openresty.tar.gz /tmp/nginx-openresty*.deb
wget -O /tmp/nginx-openresty.tar.gz
sudo tar -C /tmp -zxvf /tmp/nginx-openresty.tar.gz
sudo cd /tmp/ngx_openresty-
sudo ./configure --with-luajit --sbin-path=/usr/sbin/nginx --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-client-body-temp-path=/var/lib/nginx/body --http-fastcgi-temp-path=/var/lib/nginx/fastcgi --http-log-path=/var/log/nginx/access.log --http-proxy-temp-path=/var/lib/nginx/proxy --http-scgi-temp-path=/var/lib/nginx/scgi --http-uwsgi-temp-path=/var/lib/nginx/uwsgi --lock-path=/var/lock/nginx.lock --pid-path=/var/run/ --with-http_geoip_module --with-http_gzip_static_module --with-http_realip_module --with-http_ssl_module --with-http_sub_module --with-http_xslt_module --with-ipv6 --with-sha1=/usr/include/openssl --with-md5=/usr/include/openssl --with-http_stub_status_module --with-http_secure_link_module --with-http_sub_module
sudo make
sudo cd /tmp/ngx_openresty-
sudo make install DESTDIR=/tmp/openresty
sudo mkdir -p /tmp/openresty/var/lib/nginx
sudo cp -r ~/paytokensd_build/dist/linux /tmp
sudo install -m 0755 -D /tmp/linux/runit/nginx/run /tmp/openresty/etc/sv/nginx/run
sudo install -m 0755 -D /tmp/linux/nginx/nginx.conf /tmp/openresty/etc/nginx/nginx.conf
sudo install -m 0755 -D /tmp/linux/nginx/counterblock.conf /tmp/openresty/etc/nginx/sites-enabled/counterblock.conf
sudo install -m 0755 -D /tmp/linux/nginx/ /tmp/openresty/etc/nginx/sites-enabled/
sudo install -m 0755 -D /tmp/linux/nginx/ /tmp/openresty/etc/nginx/sites-enabled/
sudo install -m 0755 -D /tmp/linux/nginx/ /tmp/openresty/etc/nginx/sites-enabled/
sudo install -m 0755 -D /tmp/linux/logrotate/nginx /tmp/openresty/etc/logrotate.d/nginx
sudo cd /tmp
sudo fpm -s dir -t deb -n nginx-openresty -v --iteration 1 -C /tmp/openresty --description "openresty" --conflicts nginx --conflicts nginx-common -d libxslt1.1 -d libgeoip1 -d geoip-database -d libpcre3 --config-files /etc/nginx/nginx.conf --config-files /etc/nginx/sites-enabled/counterblock.conf --config-files /etc/nginx/fastcgi.conf.default --config-files /etc/nginx/win-utf --config-files /etc/nginx/fastcgi_params --config-files /etc/nginx/nginx.conf --config-files /etc/nginx/koi-win --config-files /etc/nginx/nginx.conf.default --config-files /etc/nginx/mime.types.default --config-files /etc/nginx/koi-utf --config-files /etc/nginx/uwsgi_params --config-files /etc/nginx/uwsgi_params.default --config-files /etc/nginx/fastcgi_params.default --config-files /etc/nginx/mime.types --config-files /etc/nginx/scgi_params.default --config-files /etc/nginx/scgi_params --config-files /etc/nginx/fastcgi.conf etc usr var
sudo apt-get -y install libxslt1.1 libgeoip1 geoip-database libpcre3
sudo dpkg -i /tmp/nginx-openresty_1.7.2.1-1_amd64.deb
sudo rm -f /etc/nginx/sites-enabled/*.dpkg-old /etc/nginx/sites-enabled/*.dpkg-dist
sudo ln -sf /etc/sv/nginx /etc/service/

Configure Nginx:

sudo nano /etc/nginx/sites*/*

This will bring up an editor to modify Nginx Site Configuration. Please adjust settings in these files to match desired output. In particular comment out ‘etc var usr’.

You may now start Paytokensd and payblockd then open a browser and begin utilizing the local instance of Paytokens.