Difference between revisions of "Raspberry Pi"

Latest revision as of 18:03, 2 July 2026

Libre Space Foundation Raspberry Pi Case, on thingiverse

Introduction

The Raspberry Pi (version 3, 4, and 5) is the reference platform for SatNOGS. See our Ansible guide to install SatNOGS on other Linux machines.

This page assumes you have an account and a ground station registered on either network.satnogs.org or network-dev.satnogs.org. Make note of your station ID and API Key.

Flashing

IMPORTANT: Some essential features from the previous version are currently unavailable in the newer version. Please review the Missing Features Table before flashing. If any of the missing features are critical to your setup, follow the Legacy Software Installation Guide to install the legacy software.

Use the Raspberry Pi Imager, as outlined in the Raspberry Pi OS flashing guidelines, and follow the steps provided there. Along with the official guide, be sure to take into account the instructions provided in the following subsections.

OS selection

To optimize resource usage and reduce installation time and unnecessary running services, we provide a specialized SatNOGS image. To select this image during the Raspberry Pi Imager OS selection process:

Navigate to Other specific-purpose OS
Open SatNOGS submenu
Select SatNOGS (stable, 64-bit)

OS customization

At the very least, you need to:

Set username and password
Set locale settings
- Time zone
- Keyboard layout
Enable SSH

If connection to the internet is via Wi-Fi, make sure to Configure wireless LAN as well.

To easily discover the Rapsberry Pi among other Rapsberry Pis in your network, set a unique hostname.

Getting console access

You can log in the Raspberry Pi by connecting it to a keyboard and monitor or through network via an SSH connection.

Keyboard and monitor

Once your Raspberry Pi is booted, log in with the username and password that you set during the flashing process.

Network

If your network supports zeroconf, you can use the hostname of your Raspberry Pi and log in with SSH using the username and password that you set during the flashing process. Example:

$ ssh pi@raspberrypi.local

If zeroconf is not supported then you must manually find the IP address of the Raspberry Pi (e.g. in your router management interface).

Installation

The SatNOGS Setup installation and configuration tool comes pre-installed with the official SatNOGS Raspberry Pi OS image. To install all necessary software components and configure your system, log in and run:

$ satnogs-setup

If you are using a different supported OS (e.g., standard Raspberry Pi OS or Debian 13 on a laptop/desktop), you can install SatNOGS using the following command: $ curl -sfL https://satno.gs/install | sh -s --

Then, follow SatNOGS Setup instructions to configure the system.

@@ Line 1: / Line 1: @@
-{{Message|This page assumes you have an account and a ground station registered on either network.satnogs.org or network-dev.satnogs.org. Make note of your station ID and API Key.}}
 [[File:B3342fcc865731d69e0c9d7a8b1abb887185bc13 1 531x500.jpg|alt=Libre Space Foundation Raspberry Pi Case|thumb|Libre Space Foundation Raspberry Pi Case, [https://www.thingiverse.com/thing:3233687 on thingiverse]]]
-= Intro =
+==Introduction==
-The Raspberry Pi 3 is the reference platform for SatNOGS (see our [[SatNOGS Client Ansible|Ansible guide]] to install SatNOGS on other Linux machines). You can try using various distributions for this (eg. Arch, Fedora), but the one we suggest is our custom image based on latest Raspbian.
+The Raspberry Pi (version 3, 4, and 5) is the reference platform for SatNOGS. See our [[SatNOGS Client Ansible|Ansible guide]] to install SatNOGS on other Linux machines.
-== [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2018080300/download?job=release Download]==
+{{Message|This page assumes you have an account and a ground station registered on either network.satnogs.org or network-dev.satnogs.org. Make note of your station ID and API Key.}}
-[https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2018080300/download?job=release <span class="glyphicon glyphicon-save"></span>]
-You can download the latest Raspbian SatNOGS image following the links from the [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/tags latest tag on GitLab]. This image has the SatNOGS setup script installed, the SSH server enabled and all required packages preinstalled. Click on the cloud icon and then click "Download release". You will get an Artifacts.zip file:
-=== Artifacts list ===
-The current artifacts list consists of:
-* A Zipped image file
-* An Image info file
-* A SHA256 checksums file
-== Data integrity verification ==
-You should verify the data integrity of the artifacts by checking the SHA256 checksums. On Linux, run <code>sha256sum -c sha256sums</code> in the directory where the artifacts are downloaded
-Example:
-<pre>
-$ sha256sum -c sha256sums
--09-29-Raspbian-SatNOGS-master-lite.info: OK
-image_2017-09-29-Raspbian-SatNOGS-master-lite.zip: OK
-</pre>
-== Flashing ==
-[https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.
-== Configuration==
-The Raspberry Pi can be set up by connecting it to a keyboard and monitor, by connecting it to wired Ethernet, or by editing files in the /boot mount on the flashed USB stick.
-=== Modifying the /boot mount ===
-This eliminates the need for a keyboard and monitor. Note your OS may mount /boot in a different location, and [https://raspberrypi.stackexchange.com/questions/10251/prepare-sd-card-for-wifi-on-headless-pi#comment98121_57023 Windows users have line ending problems]. Suggested actions:
-Set up wifi:
+==Flashing==
+{{Warning|IMPORTANT: Some essential features from the previous version are currently unavailable in the newer version. Please review the [[SatNOGS Setup#Missing_features|Missing Features Table]] before flashing. If any of the missing features are critical to your setup, follow the [[Raspberry_Pi_Legacy|Legacy Software Installation Guide]] to install the legacy software.}}Use the '''Raspberry Pi Imager''', as outlined in the [https://www.raspberrypi.com/documentation/computers/getting-started.html#raspberry-pi-imager Raspberry Pi OS flashing guidelines], and follow the steps provided there. Along with the official guide, be sure to take into account the instructions provided in the following subsections.
-    edit /boot/wpa_supplicant.conf
+===OS selection===
+To optimize resource usage and reduce installation time and unnecessary running services, we provide a specialized SatNOGS image. To select this image during the Raspberry Pi Imager OS selection process:
-contents: (note key_mgmt options include NONE, WPA-PSK, WPA-EAP)
+#Navigate to <code>Other specific-purpose OS</code>
+#Open <code>SatNOGS</code> submenu
+#Select <code>SatNOGS (stable, 64-bit)</code>
-    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
+===OS customization===
-    update_config=1
+At the very least, you need to:
-    country=US
-    network={
-        ssid="NETWORK_NAME"
-        psk="password"
-        key_mgmt=WPA-PSK
-    }
-=== Ethernet ===
+*Set username and password
-If you are using wired Ethernet you should get connectivity right away.
+*Set locale settings
+**Time zone
+**Keyboard layout
+*Enable SSH
-=== Wireless setup ===
-If you are using wireless then see [https://www.raspberrypi.org/documentation/configuration/wireless/wireless-cli.md this doc for network configuration instructions] after booting.
-== Keyboard and monitor setup ==
+If connection to the internet is via Wi-Fi, make sure to '''Configure wireless LAN''' as well.
-Once your Raspberry Pi is booted, log in with username "pi" password "raspberry" and run:
-<pre>
-sudo raspi-config
-</pre>
-You will want to be sure to do the following:
+To easily discover the Rapsberry Pi among other Rapsberry Pis in your network, '''set a unique hostname'''.
-* Set a strong, unique password
+==Getting console access==
-* Change localization settings:
+You can log in the Raspberry Pi by connecting it to a keyboard and monitor or through network via an SSH connection.
-** by default the rpi locale is configured for EN-GB, change as appropriate (ie: to EN_US.UTF-8)
-** set timezone (we recommend UTC so your logs match the times in Network)
-** set keyboard layout, again this is defaulting to a UK layout
-** set wifi country
-** expand filesystem
-* Finish and reboot
+===Keyboard and monitor===
+Once your Raspberry Pi is booted, log in with the username and password that you set during the flashing process.
-== SatNOGS Setup ==
+===Network===
+If your network supports [[wikipedia:Zero-configuration_networking|<code>zeroconf</code>]], you can use the hostname of your Raspberry Pi and log in with SSH using the username and password that you set during the flashing process. Example:
+ $ ssh pi@raspberrypi.local
+If <code>zeroconf</code> is not supported then you must manually find the IP address of the Raspberry Pi (e.g. in your router management interface).
-SSH to the Raspberry Pi with user "pi" and password "raspberry" (no quotes).
+==Installation==
+The '''SatNOGS Setup''' installation and configuration tool comes pre-installed with the official SatNOGS Raspberry Pi OS image. To install all necessary software components and configure your system, log in and run:
+ $ satnogs-setup
-Follow [[SatNOGS_Client_Ansible#SatNOGS_Client_Setup|SatNOGS Client Setup]] instructions to configure the system.
+{{Message|If you are using a different supported OS (e.g., standard Raspberry Pi OS or Debian 13 on a laptop/desktop), you can install SatNOGS using the following command: <code>$ curl -sfL https://satno.gs/install {{!}} sh -s --</code>}}
-= Fedora =
+Then, follow [[SatNOGS Setup]] instructions to configure the system.
-Instructions for installing on Fedora can be found [[Fedora_Installation|here]].
+[[Category:Build]]
+[[Category:Software]]