Skip to content

Commit

Permalink
Replace Raspbian with Raspberry Pi OS (#1571)
Browse files Browse the repository at this point in the history
* Replace Raspbian with Raspberry Pi OS

* Update README.md

* Update noobs.md

* Update backup.md

* Update linux.md

* Update linux.md

Co-authored-by: James Hughes <james.hughes@raspberrypi.com>
  • Loading branch information
JamesH65 and JamesH65 committed May 28, 2020
1 parent fe6b878 commit 430b92f
Show file tree
Hide file tree
Showing 76 changed files with 181 additions and 179 deletions.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Expand Up @@ -13,7 +13,7 @@ When creating an issue, please:
Creating a pull request:

- If your contribution regards typos and spelling mistakes, feel free to fix these, and they'll be merged if they accord with our [in-house style guide](https://github.com/raspberrypilearning/style-guide/blob/master/style-guide.md). Otherwise, always open an issue first. This will allow us to determine whether or not the change should take place. Explain your issue, and we will discuss it with you. If we agree the change is necessary, we will mark it as 'TODO'. Then we will either fix it when we get a chance, or allow a member of the community to supply the change with a pull request.
- Note that this documentation is intended to be a short and concise set of helpful resources aimed at the majority of users. We will only feature our recommended distribution, Raspbian, in detail; in order to keep the documentation manageable, we will not accept additions covering alternative distributions.
- Note that this documentation is intended to be a short and concise set of helpful resources aimed at the majority of users. We will only feature our recommended distribution, Raspberry Pi OS, in detail; in order to keep the documentation manageable, we will not accept additions covering alternative distributions.

Find a short tutorial on making changes using GitHub [here](using-github.md).

Expand Down
2 changes: 1 addition & 1 deletion README.md
Expand Up @@ -16,7 +16,7 @@ This is the official documentation for the Raspberry Pi, written by the [Raspber
- Accessing your Pi remotely via SSH, VNC or over the web
- [Linux](linux/README.md)
- Fundamental Linux usage for beginners and more advanced information for power users
- [Raspbian](raspbian/README.md)
- [Raspberry Pi OS](raspbian/README.md)
- Information about the recommended operating system for Raspberry Pi
- [Hardware](hardware/README.md)
- Technical specifications about the Raspberry Pi hardware and the camera module
Expand Down
2 changes: 1 addition & 1 deletion configuration/README.md
Expand Up @@ -5,7 +5,7 @@ Some basic guides to configuring your Raspberry Pi.
## Contents

- [raspi-config](raspi-config.md)
- The Raspberry Pi configuration tool in Raspbian, which allows you to easily enable features such as the camera, and to change your specific settings such as keyboard layout
- The Raspberry Pi configuration tool in Raspberry Pi OS, which allows you to easily enable features such as the camera, and to change your specific settings such as keyboard layout
- [config.txt](config-txt/README.md)
- The Raspberry Pi configuration file
- [TCP/IP networking](tcpip/README.md)
Expand Down
2 changes: 1 addition & 1 deletion configuration/boot_folder.md
@@ -1,6 +1,6 @@
# The boot folder

In a basic [Raspbian](../raspbian/README.md) install, the boot files are stored on the first partition of the SD card, which is formatted with the FAT file system. This means that it can be read on Windows, macOS, and Linux devices.
In a basic [Raspberry Pi OS](../raspbian/README.md) install, the boot files are stored on the first partition of the SD card, which is formatted with the FAT file system. This means that it can be read on Windows, macOS, and Linux devices.

When the Raspberry Pi is powered on, it loads various files from the boot partition/folder in order to start up the various processors, then it boots the Linux kernel.

Expand Down
6 changes: 3 additions & 3 deletions configuration/device-tree.md
Expand Up @@ -201,7 +201,7 @@ Each fragment consists of two parts: a `target` property, identifying the node t
};
};
```
(In fact, with a sufficiently new version of `dtc` you can write it exactly like that and get identical output, but some homegrown tools don't understand this format yet so any overlay that you might want to be included in the standard Raspbian kernel should be written in the old format for now).
(In fact, with a sufficiently new version of `dtc` you can write it exactly like that and get identical output, but some homegrown tools don't understand this format yet so any overlay that you might want to be included in the standard Raspberry Pi OS kernel should be written in the old format for now).

The effect of merging that overlay with a standard Raspberry Pi base Device Tree (e.g. `bcm2708-rpi-b-plus.dtb`), provided the overlay is loaded afterwards, would be to enable the I2S interface by changing its status to `okay`. But if you try to compile this overlay using:

Expand Down Expand Up @@ -622,7 +622,7 @@ dtoverlay=acme-board
dtparam=foo=bar,level=42
```

This will cause the loader to look for `overlays/acme-board.dtbo` in the firmware partition, which Raspbian mounts on `/boot`. It will then search for parameters `foo` and `level`, and assign the indicated values to them.
This will cause the loader to look for `overlays/acme-board.dtbo` in the firmware partition, which Raspberry Pi OS mounts on `/boot`. It will then search for parameters `foo` and `level`, and assign the indicated values to them.

The loader will also search for an attached HAT with a programmed EEPROM, and load the supporting overlay from there - either directly or by name from the "overlays" directory; this happens without any user intervention.

Expand All @@ -633,7 +633,7 @@ There are several ways to tell that the kernel is using Device Tree:

With a Device Tree, the kernel will automatically search for and load modules that support the indicated enabled devices. As a result, by creating an appropriate DT overlay for a device you save users of the device from having to edit `/etc/modules`; all of the configuration goes in `config.txt`, and in the case of a HAT, even that step is unnecessary. Note, however, that layered modules such as `i2c-dev` still need to be loaded explicitly.

The flipside is that because platform devices don't get created unless requested by the DTB, it should no longer be necessary to blacklist modules that used to be loaded as a result of platform devices defined in the board support code. In fact, current Raspbian images ship with no blacklist files (except for some WLAN devices where multiple drivers are available).
The flipside is that because platform devices don't get created unless requested by the DTB, it should no longer be necessary to blacklist modules that used to be loaded as a result of platform devices defined in the board support code. In fact, current Raspberry Pi OS images ship with no blacklist files (except for some WLAN devices where multiple drivers are available).

<a name="part3.2"></a>
### 3.2: DT parameters
Expand Down
10 changes: 5 additions & 5 deletions configuration/localisation.md
Expand Up @@ -11,9 +11,9 @@ To change the language used by NOOBS, you can either press the `L` key on your k

Alternatively, you can pre-select the language before booting NOOBS for the first time. See [here](https://github.com/raspberrypi/noobs/blob/master/README.md#how-to-change-the-default-language-keyboard-layout-display-mode-or-boot-partition).

### Raspbian
### Raspberry Pi OS

If you've installed Raspbian using NOOBS, it should automatically pick up the same language you were using within NOOBS. But if you want to select a different language, or if you've installed Raspbian from a standalone image, use [raspi-config](raspi-config.md#change-locale).
If you've installed Raspberry Pi OS using NOOBS, it should automatically pick up the same language you were using within NOOBS. But if you want to select a different language, or if you've installed Raspberry Pi OS from a standalone image, use [raspi-config](raspi-config.md#change-locale).


## Keyboard
Expand All @@ -24,9 +24,9 @@ To change the keyboard layout used by NOOBS, you can either press the `9` key on

Alternatively, you can pre-select the keyboard before booting NOOBS for the first time. See [here](https://github.com/raspberrypi/noobs/blob/master/README.md#how-to-change-the-default-language-keyboard-layout-display-mode-or-boot-partition).

### Raspbian
### Raspberry Pi OS

If you've installed Raspbian using NOOBS, it should automatically pick up the same keyboard you were using in NOOBS. But if you want to select a different keyboard, or if you've installed Raspbian from a standalone image, use [raspi-config](raspi-config.md#change-keyboard-layout).
If you've installed Raspberry Pi OS using NOOBS, it should automatically pick up the same keyboard you were using in NOOBS. But if you want to select a different keyboard, or if you've installed Raspberry Pi OS from a standalone image, use [raspi-config](raspi-config.md#change-keyboard-layout).


## Timezone
Expand All @@ -35,6 +35,6 @@ If you've installed Raspbian using NOOBS, it should automatically pick up the sa

No part of NOOBS uses the time; consequently there is no option for changing the timezone.

### Raspbian
### Raspberry Pi OS

Once again, this is something you can change using the [raspi-config](raspi-config.md#change-timezone) tool.
8 changes: 4 additions & 4 deletions configuration/raspi-config.md
Expand Up @@ -2,12 +2,12 @@

This page describes the console based raspi-config application. If you are using the Raspberry Pi desktop then you can use the graphical Raspberry Pi Configuration application from the Preferences menu to configure your Raspberry Pi.

`raspi-config` is the Raspberry Pi configuration tool originally written by [Alex Bradbury](https://github.com/asb). It targets Raspbian.
`raspi-config` is the Raspberry Pi configuration tool originally written by [Alex Bradbury](https://github.com/asb). It targets Raspberry Pi OS.

<a name="usage"></a>
## Usage

You will be shown `raspi-config` on first booting into Raspbian. To open the configuration tool after this, simply run the following from the command line:
You will be shown `raspi-config` on first booting into Raspberry Pi OS. To open the configuration tool after this, simply run the following from the command line:

```
sudo raspi-config
Expand Down Expand Up @@ -59,7 +59,7 @@ Generally speaking, `raspi-config` aims to provide the functionality to make the
<a name="change-user-password"></a>
### Change User Password

The default user on Raspbian is ```pi``` with the password ```raspberry```. You can change that here. Read about other [users](../linux/usage/users.md).
The default user on Raspberry Pi OS is ```pi``` with the password ```raspberry```. You can change that here. Read about other [users](../linux/usage/users.md).

<a name="network-options"></a>
### Network Options
Expand Down Expand Up @@ -150,7 +150,7 @@ See http://elinux.org/RPi_Overclocking for more information.
<a name="expand-filesystem"></a>
#### Expand Filesystem

If you have installed Raspbian using NOOBS, the filesystem will have been expanded automatically. There may be a rare occasion where this is not the case, e.g. if you have copied a smaller SD card onto a larger one. In this case, you should use this option to expand your installation to fill the whole SD card, giving you more space to use for files. You will need to reboot the Raspberry Pi to make this available. Note that there is no confirmation: selecting the option begins the partition expansion immediately.
If you have installed Raspberry Pi OS using NOOBS, the filesystem will have been expanded automatically. There may be a rare occasion where this is not the case, e.g. if you have copied a smaller SD card onto a larger one. In this case, you should use this option to expand your installation to fill the whole SD card, giving you more space to use for files. You will need to reboot the Raspberry Pi to make this available. Note that there is no confirmation: selecting the option begins the partition expansion immediately.

<a name="overscan"></a>
#### Overscan
Expand Down
8 changes: 4 additions & 4 deletions configuration/security.md
Expand Up @@ -10,7 +10,7 @@ Even if you are hidden behind a firewall, it is sensible to take security seriou

## Change your default password

The default username and password is used for every single Raspberry Pi running Raspbian. So, if you can get access to a Raspberry Pi, and these settings have not been changed, you have `root` access to that Raspberry Pi.
The default username and password is used for every single Raspberry Pi running Raspberry Pi OS. So, if you can get access to a Raspberry Pi, and these settings have not been changed, you have `root` access to that Raspberry Pi.

So the first thing to do is change the password. This can be done via the raspi-config application, or from the command line.

Expand Down Expand Up @@ -60,7 +60,7 @@ Once you have confirmed that the new account is working, you can delete the `pi`
sudo pkill -u pi
```

Please note that with the current Raspbian distribution, there are some aspects that require the `pi` user to be present. If you are unsure whether you will be affected by this, then leave the `pi` user in place. Work is being done to reduce the dependency on the `pi` user.
Please note that with the current Raspberry Pi OS distribution, there are some aspects that require the `pi` user to be present. If you are unsure whether you will be affected by this, then leave the `pi` user in place. Work is being done to reduce the dependency on the `pi` user.

To delete the `pi` user, type the following:

Expand Down Expand Up @@ -94,7 +94,7 @@ Then save the file: it will be checked for any syntax errors. If no errors were

## Ensure you have the latest security fixes

This can be as simple as ensuring your version of Raspbian is up-to-date, as an up-to-date distribution contains all the latest security fixes. Full instructions can be found [here](../raspbian/updating.md).
This can be as simple as ensuring your version of Raspberry Pi OS is up-to-date, as an up-to-date distribution contains all the latest security fixes. Full instructions can be found [here](../raspbian/updating.md).

If you are using SSH to connect to your Raspberry Pi, it can be worthwhile to add a cron job that specifically updates the ssh-server. The following command, perhaps as a daily cron job, will ensure you have the latest SSH security fixes promptly, independent of your normal update process. More information on setting up cron can be found [here](../linux/usage/cron.md)

Expand Down Expand Up @@ -160,7 +160,7 @@ Save the file and either restart the ssh system with `sudo service ssh reload` o

## Install a firewall

There are many firewall solutions available for Linux. Most use the underlying [iptables](http://www.netfilter.org/projects/iptables/index.html) project to provide packet filtering. This project sits over the Linux netfiltering system. `iptables` is installed by default on Raspbian, but is not set up. Setting it up can be a complicated task, and one project that provides a simpler interface than `iptables` is [ufw](https://www.linux.com/learn/introduction-uncomplicated-firewall-ufw), which stands for 'Uncomplicated Fire Wall'. This is the default firewall tool in Ubuntu, and can be easily installed on your Raspberry Pi:
There are many firewall solutions available for Linux. Most use the underlying [iptables](http://www.netfilter.org/projects/iptables/index.html) project to provide packet filtering. This project sits over the Linux netfiltering system. `iptables` is installed by default on Raspberry Pi OS, but is not set up. Setting it up can be a complicated task, and one project that provides a simpler interface than `iptables` is [ufw](https://www.linux.com/learn/introduction-uncomplicated-firewall-ufw), which stands for 'Uncomplicated Fire Wall'. This is the default firewall tool in Ubuntu, and can be easily installed on your Raspberry Pi:

```bash
sudo apt install ufw
Expand Down
4 changes: 2 additions & 2 deletions configuration/tcpip/README.md
Expand Up @@ -2,7 +2,7 @@

The Raspberry Pi uses `dhcpcd` to configure TCP/IP across all of its network interfaces. The dhcpcd daemon was written by Roy Marples and is intended to be an all-in-one ZeroConf client for UNIX-like systems. This includes assigning each interface an IP address, setting netmasks, and configuring DNS resolution via the Name Service Switch (NSS) facility.

By default, Raspbian attempts to automatically configure all network interfaces by DHCP, falling back to automatic private addresses in the range 169.254.0.0/16 if DHCP fails. This is consistent with the behaviour of other Linux variants and of Microsoft Windows.
By default, Raspberry Pi OS attempts to automatically configure all network interfaces by DHCP, falling back to automatic private addresses in the range 169.254.0.0/16 if DHCP fails. This is consistent with the behaviour of other Linux variants and of Microsoft Windows.

## Static IP address

Expand All @@ -17,7 +17,7 @@ static domain_name_servers=192.168.0.254 8.8.8.8

You can find the names of the interfaces present on your system using the `ip link` command.

Previous versions of Raspbian used the file `/etc/network/interfaces` for network interface configuration: if an interface is listed in this file, any settings there will take precedence over what is in `/etc/dhcpcd.conf`.
Previous versions of Raspberry Pi OS used the file `/etc/network/interfaces` for network interface configuration: if an interface is listed in this file, any settings there will take precedence over what is in `/etc/dhcpcd.conf`.

Note that if you have several Raspberry Pis connected to the same network, you may find it easier instead to set address reservations on your DHCP server. In this way, each Pi will keep the same IP address, but they will all be managed in one place, making reconfiguring your network in the future more straightforward.

Expand Down
8 changes: 4 additions & 4 deletions configuration/wireless/access-point-bridged.md
Expand Up @@ -24,7 +24,7 @@ If you wish to create a standalone wireless network, consider instead setting up
A bridged wireless access point can be created using the inbuilt wireless features of the Raspberry Pi 4, Raspberry Pi 3B, Raspberry Pi 3A+/3B+ or Raspberry Pi Zero W/WH, or by using a suitable USB wireless dongle that supports access point mode.
It is possible that some USB dongles may need slight changes to their settings. If you are having trouble with a USB wireless dongle, please check the [forums](https://www.raspberrypi.org/forums/).

This documentation was tested on a Raspberry Pi 3B running a fresh installation of Raspbian Buster.
This documentation was tested on a Raspberry Pi 3B running a fresh installation of Raspberry Pi OS Buster.

<a name="intro"></a>
## Before you start
Expand All @@ -34,8 +34,8 @@ This documentation was tested on a Raspberry Pi 3B running a fresh installation
**Note:** If installing remotely via SSH,
* Connect to your Raspberry Pi **by name**, e.g. `ssh pi@raspberrypi.local`. The IP address of your Raspberry Pi on the network **will probably change** after installation.
* Be ready to add screen and keyboard in case you lose contact with your Raspberry Pi after installation.
* Connect your Raspberry Pi to the Ethernet network and boot the Raspbian OS.
* Ensure the Raspbian OS on your Raspberry Pi is [up-to-date](../../raspbian/updating.md) and reboot if packages were installed in the process.
* Connect your Raspberry Pi to the Ethernet network and boot the Raspberry Pi OS.
* Ensure the Raspberry Pi OS on your Raspberry Pi is [up-to-date](../../raspbian/updating.md) and reboot if packages were installed in the process.
* Have a wireless client (laptop, smartphone, ...) ready to test your new access point.

<a name="software-install"></a>
Expand Down Expand Up @@ -126,7 +126,7 @@ With this line, interface `br0` will be configured in accordance with the defaul
Countries around the world regulate the use of telecommunication radio frequency bands to ensure interference-free operation.
The Linux OS helps users [comply](https://wireless.wiki.kernel.org/en/developers/regulatory/statement) with these rules by allowing applications to be configured with a two-letter "WiFi country code", e.g. `US` for a computer used in the United States.

In the Raspbian OS, 5 GHz wireless networking is disabled until a WiFi country code has been configured by the user, usually as part of the initial installation process (see wireless configuration pages in this [section](README.md) for details.)
In the Raspberry Pi OS, 5 GHz wireless networking is disabled until a WiFi country code has been configured by the user, usually as part of the initial installation process (see wireless configuration pages in this [section](README.md) for details.)

To ensure WiFi radio is not blocked on your Raspberry Pi, execute the following command:

Expand Down

0 comments on commit 430b92f

Please sign in to comment.