Search

Installation steps can be split into 2 phases: making sure the system is up-to-date to start with (this isn’t specific to the PiRogue ecosystem), then configuring the PiRogue PPA and installing PiRogue packages.

sudo apt-get update
sudo apt-get dist-upgrade

sudo apt-get install wget
sudo wget -O /etc/apt/sources.list.d/pirogue.list https://pts-project.org/debian-12/pirogue.list
sudo wget -O /etc/apt/trusted.gpg.d/pirogue.gpg   https://pts-project.org/debian-12/pirogue.gpg
sudo apt-get update
sudo apt-get install pirogue-base

During the installation, if prompted, you will have to answer:

• Yes to allow non-superusers to capture network traffic.

That’s done!

After the installation of the system, it’s possible to get the current system configuration with the following command:

pirogue-admin-client system get-configuration

And check if everything is correct.

DASHBOARD_PASSWORD: PiRogue
ENABLE_DHCP: 'True'
ENABLE_PUBLIC_ACCESS: 'False'
EXTERNAL_ADDRESS: 192.168.1.37
EXTERNAL_INTERFACE: enp0s3
EXTERNAL_NETWORKS: 192.168.1.0/24
ISOLATED_ADDRESS: 10.8.0.1
ISOLATED_INTERFACE: wg0
ISOLATED_NETWORK: 10.8.0.0/24
PUBLIC_CONTACT_EMAIL: root@pirogue.local
PUBLIC_DOMAIN_NAME: pirogue.local
PUBLIC_EXTERNAL_ADDRESS: 185.199.111.153
SYSTEM_HOSTNAME: pirogue
SYSTEM_OPERATING_MODE: wireguard
WIFI_COUNTRY_CODE: FR
WIFI_PASSPHRASE: superlongkey
WIFI_SSID: PiRogue

Here, we assume :

• a DNS record exists already, pointing to the public IP address of the PiRogue.
• port 80 and 443 from your public IP address fully translate to your server respectives ports

Requesting a certificate and adjusting the web server configuration can be done this way:

pirogue-admin-client external-network enable-public-access --domain pirogue.example.org --email contact@example.org

Once done, you can access to the dashboard on https://pirogue.example.org/dashboard. Make sure you replace pirogue.example.org with the domain name you have configured for your server and replace contact@example.org with your email address to be shared with Let’s Encrypt.

The default username of the dashboard is admin.

As the password of the dashboard is randomly generated during the installation, the following command allows you to retrieve it.

pirogue-admin-client dashboard get-configuration

The password of the dashboard can be changed with:

pirogue-admin-client dashboard set-configuration --password 'mySuperSecretPassword!'