Raspberry Pi Guide

Raspberry Pi Guide

Follow the guide below for step-by-step directions to set up a fresh Raspberry Pi.

Minimal Requirements

• Raspberry Pi 5
• 8GB RAM
• 256GB SD card
• Case
• Power Plug
• Heat sinks

Look for a kit that includes all of these for about $129. You may need to buy a larger SD card separately.

• Assemble your Raspberry Pi Kit

Other Requirements

• A free domain configured with Dynamic DNS, such as one from No-IP
• Port 443, 2283, and 32400 must be forwarded to your machine from your router
• To use "Download Managers," a paid VPN subscription is required
  • Log in to your VPN provider and download a WireGuard configuration file

Raspberry Pi Setup

We first need to prepare our SD card with the Raspberry Pi operating system, Wi-Fi settings, and login information.

Raspberry Pi Imager

• Download and install the Raspberry Pi Imager from the official website.

• Insert your SD card into your PC.

• Open Raspberry Pi Imager.

  

• For "Raspberry Pi Device," select Raspberry Pi 5.

• For "Operating System," select Raspberry Pi OS (64-bit).

• For "Storage," carefully select the correct SD card.

• Click Next.

• A screen will pop up asking "Would you like to apply OS customization settings?"

• Click Edit Settings.

• View the General tab.

  

• Check the box for "Set hostname" and type in cloud.

• Check the box for "Set username and password" and create a Username and Password.

• Check the box for "Configure wireless LAN." Enter the name of your wireless SSID and Password. Change the "Wireless LAN country" to your country.

• Click the button that says "Set locale settings" and select your Time zone.

• Click the Services tab.

  

• Check the box for Enable SSH and leave the option selected for Use password authentication.

• Click Save.

• Click Yes on the "Use OS customization" screen.

• You will see a warning screen.

  

• Verify that you have selected the correct storage device, then click Yes.

• The configuration and OS will now be written to the SD card.

  

• Remove the SD card and close the Raspberry Pi Imager program.

Booting

• Insert the SD card into your Raspberry Pi.
• Connect the power.
• Wait about five minutes.

Installing klack.cloud

We now need to connect remotely to the Raspberry Pi to enter some commands.

Connecting to the Raspberry Pi on Windows

• Open Windows PowerShell on your PC.

• Type ssh your-username@cloud.local and press enter.
  Type yes when prompted "Are you sure you want to continue connecting?"
  Enter your password.

  ⚠️ If you are re-installing from scratch, and receive the error "WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!", we need to delete a file. Run del C:\\Users\\username/.ssh/known_hosts. Replace "username" with your Windows username. It is displayed in the error message.

  

Install Prerequisite Software

We need to install some base programs, including Docker.

• Copy and paste the following:

  sudo apt update && sudo apt install ca-certificates curl uidmap openssl jq xxd uuid-runtime -y && \
  curl -fsSL https://get.docker.com -o get-docker.sh && \
  sudo sh ./get-docker.sh && sudo usermod -aG docker $USER && newgrp docker

• Wait a few minutes for the installation to complete.

Install klack.cloud

• Paste the following commands:

  git clone --recurse-submodules https://github.com/klack/klack.cloud.git && \
  cd klack.cloud && \
  nano vpn.conf

• Paste the contents of the VPN file you downloaded.
  Press Ctrl-o to save.
  Press Enter to confirm.
  Press Ctrl-x to exit.

  

• Now run

  ./setup.sh

• Enter your free No-IP domain name.

• Create a username and password.

• Installation will begin.

  

• Wait several minutes.

• You will be prompted to enter a Plex claim token. Visit https://plex.tv/claim to create a token. Create an account if you do not already have one.

• Paste in your Plex claim token and press Enter.

Finishing Setup

• You'll see a message that says "Visit your homepage at http://"