How to: Peerbox Support Thread (Updated to v0.6.1)

peerchemist · April 1, 2016, 11:57am

Requirements:

Raspberry Pi (any generation of)
Love for Peercoin
20min of your time

Step 1:
Skip this if you already have Raspbian installed

Start by installing Operating System on Raspberry. There are several tutorials for this, and I must say most of them are better then I would expect.
I have found this two that I particularly like:
Text form: https://www.andrewmunsell.com/blog/getting-started-raspberry-pi-install-raspbian/
Video form: https://www.youtube.com/watch?v=oBmOymY7h1M

Please note, if you use “Noobs” install image - pick Raspbian [Recommended].

I will presume you know how to discover local IP of your Raspberry and know how to SSH login into it.

It is possible that you will get an error related to your locale settings.
If you get this error and don’t know how to solve it your self, simply execute the following command:

echo export LC_ALL=en_US.UTF-8 >> ~/.profile

Now logout and login again.

If that did not made locale problems go away, read this article: http://daker.me/2014/10/how-to-fix-perl-warning-setting-locale-failed-in-raspbian.html

Step 2:
Add official Peerbox repository.

Open Terminal, copy paste following commands:

My GPG key for verification:

wget -O - http://peerbox.me/repo/peerbox.gpg.key | sudo apt-key add -

Repository:

sudo sh -c "echo 'deb http://peerbox.me/repo jessie main' >> /etc/apt/sources.list.d/peerbox.list"

Step 3:
Install Peerbox.

Open Terminal, copy paste following commands:

sudo apt-get update && sudo apt-get install peerbox

Step 4:
Start and use Peerbox.

Peerbox is utilized via “peerbox” command. Type “peerbox --help” in terminal to see what it can do.

Start peerbox with peerbox --start, leave it for 20ish seconds to start up and then check current status with peerbox --info.
To make peerbox start automatically (in case of frequent reboots for example) do:

peerbox --autostart

Step 5:
Minting.

If you have coins ready to mint, just unlock your wallet to start staking:

peerbox --mint

and enter your password.

You can also use Peerbox via Tor onion router:
Peerbox can auto configure itself to become full node on Tor network.

Start Peerbox via Tor:

peerbox --tor

If you want to autostart Peerbox via Tor on reboot:

peerbox --autostart tor

This is usually a tad slower to connect to enough nodes but it should become a full node in about 10 minutes.

You can see what is your node’s .onion address with:

peerbox --onion

Optional steps:

Even though they are not yet implemented in peerbox tool, new Peerbox has more tricks up it’s sleeve.

For example, you can use graphical Peercoin-qt client instead of ppcoin command line daemon.

sudo systemctl start ppcoin-qt@pi.service

peerbox command will work properly with graphical client too, so you can still use it to monitor status.
But it is still not integrated with the rest of the system as much as ppcoind is.

Support thread: https://www.peercointalk.org/index.php?topic=4469.0

peerchemist · April 1, 2016, 12:19pm

If you have any problems with running Peerbox or just want to propose something, please use this thread.

willy · April 1, 2016, 2:22pm

How do I set a custom datadir?

masterOfDisaster · April 1, 2016, 3:10pm

peercoind --datadir=“pathToAppData” should do

peerchemist · April 1, 2016, 3:14pm

Edit:

/usr/lib/systemd/system/ppcoind@.service

file (or ppcoin-qt if you use that one):

In this section:

[code]
[Service]
User=%i
Group=users
Type=simple
Restart=on-failure
RestartSec=15
ExecStart=/usr/bin/ppcoind

security

PrivateTmp=true
PrivateDevices=true
ProtectSystem=full
NoNewPrivileges=true[/code]

Replace line starting with ExecStart with:

ExecStart=/usr/bin/ppcoind -datadir=$CUSTOM_DATA_DIR

After done, save and reload service file:

sudo systemctl daemon-reload

then restart ppcoind.

masterOfDisaster · April 1, 2016, 3:34pm

Oh well, a bit more complicated than I thought

peerchemist · April 1, 2016, 3:37pm

There must be some price to security and stability. Systemd will make sure ppcoind is always running.

Automatic_Monkey · April 25, 2016, 6:48am

No luck with installation.

I’m using a RPi3 with Ubuntu Mate. Go through the process, and I get an error of a dependency ‘ppcoin’ not found.

peerchemist · April 25, 2016, 8:17am

[quote=“Automatic Monkey, post:8, topic:3827”]No luck with installation.

I’m using a RPi3 with Ubuntu Mate. Go through the process, and I get an error of a dependency ‘ppcoin’ not found.[/quote]

Debian (Raspbian) is the only supported OS. I am surprised anything worked.

Automatic_Monkey · April 25, 2016, 7:21pm

[quote=“peerchemist, post:9, topic:3827”][quote=“Automatic Monkey, post:8, topic:3827”]No luck with installation.

I’m using a RPi3 with Ubuntu Mate. Go through the process, and I get an error of a dependency ‘ppcoin’ not found.[/quote]

Debian (Raspbian) is the only supported OS. I am surprised anything worked.[/quote]

Yuck. Unfortunate. Do you think any PPC wallet at all will run under Mate?

peerchemist · April 25, 2016, 8:16pm

Any Peercoin wallet compiled for Linux will run on Ubuntu. However Peerbox is the only arm compiled wallet. Do you have any specific reason to use Ubuntu over Debian?

Automatic_Monkey · April 25, 2016, 10:45pm

Yes, I’m also staking another coin where Ubuntu is preferred.

oakmaster · April 28, 2016, 1:23am

when trying to install peerbox i keep getting

The following packages have unmet dependencies:
peerbox : Depends: ppcoin but it is not going to be installed
Depends: python-requests (>= 2.4.3-1) but 0.12.1-1+deb7u1 is to be installed
Depends: python-sh (>= 1.09-1) but it is not installable
Depends: python:any (< 2.8) but it is not installable
Depends: python:any (>= 2.7.5-5~) but it is not installable
E: Unable to correct problems, you have held broken packages.

whats the easiest to fix this thank you

irritant · April 28, 2016, 1:32am

[quote=“oakmaster, post:13, topic:3827”]when trying to install peerbox i keep getting

The following packages have unmet dependencies:
peerbox : Depends: ppcoin but it is not going to be installed
Depends: python-requests (>= 2.4.3-1) but 0.12.1-1+deb7u1 is to be installed
Depends: python-sh (>= 1.09-1) but it is not installable
Depends: python:any (< 2.8) but it is not installable
Depends: python:any (>= 2.7.5-5~) but it is not installable
E: Unable to correct problems, you have held broken packages.

whats the easiest to fix this thank you[/quote]

you need to install peercoin and the correct version of python, which should happen automatically
can you do:

python -V

which OS are you using? peerbox only supports debian at the moment

you can find installation instructions for peercoin here:
https://www.peercointalk.org/index.php?topic=4505

peerchemist · April 28, 2016, 8:16am

[quote=“oakmaster, post:13, topic:3827”]when trying to install peerbox i keep getting

The following packages have unmet dependencies:
peerbox : Depends: ppcoin but it is not going to be installed
Depends: python-requests (>= 2.4.3-1) but 0.12.1-1+deb7u1 is to be installed
Depends: python-sh (>= 1.09-1) but it is not installable
Depends: python:any (< 2.8) but it is not installable
Depends: python:any (>= 2.7.5-5~) but it is not installable
E: Unable to correct problems, you have held broken packages.

whats the easiest to fix this thank you[/quote]

Which OS are you using?

oakmaster · April 28, 2016, 11:09am

[quote=“peerchemist, post:15, topic:3827”][quote=“oakmaster, post:13, topic:3827”]when trying to install peerbox i keep getting

The following packages have unmet dependencies:
peerbox : Depends: ppcoin but it is not going to be installed
Depends: python-requests (>= 2.4.3-1) but 0.12.1-1+deb7u1 is to be installed
Depends: python-sh (>= 1.09-1) but it is not installable
Depends: python:any (< 2.8) but it is not installable
Depends: python:any (>= 2.7.5-5~) but it is not installable
E: Unable to correct problems, you have held broken packages.

whats the easiest to fix this thank you[/quote]

Which OS are you using?[/quote]Raspbian that’s why I don’t understand why its giving me problems

oakmaster · April 28, 2016, 11:11am

[quote=“irritant, post:14, topic:3827”][quote=“oakmaster, post:13, topic:3827”]when trying to install peerbox i keep getting

The following packages have unmet dependencies:
peerbox : Depends: ppcoin but it is not going to be installed
Depends: python-requests (>= 2.4.3-1) but 0.12.1-1+deb7u1 is to be installed
Depends: python-sh (>= 1.09-1) but it is not installable
Depends: python:any (< 2.8) but it is not installable
Depends: python:any (>= 2.7.5-5~) but it is not installable
E: Unable to correct problems, you have held broken packages.

whats the easiest to fix this thank you[/quote]

you need to install peercoin and the correct version of python, which should happen automatically
can you do:

python -V

which OS are you using? peerbox only supports debian at the moment

you can find installation instructions for peercoin here:
https://www.peercointalk.org/index.php?topic=4505[/quote]raspbian and it’s saying python 2.7.3

peerchemist · April 28, 2016, 11:15am

Can you please post the output of following command:

sudo cat /etc/apt/sources.list

oakmaster · April 28, 2016, 11:26am

[quote=“peerchemist, post:18, topic:3827”]Can you please post the output of following command:

sudo cat /etc/apt/sources.list[/quote]deb http://mirrordirector.raspbian.org/raspbian/ wheezy main contrib non-free rpi

Uncomment line below then ‘apt-get update’ to enable ‘apt-get source’

#deb-src http://archive.raspbian.org/raspbian/ wheezy main contrib non-free rpi
deb http://peerbox.me/repo jessie main

peerchemist · April 28, 2016, 11:42am

can you try again?

sudo apt-get update

sudo apt-get install peerbox

if it fails:

sudo apt-get -f install