Getting Started with Raspberry Pi¶
Start here if you have a Raspberry Pi board but are not yet sure what to connect or install. Follow the path to a working login, then learn Linux and compile a program before connecting your first circuit.
Before you start¶
These lessons primarily cover Raspberry Pi 4 and 5 computers running Raspberry Pi OS. Raspberry Pi Pico boards are microcontrollers and do not follow this Linux installation path.
You do not need an electronics kit to begin. An existing working installation does not need to be erased to follow the later lessons.
Choose your starting point¶
| Your situation | Start here | Result to check |
|---|---|---|
| You are choosing equipment | Introduction | You know which board, OS and accessories you need |
| You have an unpowered board | Hardware Setup | Correct power, boot storage and access connections |
| You are ready to install | Initial Setup | Working login, network and access after reboot |
| Your Pi already works | Terminal Practice | Safe navigation, editing and file checks |
The core setup path¶
- Understand the computer. The introduction separates board, storage, OS and access method. Decide between a local desktop and SSH.
- Prepare hardware. Hardware Setup identifies connectors and power requirements. Keep GPIO circuits disconnected during the first boot.
- Install and verify. Initial Setup covers Imager, your own account, network access and post-boot checks. Writing an image erases the selected storage device.
- Operate Linux. Basic Operations teaches files, settings, network diagnosis, permissions and storage.
- Build before wiring. C++ Hardware Programming starts with a text-only program, then introduces an LED and button before PWM projects.
An SSH session executes commands on the Pi; the client terminal before that session executes commands on the client. Each lesson explains where to run its commands and which operations change configuration.
Check before moving on¶
Setup is complete when you can identify the installed board/OS, log in, use the intended network and regain access after restarting. A power light or working desktop alone does not check all of those.
You do not need a static IP, router port forwarding, overclocking, OverlayFS or a performance-tuning script to begin. Those are separate projects with separate risks.
If something fails¶
Return to the last result you could verify. A missing display, failed password and disconnected network are different problems; repeatedly rewriting the card can destroy useful data without fixing the cause.
- No working first login: First-Boot Troubleshooting.
- You can log in but networking fails: NetworkManager Checks.
- You need a particular interface or setting: raspi-config.
When asking for help, record the board model, OS version, exact action and complete error. Do not share passwords, private keys or Wi-Fi credentials.
Next step¶
Read the Introduction, or use the table above to resume at your current stage. Real-hardware checks are identified in the individual lessons; this overview is not a claim that every board, installation and circuit has been tested.