Skip to content

HOWTO Install razpass

Jens Heine edited this page Feb 19, 2024 · 1 revision

Raspberry Installation

First install the default 64bit Raspberry Pi OS on a SD card.

Razpass Installation

Login to the raspberry with the pi user. Download the Razpass repository to the Download folder

cd Downloads
git clone https://github.com/binbash23/razpass.git

Change into the source folder and execute the first script with sudo

cd razpass/source 
sudo ./razpass_prepare_host.sh

And follow the instructions. Then run the second script as the p user

su p ./razpass_prepare_p_user.sh

That's it. Now you can connect with any device to the Hotspot called "razpass" with the default password razpassrazpass and then open connect with ssh to p@10.42.0.1 (this is the default ip of the razpass in the Hotspot wifi net).

Razpass Login

Per default the razpass creates an ad-hoc wifi network. The network SSID is "razpass" and the password is "razpassrazpass". You can connect from any device to this wifi and then connect with ssh to the p user on the razpass.

ssh p@razpass

If this does not work, try to connect to this ip

ssh p@10.42.0.1

The password program p will start immediatly and you can use it

ssh p@razpass
p@usb-eth's password: 
Linux razpass 6.1.0-rpi8-rpi-v8 #1 SMP PREEMPT Debian 1:6.1.73-1+rpt1 (2024-01-25) aarch64
Last login: Sat Feb 10 22:07:19 2024 from 192.168.1.42
Please wait...

[p] by Jens Heine <binbash@gmx.net> version: 2024.02.10

Database filename         : /home/p/p/p.db
Logical database name     : razpass
Enter database password   : 

Enable razpass to connect to your personal wifi network(s)

If you use the razpass at home or close to some wifi networks you know, it makes sense not to create the ad-hoc wifi network for the razpass. The reason is: when razpass create his own wifi, there is no internet connection. You can not synchronize/merge your passwords or update the p program or update the razpass os.

Show wifi connections with "!showconnections"

[razpass] pshell> !showconnections
NAME                         UUID                                  TYPE      DEVICE 
Hotspot                      56fc6630-6bdc-4c7d-a7a4-b6673dd3c610  wifi      wlan0   
lo                           59383099-0b4a-40f1-a6e3-d40662d11769  loopback  lo     
[razpass] pshell> 

As you can see, razpass knows no wifi network and has opened the ad-hoc wifi network "Hotspot".

Use !scanwifi to print all wifi networks that are around

[razpass] pshell> !scanwifi
IN-USE  BSSID              SSID                      MODE   CHAN  RATE        SIGNAL  BARS  SECURITY  
*       xx:38:xx:D6:xx:xx  xxxxxxxxxx                Infra  6     405 Mbit/s  100     ▂▄▆█  WPA2      
        xx:BF:xx:70:xx:xx  UPCxxxxxxx                Infra  11    270 Mbit/s  70      ▂▄▆_  WPA2  

This command shows all wifi networks thar the razpass can see in the moment. The next step will be to add one of these wifi connections.

Use "!addconnection" to make razpass know your personal wifi networks

If you are at home, you can make razpass connect to your home wifi. This enables you to use razpass with an internet connection. Just type

[razpass] pshell> !addconnection <YOUR_SSID>

and enter the wifi password from your wifi network.

[razpass] pshell> !addconnection YOUR_SSID
Creating new wifi connection for SSID: YOUR_SSID
Enter wifi password for YOUR_SSID: YOUR_WIFI_PASSWORD
Verbindung »YOUR_SSID« (2ab27cc1-e77e-4b75-8d0d-4b4957aeaaa1) erfolgreich hinzugefügt.
The new connection will be activated...

The new wifi connection will be active and razpass will connect to it in the future, if it is available. This also means that your current connection (to the Hotspot) will be disconnected. Connect to your previously configured wifi (YOUR_SSID) and connect with ssh to razpass again. When razpass does not find any known wifi network, it will always fall back to create an ad-hoc wifi network.

Delete a wifi connection

If you want to delete a wifi connection you can do it like this:

[razpass] pshell> !deleteconnection YOUR_SSID
Verbindung »YOUR_SSID« (639ab856-17b9-4b7a-8750-4c33a97a8b29) erfolgreich gelöscht.

Stop or Reboot

You can just pull the usb power cable to switch off the razpass. It might be more gracefull to shut it down or reboot it with these commands

Shutdown razpass:

[razpass] pshell> !halt

Restart razpass:

[razpass] pshell> !reboot