Link Search Menu Expand Document

Run script on start-up with your Raspberry Pi

For some specific use cases it may be very handy to have a script automatically run when the Raspberry Pi boots up. Below I help you set this up.

Table of contents

  1. Using rc.local
  2. Editing rc.local
  3. Make boot not wait
  4. Wait for network
  5. Write to logfile
  6. Using .bashrc

Using rc.local

There are a number of ways to have a command, script or program run when the Raspberry pi boots. This is especially useful if you want to power up your Pi in headless mode (that is without a connected monitor), and have it run a program without configuration or a manual start. I suggest to use the method that uses the rc.local file.

Editing rc.local

On your Raspberry Pi, edit the file /etc/rc.local as root:

sudo nano /etc/rc.local

Add your commands below the comment, but leave the line exit 0 at the end, then save the file and exit. For example, to run your script add the line:

python3 /home/pi/

or to run a custom bash schedule script, add the line:


Be sure to reference absolute filenames rather than relative to your home folder, such as /home/pi/ rather than

Make sure that the file rc.local is executable otherwise it will not run:

sudo chmod +x /etc/rc.local

Now reboot your Raspberry Pi to test it:

sudo reboot

Make boot not wait

If you add a script or command to your /etc/rc.local file, it will be added to the boot sequence. If your code gets stuck then the boot sequence cannot proceed. So be careful as to which code you are trying to run at boot and test the code a couple of times.

Alternatively, and if your script is not instant but runs continuously, you should fork the process by adding an ampersand to the end of the command:

python3 /home/pi/ &

The ampersand allows the command to run in a separate process and continue booting with the process running.

Wait for network

It can be that rc.local is run before the Raspberry Pi has connected to the network. The simplest way to fix this is to add a simple command to have the Raspberry Pi wait for a couple seconds:

sleep 5

Write to logfile

If you want to simultaneously write a logfile, run the command as follows:

bash -c '/usr/bin/python3 /home/pi/ > /home/pi/mylog.log 2>&1' &

Using .bashrc

Rather than running a script upon boot we can run a script each time a terminal window is opened, such as upon boot but also with a new SSH connection. To do so we will use .bashr:

sudo nano /home/pi/.bashrc

Go to the last line of the file and add your commands, e.g. to print a statement and run a python script:

echo Running sample script
sudo python /home/pi/

The program can be aborted with ctrl-c while it is running!


Add a Comment

If you use find any of the information provided on this website useful it would be great to hear from you and please consider citing the paper! All rights reserved © 2021 Jolle Jolles. Website built using Jekyll and the Just the Docs theme.