Raspberry Pi - Revision history

Fredy: Add warning about version incompatibility

2025-10-05T08:03:43Z

Add warning about version incompatibility

Acinonyx: /* Flashing */

2025-01-11T13:56:24Z

‎Flashing

Acinonyx: Add warning for missing features.

2025-01-11T13:51:33Z

Add warning for missing features.

Acinonyx at 15:42, 10 January 2025

2025-01-10T15:42:34Z

Acinonyx at 15:42, 10 January 2025

2025-01-10T15:42:11Z

Acinonyx at 14:41, 10 January 2025

2025-01-10T14:41:35Z

Acinonyx: Adapt documentation based on new software stack

2025-01-10T14:27:11Z

Adapt documentation based on new software stack

Kerel+satnogs: /* Download */ Update to SatNOGS image release 2023111400

2024-02-20T21:41:23Z

‎Download: Update to SatNOGS image release 2023111400

Bill.rupp: The imaging process has changed. the userID of pi and pw of raspberry no longer work.

2023-01-09T13:40:59Z

The imaging process has changed. the userID of pi and pw of raspberry no longer work.

Danwhite: /* Raspberry Pi Setup */ Add note about creating the "pi" user with the new image.

2022-09-18T19:37:55Z

‎Raspberry Pi Setup: Add note about creating the "pi" user with the new image.

← Older revision		Revision as of 08:03, 5 October 2025
Line 11:		Line 11:

	===OS selection===		===OS selection===
		+	{{Warning\|IMPORTANT: Currently the supported <code>Raspberry Pi OS</code> version is the <code>bookworm</code>, if you use <code>Raspberry Pi Imager</code>, make sure you have selected the right version, which currently is under the <code>Raspberry Pi OS (other)</code> menu. Support for the new stable version (<code>trixie</code>) [https://gitlab.com/groups/librespacefoundation/satnogs/-/milestones/23 is planned to be supported in the future]}}
	To optimize resource usage and reduce unnecessary running services, choose the Raspberry Pi OS Lite image instead of the full Raspberry Pi OS image. During the OS selection process, navigate to the <code>Raspberry Pi OS (other)</code> submenu and select <code>Raspberry Pi OS Lite (64-bit)</code>.		To optimize resource usage and reduce unnecessary running services, choose the Raspberry Pi OS Lite image instead of the full Raspberry Pi OS image. During the OS selection process, navigate to the <code>Raspberry Pi OS (other)</code> submenu and select <code>Raspberry Pi OS Lite (64-bit)</code>.

@@ Line 8: / Line 8: @@
 ==Flashing==
-{{Warning|IMPORTANT: Some key features from the previous version are currently missing in the newer version! Review the [[SatNOGS Setup#Missing_features|missing features]] before flashing!}}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.
+{{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.
 ===OS selection===

@@ Line 8: / Line 8: @@
 ==Flashing==
-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.
+{{Warning|IMPORTANT: Some key features from the previous version are currently missing in the newer version! Review the [[SatNOGS Setup#Missing_features|missing features]] before flashing!}}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.
 ===OS selection===

@@ Line 41: / Line 41: @@
 To install the SatNOGS software on the Raspberry Pi OS or any other supported OS you just log, and execute the following command:
   $ curl -sfL https://satno.gs/install | sh -s --
-This command executes the '''SatNOGS Setup''' tool which will install all the necessary software and then bring up the SatNOGS configuration menu-driven utility:
+This command executes the '''SatNOGS Setup''' tool which will install all the necessary software and then bring up the SatNOGS configuration menu-driven utility.
 Follow [[SatNOGS Setup]] instructions to configure the system.

@@ Line 41: / Line 41: @@
 To install the SatNOGS software on the Raspberry Pi OS or any other supported OS you just log, and execute the following command:
   $ curl -sfL https://satno.gs/install | sh -s --
-This command will install all the necessary software and then bring up the '''SatNOGS Setup''' configuration tool:
+This command executes the '''SatNOGS Setup''' tool which will install all the necessary software and then bring up the SatNOGS configuration menu-driven utility:
 Follow [[SatNOGS Setup]] instructions to configure the system.

@@ Line 10: / Line 10: @@
 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.
-=== OS selection ===
+===OS selection===
 To optimize resource usage and reduce unnecessary running services, choose the Raspberry Pi OS Lite image instead of the full Raspberry Pi OS image. During the OS selection process, navigate to the <code>Raspberry Pi OS (other)</code> submenu and select <code>Raspberry Pi OS Lite (64-bit)</code>.
-=== OS customization ===
+===OS customization===
 At the very least, you need to:
-* Set username and password
+*Set username and password
-* Set locale settings
+*Set locale settings
-** Time zone
+**Time zone
-** Keyboard layout
+**Keyboard layout
-* Enable SSH
+*Enable SSH
@@ Line 39: / Line 39: @@
 ==Installation==
-To install the SatNOGS software on the Raspberry Pi OS you just logged into, execute the following command:
+To install the SatNOGS software on the Raspberry Pi OS or any other supported OS you just log, and execute the following command:
   $ curl -sfL https://satno.gs/install | sh -s --
 This command will install all the necessary software and then bring up the '''SatNOGS Setup''' configuration tool:
 Follow [[SatNOGS Setup]] instructions to configure the system.
 [[Category:Build]]
 [[Category:Software]]

@@ Line 3: / Line 3: @@
 ==Introduction==
-The Raspberry Pi (version 3 and 4) 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. Debian/Armbian, 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).
 {{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.}}
-==Download==
+==Flashing==
-'''<big>Raspbian SatNOGS Image:</big> <big>[https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2023111400/download?job=release artifacts.zip]</big> '''  (Release: 2023111400)
+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.
-You should verify the data integrity of the artifacts by comparing the SHA256 checksums. On Linux, run <code>sha256sum -c sha256sums</code> in the directory where the artifacts are downloaded and unzipped.
+=== OS selection ===
-Example:
+=== OS customization ===
-<pre>
+At the very least, you need to:
-==Flashing==
+* Set username and password
-[https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.
+* Set locale settings
 ==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 userID and password that you set during the imaging process.
+Once your Raspberry Pi is booted, log in with the username and password that you set during the flashing process.
-===Ethernet===
+===Network===
-If you are using wired Ethernet you should get connectivity right away. You just need to find the IP address of Raspberry Pi (e.g. in your router management interface). Log in with SSH using username you set during the image writing process.   "'''pi'''" password "'''raspberry'''", in this example:
+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
-===Pre-boot wireless configuration===
+==Installation==
-If neither keyboard/monitor, nor a wired Ethernet are available, you can set up a WiFi connection before boot by mounting the boot partition of the flashed SD card and editing files directly. Note your OS may mount boot partition in a different location. [https://raspberrypi.stackexchange.com/questions/10251/prepare-sd-card-for-wifi-on-headless-pi#comment98121_57023 Windows users have line ending problems]. Suggested actions:
+To install the SatNOGS software on the Raspberry Pi OS you just logged into, execute the following command:
+ $ curl -sfL https://satno.gs/install | sh -s --
- $ $EDITOR /media/Raspbian_SatNOGS-boot/wpa_supplicant.conf
+This command will install all the necessary software and then bring up the '''SatNOGS Setup''' configuration tool:
-===SatNOGS Setup===
+Follow [[SatNOGS Setup]] instructions to configure the system.
 [[Category:Build]]
 [[Category:Software]]

@@ Line 8: / Line 8: @@
 ==Download==
-'''<big>Raspbian SatNOGS Image:</big> <big>[https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2022091000/download?job=release artifacts.zip]</big> '''  (Release: 2022091000)
+'''<big>Raspbian SatNOGS Image:</big> <big>[https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/-/jobs/artifacts/2023111400/download?job=release artifacts.zip]</big> '''  (Release: 2023111400)
 Download the latest Raspbian SatNOGS Image from above (or via the "Download" icon on the right side of the [https://gitlab.com/librespacefoundation/satnogs/satnogs-pi-gen/tags latest tag page on GitLab]). This image has the SatNOGS setup script installed, the SSH server enabled and all required packages preinstalled. You will get an <code>artifacts.zip</code> file with the following content:
@@ Line 23: / Line 23: @@
 <pre>
 $ sha256sum -c sha256sums
--09-10-Raspbian-SatNOGS-master-lite.info: OK
+-11-14-Raspbian-SatNOGS-master-lite.info: OK
-image_2022-09-10-Raspbian-SatNOGS-master-lite.zip: OK
+image_2023-11-14-Raspbian-SatNOGS-master-lite.zip: OK
 </pre><br />
 ==Flashing==
 [https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.

@@ Line 27: / Line 27: @@
 </pre><br />
 ==Flashing==
 [https://www.raspberrypi.org/documentation/installation/installing-images/README.md Follow the usual Raspbian flashing instructions], and boot your Raspberry Pi.
 ==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 username "'''pi'''" password "'''raspberry'''".
+Once your Raspberry Pi is booted, log in with userID and password that you set during the imaging process.
 ===Ethernet===
-If you are using wired Ethernet you should get connectivity right away. You just need to find the IP address of Raspberry Pi (e.g. in your router management interface). Log in with SSH using username "'''pi'''" password "'''raspberry'''", for example:
+If you are using wired Ethernet you should get connectivity right away. You just need to find the IP address of Raspberry Pi (e.g. in your router management interface). Log in with SSH using username you set during the image writing process.   "'''pi'''" password "'''raspberry'''", in this example:
   $ ssh pi@192.168.1.2
 If your network supports [[wikipedia:Zero-configuration_networking|<code>zeroconf</code>]], then you can use the hostname of your Pi:
@@ Line 58: / Line 64: @@
+     }
-=== Pre-boot user creation ===
+===Pre-boot user creation===
 The latest version of Raspberry Pi OS, of which the SatNOGS image is based on, '''does not''' have the "'''pi'''" user already upon first boot.
 If you wish to login using ssh upon the first boot with the prior default username / password of "pi" / "raspberry", then:
-* Create the file <code>userconf.txt</code> in the root of the <code>boot</code> partition of the uSD card.
+*Create the file <code>userconf.txt</code> in the root of the <code>boot</code> partition of the uSD card.
-* Its contents should be the single line:
+*Its contents should be the single line:
-** <code>pi:$6$/XOZsG1X0IAbhXB0$wYZHRkvib0SUKQA3KVAxofPR.JsFAbI2NCue2znGvhRsQobVdllFXyQZ7fMSvAoyEj8MfHtkMeSZT7IRIixg01</code>
+**<code>pi:$6$/XOZsG1X0IAbhXB0$wYZHRkvib0SUKQA3KVAxofPR.JsFAbI2NCue2znGvhRsQobVdllFXyQZ7fMSvAoyEj8MfHtkMeSZT7IRIixg01</code>
-** (the format is username:encrypted-password)
+**(the format is username:encrypted-password)
 For more information about this file, see: [https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-a-user Raspberry Pi Documentation - Configuration - Setting up a Headless Raspberry Pi - Configuring a User]
@@ Line 73: / Line 79: @@
 ===Raspberry Pi Setup===
-Once your Raspberry Pi is booted, log in with username "'''pi'''" password "'''raspberry'''" and run:
+If you used the advance settings during imaging, this step can be skipped.
 <pre>
 $ sudo raspi-config
@@ Line 91: / Line 99: @@
 ===SatNOGS Setup===
-SSH to the Raspberry Pi with user "'''pi'''" and your new password.
+SSH to the Raspberry Pi with userID you set during imaging password.
 Follow [[SatNOGS Client Setup]] instructions to configure the system.

← Older revision		Revision as of 19:37, 18 September 2022
Line 58:		Line 58:
	}		}

		+	=== Pre-boot user creation ===
		+	The latest version of Raspberry Pi OS, of which the SatNOGS image is based on, '''does not''' have the "'''pi'''" user already upon first boot.
		+
		+	If you wish to login using ssh upon the first boot with the prior default username / password of "pi" / "raspberry", then:
		+
		+	* Create the file <code>userconf.txt</code> in the root of the <code>boot</code> partition of the uSD card.
		+	* Its contents should be the single line:
		+	** <code>pi:$6$/XOZsG1X0IAbhXB0$wYZHRkvib0SUKQA3KVAxofPR.JsFAbI2NCue2znGvhRsQobVdllFXyQZ7fMSvAoyEj8MfHtkMeSZT7IRIixg01</code>
		+	** (the format is username:encrypted-password)
		+
		+	For more information about this file, see: [https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-a-user Raspberry Pi Documentation - Configuration - Setting up a Headless Raspberry Pi - Configuring a User]
		+	<br />
	==Configuration==		==Configuration==