Raspberry Pi on KTDEVX

Build a Git Server at Home with a Raspberry Pi

ktdevx@gmail.com (Kaito Takemura) — Mon, 30 Sep 2024 00:41:00 +0900

Building a Git server at home is useful when you do not want to publish your source code or want to customize the server yourself.

Let’s build a Git server using a Raspberry Pi, which is inexpensive and has extensive documentation available online.

# Network Configuration

The network configuration is as follows.

A Git server is built on the Raspberry Pi so that PCs on the same network can access it.

# Prepare the Raspberry Pi

## Install the OS

First, install an OS on the Raspberry Pi. A GUI is unnecessary for a server, so Raspberry Pi OS Lite is installed in this example.

Raspberry Pi OS Lite is an OS for Raspberry Pi devices and can be downloaded from the official website. Detailed installation instructions are available on the Raspberry Pi official website.

## Set a Static IP Address

Assign a static IP address so that the Raspberry Pi can always be accessed at the same address.

Run the following command to change the IP address settings.

sudo vi /etc/dhcpcd.conf

When the text editor starts, append the following to the file.

interface eth0
static ip_address=192.168.0.2/24
static routers=192.168.0.1
static domain_name_servers=192.168.0.1

This example specifies an IP address of 192.168.0.2, a subnet mask of 255.255.255.0, and 192.168.0.1 as the default gateway and DNS server.

Save the file and restart the Raspberry Pi with the following command.

sudo reboot

The IP address is now static.

## Enable the SSH Server

Enable SSH access so that you can connect to the Raspberry Pi over SSH. Detailed instructions are available in the following article.

Enable SSH Access on Raspberry Pi OS

# Install Git

Run the following commands to install Git on the server.

sudo apt update
sudo apt install git

Git is now installed on the server.

# Add the Git User and Create a Directory

Create a user named git on the server for Git operations.

sudo adduser git

When prompted for a password, enter one of your choice and press Enter. Enter the same password again when prompted. The git user is created.

Next, create a directory to store Git repositories.

sudo mkdir /opt/git
sudo chown git:git /opt/git

These commands create a directory named git under /opt and change its owner to the git user. This allows the git user to read and write Git repositories created under /opt/git.

From this point on, perform operations on the server as the git user. Switch users with the following command.

su git

# Register an SSH Public Key

Generating an SSH key enables secure communication with the Git server. Register a public key so that you can access the Git server over SSH.

Run the following command on the PC to generate an SSH key.

ssh-keygen

Press Enter to generate the key using the default settings. With the default settings, a private key named id_rsa and a public key named id_rsa.pub are generated in the .ssh directory.

To access the server over SSH, register the public key on the server. Transfer the public key you generated to the server using FTP or SFTP.

After transferring the public key, create a file named authorized_keys under the .ssh directory and register the public key in it. Run the following commands on the server to create authorized_keys.

cd
mkdir .ssh && chmod 700 .ssh
touch .ssh/authorized_keys && chmod 600 .ssh/authorized_keys

An empty authorized_keys file is created. Add the public key you generated earlier to this file.

cat <directory-containing-public-key>/id_rsa.pub >> ~/.ssh/authorized_keys

The public key is now added to authorized_keys.

# Create a Git Repository

Run the following commands to create a repository on the Git server.

mkdir /opt/git/project.git
cd /opt/git/project.git
git init --bare

This example creates a Git repository named project.git.

Running git init with the --bare option creates an empty repository without a working directory. This is called a bare repository.

By convention, a bare repository directory name ends with .git.

# Clone the Git Repository

Run the following command to clone the repository.

git clone git@192.168.0.2:/opt/git/project.git

You have now built a Git server at home using a Raspberry Pi.

Install Ubuntu on a Raspberry Pi

ktdevx@gmail.com (Kaito Takemura) — Mon, 30 Sep 2024 00:26:00 +0900

In addition to Raspberry Pi OS, you can also boot Ubuntu on a Raspberry Pi.

This article explains how to install Ubuntu on a Raspberry Pi.

# Install Raspberry Pi Imager

Install a tool called Raspberry Pi Imager to write Ubuntu to a microSD card.

Download the tool from the official website and install it on your PC.

# Write Ubuntu to a microSD Card

Write Ubuntu to a microSD card. Insert the microSD card into your PC and launch Raspberry Pi Imager.

Select OS, Other general-purpose OS, and Ubuntu in that order to display the list of Ubuntu versions available for installation.

Select the OS you want to install.

After selecting the OS, select the microSD card to which you want to write Ubuntu from Storage.

If the OS and storage selections are correct, select Write to start writing the image.

Wait a while for the writing process to complete.

# Boot Ubuntu

Insert the microSD card containing Ubuntu into the Raspberry Pi and turn it on.

When prompted to log in, enter ubuntu as the username and password.

Ubuntu 22.04.2 LTS ubuntu tty1
ubuntu login: ubuntu
Password:

On the first login, you are prompted to change the password. Enter a new password of your choice.

You are required to change your password immediately (administrator enforced).
Changing password for ubuntu.
Current password:
New password:
Retype new password:

Ubuntu is now ready to use on the Raspberry Pi.

Enable SSH Access on Raspberry Pi OS

ktdevx@gmail.com (Kaito Takemura) — Mon, 30 Sep 2024 00:16:27 +0900

Raspberry Pi OS is an operating system for Raspberry Pi devices provided by the Raspberry Pi Foundation. Enabling SSH access allows you to access your Raspberry Pi remotely.

This article explains how to enable SSH access on Raspberry Pi OS.

# Launch the Configuration Tool

Run the following command to launch the Raspberry Pi configuration tool.

sudo raspi-config

# Enable the SSH Server

After running the command, the configuration screen is displayed. Move the cursor to Interface Options and press Enter.

The interfaces for which you can enable or disable settings are displayed. Move the cursor to SSH and press Enter.

You are asked whether to enable the SSH server. Select Yes.

The SSH server is enabled. Press Enter to return to the top of the configuration screen.

Select Finish to close the configuration tool.

# Restart the SSH Server

Run the following command to restart the SSH server.

sudo systemctl restart ssh

SSH access is now enabled on Raspberry Pi OS. You can access the Raspberry Pi remotely over SSH from another computer.