Sync files between multiple pi-top[4]s

In anticipation of a couple Robotics Kits being delivered this next week. I got to thinking that I would love to have a set up that code written and saved could be put on both pi-top[4]s to keep the code the same whether it is new code written or update to code (and save time transferring the code manually or writing it twice).

I’ve included a diagram of what I’ve come up with, in case anyone else finds it useful.

I’ve installed an open source software called Syncthing ( on all devices (both pi-top[4]s, an optional RPi and the desktop/laptop that code will be written/saved on). With devices connected to one another – laptop to the RPi (for backups) and the the RPi connected to both pi-top[4]s – code is written/updated and then saved to a shared folder and all devices automatically sync. Sync doesn’t matter where the code originates (on one of the pi-top[4]s, on the RPi or the laptop, all devices stay in sync).

You can eliminate the middle RPi and just sync between the laptop and pi-top[4]s (and you’re not just limited to two pi-top[4]s… so great for a classroom setting). However, I like having the RPi in the middle that backs up the code because if I introduce another pi-top[4], all I have to do is sync it with that connection which takes less time, etc.

Check out the PiMyLifeUp website for a great article on how to install Syncthing:


Hi @Tom-B, sounds interesting - would love to chat about your requirements for this at some point, if you send me a DM we can set something up :+1:

1 Like

Hey, I have a solution but it is somewhat intense for new users… rclone and a cloud drive would be perfect for this. I personally use rclone and a custom made service for the system daemon to automatically start the drive service at start up. If you would like to know more, let me know and I can point you in the right direction and also send over the code for what I have done to set it up.

Hey everyone…. I just wanted to run through the installation of Syncthing in case you’d like to install this yourself on your pi-top(s).

Please note (disclaimer): I recommend backing up your pi-top boot card/drive in case these instructions don’t go well and cause issues. I am adding this guide for how I’ve accomplished this and this guide is for informational purposes only and no mishaps due to errors or inadvertent typos, etc. using this guide will be the responsibility of me or the owner of this forum. Thank you.


Syncthing is light-weight and doesn’t use a lot of resources but is powerful enough to secure this connection between devices with a strong encryption certificate that must match between devices before any files will be transmitted. Syncthing does this sync file transmission in real-time which is what makes to really powerful. For example, I work on Python code on a Mac and any time a Python file is updated, it immediately is transmitted to all pi-top devices that are powered on and connected to the local network.

This forum post covers the installation on the Raspberry Pi architecture… but there is a Windows and Mac installation that you will find with an easy installer from their website if you’d like to sync files between a Mac and PC to and from a your pi-top devices.

This is especially handy if you have multiple pi-top[4] devices, for example, and you want the same code on all of them. In my case, I have 3 and I want to keep the same Python code on all 3 without having to VNC to each one and to add the code multiple times or put it on USB flash to copy it multiple times.

When you see Syncthing in action, you’ll find other uses for it as well. For example, using it to back up important files as a sort of local repository of files for work, hobbies or to save those important family photos, etc.

Ready? Let’s get started:

Whenever installing something new, make sure your pi-top is up-to-date. You can run the updater from the pi-topOS menu or even do this in Terminal (which is where the rest of the work in general will be done).:

sudo apt-get update
sudo apt-get upgrade

Now we make sure that apt-transport-https is installed. By default, this may is typically not installed and it doesn’t hurt to make sure it’s installed:

sudo apt install apt-transport-https

Next step is to add the Syncthing PGP keys to the package manager’s key chain to make sure the packages installed are properly signed and aren’t coming from an unexpected resource:

curl -s | sudo apt-key add -

This step will handle added the repository:

echo "deb syncthing stable" | sudo tee /etc/apt/sources.list.d/syncthing.list

After this, Syncthing is installed from the repository but we need to update the package list:

sudo apt update

At this point, we can get Syncthing installed:

sudo apt install syncthing

Now we need to give access to the Syncthing interface to other systems on the network, otherwise, it is only accessible on this device and, well, that’s just not very useful.

If you don’t know the IP address of your device (I typically set up a static IP address for my pi-top[4] so it always uses the same IP and this is important because the Syncthing will connect via the IP address and having it the same every time makes configuration easier) type the following command to get the pi-top’s IP address:

hostname -I

Now we start Syncthing from the command line, but it won’t fully run, so we let it run through the initial start just to generate configuration files needed:


(Usually after about 15 seconds or so, you just need to kill it by holding down “Control” and press “C”)

Now we have config files to edit.

First we’ll edit a config.xml file located in ~/.config/syncthing:

nano ~/.config/syncthing/config.xml

In this file, you’ll need to find an entry for <address></address>. By holding “Control” and then pressing “W”, you can do a search. Search for the line as described, because there are other lines in the XML with <address></address>, but you want the one with the address. Now modify it (in this guide, I am using nano) to change to your pi-top’s IP address. Example, changing it like this <address></address> to <address></address> (example if your pi-top’s IP address is Then hold down “Control” and press “X” and then “Y” and then “Enter/Return” to save that change.

Next we will set up Syncthing as a service on the pi-top. Using nano again, we will create a new file named syncthing.service:

sudo nano /lib/systemd/system/syncthing.service

In this new file add the following lines:

Description=Syncthing - Open Source Continuous File Synchronization

ExecStart=/usr/bin/syncthing -no-browser -no-restart -logflags=0
SuccessExitStatus=3 4
RestartForceExitStatus=3 4



Then hold down “Control” and press “X” and then “Y” and then “Enter/Return” to save that change.
(This tell the system how to handle Syncthing on the Raspberry Pi.)

Now, with the service created, we can enable it to start at boot:

sudo systemctl enable syncthing

Next we can start the service:

sudo systemctl start syncthing

Then we can check status of the service running. We are looking for it to show that it is Active: active (running):

sudo systemctl status syncthing

As long as it shows that it is active, we are in the home stretch! :smiley:

Note: Hold down “Control” and press “C” to exit the status dialogue.

Accessing the Syncthing Web Interface and Final Configuration

Syncthing will now have a few settings we will need to take care of for final configuration. These are accessed via a browser from a remote computer.



(Step 1) On another device on your network (recommended is a laptop or desktop) visit the following URL (replacing [PITOP-IPADDRESS] with your pi-top’s actual IP address you got earlier when you used the hostname -I command.


(Step 2) Now, in your browser, you will see the Syncthing interface with a “Danger!” Warning and we’ll take care of that first. Click “Settings”. (If you don’t see the Danger! warning here, see the alternate way to get to “Settings” below.)

Note: Alternatively, you can click (1) “Actions” and then (2) “Settings”.


(Step 3) Next click the GUI tab.


(Step 4) Enter a user name you want to use for the (1) “GUI Authentication User” and the (2) “GUI Authentication Password”. (Note: These details will be used any time you access Syncthing from another device. Syncthing will show you a sign-in pop-up dialing and this is the user name and password you will use for that access.)

Then click “Save” (3)

Warning: You will likely get kicked out of the web interface at this point and it may ask you to log in now. This is normal, just enter the user name and password you’ve set just now, to confirm the Authentication User.

Syncthing Setup to Connect Devices

At this point, Syncthing is installed on the pi-top but we need to connect it to another device(s) to start syncing files!

It’s also at this point, you would probably consider an installation of Syncthing on the desktop or laptop to sync your pi-top with – because the point of Syncthing is the sync of files between at least two devices.

The following steps to configure Syncthing on the pi-top will also be the same on another device after installing it in Windows or the Mac OS, so you can follow these for any device that has Syncthing installed. (Visit Syncthing’s website at, to download a Windows or Mac installer.)


(Step 1) Click (1) “Actions” and then (2) “Show ID”.

Note: Each device will get a unique ID – the screen looks like this (my specific details hidden) with a unique ID and a QR code that can be scanned.


(Step 2) On one device, you will click “+ Add Remote Device”.


(Step 3) You will need the other device’s (1) unique ID and a (2) name for the device. (Note: The remote device will need confirmation of the connection after you click “Save”.)

You see that the device is connect but “Unused”. This is because no folders have been shared yet. That’s next.


(Step 4) Click “Edit” to configure the "Sharing from the pi-top.


(Step 5) Then click “Sharing” to find what devices this folder would be connected with.


(Step 6) Click the box next to the device to share with to select that device and then click “Save”.
(Note: a folder named “Sync” is automatically created and it is configured as “Default Folder”)


(Above screen) Once a folder is shared and confirmed on the other device, any new files added to that specific folder on any device that it is shared with, will immediately sync (shown by “Up to Date” messages on both devices that all folder files are transmitted).

Note: Syncthing shows a “syncing” meter to indicate that files are being transmitted (both on the sending device and the receiving device).

Closing comments: The multiple edits of this post was to get the formatting of everything as easy as possible to follow. If you find anything that can improve the formatting to make it even more clear, please let me know.

Thank you for supplying this - looks as though you invested a lot of time in creating this.

I’ve been looking for an automatic way of transferring files between my Pi’s. Lately, it has been done manually; either between the Pi’s and my 48TB NAS or to my Samba server. I definitely will look into the instructions you have provided.:+1::+1::+1:

1 Like

Please let me know how you get along with it after you go through the guide to get Syncthing installed. I think you’ll find this set up will serve you well in the workflow you describe with copying files in a couple manual steps. Instead, this will just sync those files for you. – Specifying which folders to sync between RPis is pretty straight-forward.

Thanks @Tom-B, this is great! :+1:

1 Like

I finally got around to setting this up. [I have a lot of time on my hands now, after falling down the stairs to my basement. Waiting for my legs to get stronger before venturing down again. Had my son retrieve a Pi-Top[4] and PC Laptop from the basement] Using the Pi-Top[4] as 1 device and the other is a PC desktop being accessed from the laptop using Remote Desktop, as the second device. I followed your instructions, Your instructions were very good. Thanks for posting.


First, sorry to hear about your fall. Continued mending and regaining strength.

You’re very welcome for the instructions for setting up Syncthing. I’m glad they were helpful instructions and Syncthing is as helpful to you as it is for me.

Keep feeling better and let me know how things work for you as you continue using Syncthing.

1 Like