Raspberry Pi – wiser.pepoweb.com

Install a webserver

After we have practiced installing packages and editing files it is time to do a bit more practical setup. Let’s start with a webserver. As this is Linux, you have the choice of which webserver you want to install. The two biggest once are Apache2 and NGINX, but there are others like lighttpd. For now we keep with the first two. Before you continue type the internal IP address of the RPi in your web browser and double check the outcome. After that login to your Pi and install Apache2:

sudo apt install apache2

After the install is done, you can go to your web browser and try the internet IP address again. You should see something like the picture at the start of the article.

So, next let’s make our own webpage. By default Apache stores the pages used for the website in /var/www/html, so let’s make our own page:

sudo vi /var/www/html/index.html

Clear everything that is in this file and put in the following:

<html>
 <head>
  <title>Hello word</title>
 </head>
 <body>
  <h1>Hello world! This is Peter</h1>
 </body>
</html>

After you save this code, you can go back to your web browser and check the result.

As an alternative you can install nginx. Please note: Don’t install Apache2 and Nginx at the same time unless you know what you are doing. As they use the same port and have the same purpose they should not be competing for attention.

sudo apt install nginx

You will get a similar default page that tells you nginx has been installed correctly. After that you can follow the steps described above to make your personal website.

If you want to learn more about HTML, CSS, PHP, JavaScript and other weblanguage -which by themselves are an entire rabbithole- you can check w3schools. They have been giving some of the best tutorials on weblanguages I have come across.

Change hostname

As the Raspberry Pi standard comes with the name raspberrypi, you might want to change this to something more descriptive so if you have more than one Pi in your network, you know which one is which.

The process in easy, you just have to edit one file and reboot your Raspberry Pi.

sudo vi /etc/hostname

Here you can practice your vi skills, or you can change vi in the command for nano. As you see, there is one line in this file that reads raspberrypi. Change this to what you want the pi to be named, and save the document. Then type:

sudo reboot

After a little wait, you can login to your RPi again and you will see the name change has taken effect.

Duckdns (part 2)

With the knowledge we have gained in the previous lessons, we’ll now setup a script to make sure the IP address of your internet connections is automatically updated to DuckDNS so you can also access your Raspberry Pi when your provider decides to change your IP address.

For this we found a nice article during the third online lesson, which can be found here.

The short version is as follows:

mkdir duckdns
cd duckdns
nano duck.sh

enter the following line and edit both the domain (the part you choose before .duckdns.org) and the token (which you can find when you log into DuckDNS at the top.)

echo url="https://www.duckdns.org/update?domains=[YOUR_DOMAIN]&token=[YOUR_TOKEN]&ip=" | curl -k -o ~/duckdns/duck.log -K -

Than change the access rights to the file and edit crontab, which is a job scheduler that in this case run the script we just made every 5 minutes.

chmod 700 duck.sh
crontab -e

Add the following line at the bottom

*/5 * * * * ~/duckdns/duck.sh >/dev/null 2>&1

Than test the script, check the log and start cron so from now on you will not have to remember to update your IP address.

./duck.sh
cat duck.log
sudo service cron start

Edit a file

Back in the old days, the geek ‘holy war’ was between the two editors emacs and vi. For some reason I was introduced to vi and after I got the basics down, the only thing I have done was install the improved version, vim.

More recent a new contender entered the market. With Ubuntu straightening the road to Linux for the not so geeky users, there seemed to be a need for a friendlier editor: nano. I have little experience with the editor and still get confused when I edit something on the command line with it.

On Raspberry OS you will have access to both nano and vi by default, as I am more familiar with vi, I will show you this editor, if you prefer nano, be my guest. To me, one of the beauties of Linux is the freedom of choice. To make you navigation a bit more intuitive you might want to use apt to install vim

vi basics

Command	Explanation
vi <filename>	Open a file for editing
<arrow keys>	navigate through the document
i	insert mode, needed to edit the document
ESC	normal mode
:w	write
:q	exit (after saving or when no changes are made
:q!	exit, discarding changes
u	undo last change

Applications, the basics

Raspberry OS is part of the Debian linux family, so you can install applications and packages with the apt command. As this changes something on your system, you need to be either a privileged user or use the sudo command. Here is an example of a package install:

sudo atp install cmatrix

If it is a single package, the installer will automatically install it. If there are dependencies, you will first get an overview of what will be installed and you are asked to confirm. If you know you want to install the package plus dependencies you can use the -y argument after apt

Now the package has been installed you can run it by typing:

cmatrix

As you might find out, the package runs in the terminal and you do not have access to the terminal until you stop the package. This can be done by using the <ctrl/cmd>+<c> key combination.
To find out which options/arguments you can use running a program you can request the help option:

cmatrix --help or cmatrix -h

Here you get a quick overview of the arguments you can use to run the command. If the list is long you can scroll up by using <shift>+<PgUp/PgDn> (or your mouse).
If you want more information on how to use the command, you can also use the man command:

man cmatrix

Here you can scroll with the arrow up/down. To close the manual you press <q>

Now, let’s find out a bit more about the system we have installed. For this install neofetch and try to change the logo to the ubuntu logo:

sudo apt install neofetch

Connecting safer

Now that we can access our Pi from the internet, let’s turn up the safety a notch higher. We are going to setup SSH using a key pair, also known as public-key authentication.

In short, you create a key pair, you keep the private key on your local machine and copy the public key on the remote machine (the pi). The combination allows access. RSA is still the de facto key pair, developed in 1977, this is pretty impressive. More recently the use of ED25519 is coming up, which is not supported by older machines, but that issue we don’t have.

To generate a basic RSA key pair, you use the following command:

ssh-keygen

To generate a basic ED25519 key pair you user this command:

ssh-keygen -t ed25519

Default this will safe two files in the .ssh folder in your home directory. Remember a dot in front of a file- or folder name means it is hidden. For now we will not set a pass phrase, so you can just hit enter 3 times.

Next thing we need to copy the public key to our Raspberry Pi. For this we use the ssh-copy-id command:

ssh-copy-id -i ~/.ssh/<mykey>.pub pi@<ipaddress>

Here <mykey>.pub should be id_rsa.pub or id_ed25519.pub
After you have copied the public key you can try to ssh into your Pi. You’ll notice you don’t have to enter a password anymore.

It is a good practice to back up your public and private key pair in your password manager.

How to get connected

Cool, so we have a base install of Raspberry Pi OS and we can connect to the Pi on the local network. To be able to connect to it from anywhere, let’s set this up. We kind of lay the Pi to the side and focus on your home router. We are going to do some port forwarding and create a dynamic DNS name.

As about every internet provider comes up with their own router, it is a bit tricky to create up a general manual. Luckily we have the internet to help out here. On https://portforward.com/router.htm you should be able to find your router and find the correct way to setup a port forward.

You want to forward port 22 from the internet to port 22 on your Raspberry Pi’s IP address.

Also a lot of Internet providers do not provide you with a static IP address, we want to do another step to be able to simply reach your Raspberry Pi from anywhere in the world. We setup Dynamic DNS. For this we use the free after registration service of DuckDNS

Go to DuckDNS and login with one of the login options
Create a DuckDNS subdomain
Add the domain to your router

Where am I – Basic CLI

The Linux command line is powerful, but it might take a bit getting used to. In this lesson we start with some navigation and we’ll play with some files. Fun fact, a lot of these commands also work on the Mac command line.

In general when you login into a machine through SSH you’ll end up in the home directory of a user. In this case /home/pi but than. Here is a list of commands and a short explanation of their use.
Now that you have access to the command line, you can give them a try. We’ll get back to them later on in more detail.

Command	Explanation
ls	list, show the content of the directory. Similar to dir in Windows
cd	change directory
clear	clear the output on the screen
mkdir	make directory
rmdir	remove empty directory
touch	create file
rm	remove file or not empty directory
cp	copy
mv	move
man	manual, works on all commands

When you are familiar with these basic commands, you can check out the following.

Command	Explanation
cat	display content of a file
echo	add text to a file – compare > and >>
df	show available/used disk space
du	disk usage, show how the directory is build up
hostname	to find out the name of the machine
uname	find information about system, like distro, kernel, processor
sudo	super user do, in front of a command to have root privileges
apt	debian family packate manager
chmod	change access rights
chown	change owner/group
tar	(un)pack tarball archives
unzip	unpack zip archives

You can use your arrow keys (up and down) to go to to previous typed command, which saves typing.

Let’s start at the start

wiser.pepoweb.com was started to share my Linux knowledge with some coworkers. It is the central place to keep track of the lessons we create together.
We start with a Raspberry Pi 4 and raspbian and go from there.

So as there are enough manuals on the internet with a step by step how to on installing an OS on a Pi, I am not going to bore you with yet another write out. I’ll just list the steps to create a headless setup, so we don’t need additional hardware and wires, except for a network wire. If you need additional information you can follow the link at the bottom.

Download the Raspberry Pi imager from https://www.raspberrypi.com/software/
Run the imager on a computer with an SD card reader
- Pick the OS you want to install (other light)
- Pick the SD card you want to install it on
- Press Write
  ! You can easily enable SSH by pressing Ctrl (Cmd) + Shift + x and enable SSH before hitting the Write button.
  ! Here you can also setup Wifi, if you are not using a wired connection.
Once done, create an empty file in the boot partition called ssh
Put the SD card in the Pi, connect it with a network cable to your router and power it up.
Get the IP address of the pi by one of these options:
- ping raspberrypi.local
- from the DHCP table in your router
- A 3rd party tools to find out the IP
  - nmap on Linux/Mac works well
  - A scanner like https://angryip.org/
SSH into your Pi using: ssh pi@<ipaddress> the default password is raspberry

Welcome to the Linux command line 🙂

Now the first thing you want to do is change the default password. Type passwd and then enter the default password and two times a new password you create.