systemd service for auto-start in Raspberry Pi

Introduction

We use a systemd service to make a program start automatically when the Raspberry Pi turns on. This helps run important tasks without needing to start them by hand.

You want a script to run every time your Raspberry Pi boots up.

You have a server program that should always be running in the background.

You want to start a sensor reading program automatically after power on.

You need to run a backup script every time the device restarts.

You want to launch a web server or app without manual intervention.

Syntax

Raspberry Pi

[Unit]
Description=Your Service Description
After=network.target

[Service]
ExecStart=/path/to/your/script.sh
Restart=always
User=pi

[Install]
WantedBy=multi-user.target

The [Unit] section describes the service and when it should start.

The [Service] section tells systemd what to run and how.

Examples

This example runs myscript.sh as user pi after the network is ready.

Raspberry Pi

[Unit]
Description=My Auto Start Script
After=network.target

[Service]
ExecStart=/home/pi/myscript.sh
Restart=always
User=pi

[Install]
WantedBy=multi-user.target

This runs a Python script once at boot without restarting if it stops.

Raspberry Pi

[Unit]
Description=Simple Hello Service
After=multi-user.target

[Service]
ExecStart=/usr/bin/python3 /home/pi/hello.py
Restart=no
User=pi

[Install]
WantedBy=multi-user.target

Sample Program

This is a full example of a systemd service file to auto-start a script called hello.sh located in the pi user's home folder. The comments show how to enable and start the service.

Raspberry Pi

[Unit]
Description=Auto Start Hello Script
After=network.target

[Service]
ExecStart=/home/pi/hello.sh
Restart=always
User=pi

[Install]
WantedBy=multi-user.target

# Save this as /etc/systemd/system/hello.service
# Then run:
# sudo systemctl daemon-reload
# sudo systemctl enable hello.service
# sudo systemctl start hello.service

Important Notes

Make sure your script has execute permission: chmod +x /home/pi/hello.sh.

Use sudo systemctl status yourservice.service to check if your service is running.

Reload systemd after creating or changing service files with sudo systemctl daemon-reload.

Summary

systemd services help run programs automatically at boot on Raspberry Pi.

Create a service file with sections [Unit], [Service], and [Install].

Enable and start the service using systemctl commands.

Practice

1. What is the main purpose of creating a systemd service on a Raspberry Pi?

easy

A. To update the Raspberry Pi operating system

B. To manually run a program only once

C. To make a program start automatically when the Raspberry Pi boots

D. To uninstall software from the Raspberry Pi

Solution

1. Step 1: Understand systemd service purpose

   A systemd service is designed to manage programs and make them start automatically during boot.

2. Step 2: Identify the correct use case

   Starting a program automatically on boot matches the purpose of systemd services.

3. Final Answer:

   To make a program start automatically when the Raspberry Pi boots -> Option C

4. Quick Check:

   systemd service = auto-start program [OK]

Hint: Remember: systemd services auto-start programs on boot [OK]

Common Mistakes:

• Confusing systemd with manual program execution
• Thinking systemd updates the OS
• Believing systemd uninstalls software

2. Which of the following is the correct section header in a systemd service file to define the program to run?

easy

A. [Service]

B. [Unit]

C. [Install]

D. [Program]

Solution

1. Step 1: Recall systemd service file structure

   A systemd service file has three main sections: [Unit], [Service], and [Install].

2. Step 2: Identify where the program command goes

   The program to run is specified under the [Service] section using ExecStart.

3. Final Answer:

   [Service] -> Option A

4. Quick Check:

   Program command in [Service] section [OK]

Hint: Program command is always under [Service] section [OK]

Common Mistakes:

• Using [Unit] or [Install] for program commands
• Assuming [Program] is a valid section
• Confusing section headers

3. Given this systemd service file snippet:

[Unit]
Description=My Script

[Service]
ExecStart=/home/pi/myscript.sh

[Install]
WantedBy=multi-user.target

What command should you run to make this service start automatically on boot?

medium

A. sudo systemctl start myscript.service

B. sudo systemctl enable myscript.service

C. sudo systemctl reload myscript.service

D. sudo systemctl stop myscript.service

Solution

1. Step 1: Understand difference between start and enable

   Starting runs the service now; enabling sets it to run on boot.

2. Step 2: Identify command to auto-start on boot

   Use sudo systemctl enable myscript.service to enable auto-start.

3. Final Answer:

   sudo systemctl enable myscript.service -> Option B

4. Quick Check:

   Enable = auto-start on boot [OK]

Hint: Enable service to auto-start, start to run now [OK]

Common Mistakes:

• Using start instead of enable for auto-start
• Confusing reload with enable
• Stopping service instead of enabling

4. You created a systemd service file but after reboot, the program does not start. Which of these is the most likely mistake?

medium

A. You named the service file with a .txt extension

B. You used sudo systemctl start instead of enable

C. You put the program command under the [Unit] section

D. You forgot to run sudo systemctl daemon-reload after creating the service file

Solution

1. Step 1: Understand systemd reload requirement

   After creating or changing service files, systemd must reload to recognize changes.

2. Step 2: Identify the missing reload command

   Forgetting sudo systemctl daemon-reload means systemd ignores new service files.

3. Final Answer:

   You forgot to run sudo systemctl daemon-reload after creating the service file -> Option D

4. Quick Check:

   daemon-reload needed after service file changes [OK]

Hint: Always run daemon-reload after editing service files [OK]

Common Mistakes:

• Skipping daemon-reload after file changes
• Confusing start and enable commands
• Placing ExecStart in wrong section
• Wrong file extension for service files

5. You want your Raspberry Pi to run a Python script at boot, but only after the network is ready. Which systemd service file snippet correctly ensures this?

hard

A. [Unit]\nDescription=Run Python Script\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nExecStart=/usr/bin/python3 /home/pi/script.py\n\n[Install]\nWantedBy=multi-user.target

B. [Unit]\nDescription=Run Python Script\nRequires=network.target\n\n[Service]\nExecStart=/usr/bin/python3 /home/pi/script.py\n\n[Install]\nWantedBy=multi-user.target

C. [Unit]\nDescription=Run Python Script\nBefore=network-online.target\n\n[Service]\nExecStart=/usr/bin/python3 /home/pi/script.py\n\n[Install]\nWantedBy=multi-user.target

D. [Unit]\nDescription=Run Python Script\nAfter=multi-user.target\n\n[Service]\nExecStart=/usr/bin/python3 /home/pi/script.py\n\n[Install]\nWantedBy=network-online.target

Solution

1. Step 1: Understand network dependency in systemd

   To run after network is ready, use After=network-online.target and Wants=network-online.target.

2. Step 2: Check each option's unit section

   [Unit]\nDescription=Run Python Script\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nExecStart=/usr/bin/python3 /home/pi/script.py\n\n[Install]\nWantedBy=multi-user.target correctly uses both directives to wait for network online before starting.

3. Final Answer:

   After=network-online.target and Wants=network-online.target -> Option A

4. Quick Check:

   Use After and Wants with network-online.target for network wait [OK]

Hint: Use After=network-online.target and Wants=network-online.target [OK]

Common Mistakes:

• Using network.target instead of network-online.target
• Placing Before=network-online.target instead of After
• Wrong WantedBy target
• Missing Wants directive