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


#1

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


The Complete Guide to Minting
Peercoin Minting must be always open?
Peercoin on Raspberry Pi
New to Peercoin
Peercoin on Raspberry Pi
Headless mint with Raspberry Pi Guide
Team Update #23: Peercoin v0.7 Released! Upgrade Deadline: March 12th, 2019 at 12:00 UTC!
Introduce Yourself - Important Links
#2

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


#3

How do I set a custom datadir?


#4

peercoind --datadir=“pathToAppData” should do


#5

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.


#6

Oh well, a bit more complicated than I thought :smiley:


#7

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


#8

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.


#9

[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.


#10

[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?


#11

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?


#12

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


#13

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


#14

[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


#15

[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?


#16

[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


#17

[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


#18

Can you please post the output of following command:

sudo cat /etc/apt/sources.list

#19

[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


#20

can you try again?

sudo apt-get update
sudo apt-get install peerbox

if it fails:

sudo apt-get -f install