334

I have been writing programs for my Raspberry Pi (running Raspbian) for a few weeks now and would like to make sure I protect the work I have done.

How can I backup the files I have created?

Can I simply plug the SD card into my Windows (XP or 7) PC and copy it either to the hard drive or another SD card?

10
  • 6
    I have PC's running both Ubuntu and Windows (XP & 7), but I would expect most people to be interested in the Windows answer. I will edit the question to make that clear. Commented Jun 14, 2012 at 18:38
  • 7
    rsync from Raspi to your pc?
    – Alex L
    Commented Jun 14, 2012 at 18:54
  • 44
    For code, you may also want to consider using distributed version control software like git or hg, that way you not only have copies of your code in multiple places, but also have the complete history of how that code has changed.
    – Mark Booth
    Commented Jun 15, 2012 at 11:01
  • 4
    @MarkBooth I don't see why a DVCS is needed over a VCS if we are just considering being able to retrieve code later. Heck, it's even easier since you use revision numbers not commit hashes to identify a particular state. Learning a CVCS like Subversion isn't much of a time investment (as I recall... though it was a very, very long time ago). Yes, switching to Git was a bit unnerving at the time, but I have never ever looked back.
    – Steven Lu
    Commented Apr 13, 2014 at 21:17
  • 1
    Comments are not a good place for this kind of discussion @StevenLu, we should take this to Raspberry Pi Chat.
    – Mark Booth
    Commented Apr 13, 2014 at 22:38

17 Answers 17

317

If you want to preserve all of the data, you will probably have to create a disk image. Furthermore, Windows cannot recognize typical Linux filesystems, so you probably won't even be able to see your files, when you plug in your SD card.

Creating a disk image will preserve not only files but also the filesystem structure and when you decide to flash your new SD card, you will be able to just plug it in and it will work.

Linux

On Linux, you can use the standard `dd` tool:
dd if=/dev/sdx of=/path/to/image bs=1M

Where /dev/sdx is your SD card.

Note: An of image created from a mounted partition on if may be corrupted. This risk is due to the fact that changes made to if may be incomplete when copied by dd. To avoid risk, the if should be un-mounted during dd.

Mac

On Mac, you can also use the standard `dd` tool with a slightly different syntax:
dd if=/dev/rdiskx of=/path/to/image bs=1m

Where /dev/rdiskx is your SD card.

(using rdisk is preferable as its the raw device - quicker)

To find out which disk your device is type diskutil list at a command prompt - also, you may need to be root; to do this type sudo -s and enter your password when prompted.

Windows

Option 1

On Windows, you can use the reverse process that you used when flashing the SD card.

You can use Win32 Disk Imager, which is the preferred tool for flashing a SD card of the Foundation. Just enter the filename (the location and name of the backup image file to be saved), select the device (the SD card) and press read:

Win32 Disk Imager

Of course, you can also use RawWrite, dd for Windows or similar tools, the process is quite similar.

Option 2

If you don't want to back up your entire system, but only specific files, I suggest you connect to your Raspberry Pi via SFTP and copy the files to your local computer (You can use the WinScp client). If you have SSH enabled, SFTP usually requires no special configuration on the Raspberry Pi side.

Another option is to copy the files to a remote system using rsync.

You can also install special drivers so your Windows can read ext filesystems (and will thus be able to read the whole SD card), such as ext2fsd but it is probably not worth the effort.


Since the image will be of the same size as your SD card, you may want to compress it. This can be achieved simply by using your favorite compression tool, such as gzip, 7zip, WinZip, WinRar ...

21
  • 1
    +1 in general, although rsync via ssh would probably be easier. Also, for source code - as Mark Booth already stated - you should absolutely use a DVCS Commented Dec 13, 2012 at 16:54
  • 1
    If my SD card became corrupted, how would I install this image to a new SD card?
    – Flipper
    Commented Feb 3, 2013 at 8:57
  • 2
    Your link to Win32 Disk Imager comes up with no downloads available. I assume it's the same as sourceforge.net/projects/win32diskimager ? Commented Feb 14, 2013 at 1:03
  • 2
    oh my, I can't distinguish if "read" in that picture means "read the image file" or "read the PARTITION AND WRITE IT INTO the image file".... same for "write"... That gui needs to be sanitized. Something like "Image -> Device" and "Device -> Image" (or a better alternative) Commented Dec 5, 2013 at 18:43
  • 4
    Win32DiskImager seems to only be able to deal with partitions Windows recognizes. I've had little to no luck with it cloning Noobs/Raspbian SD cards. Found this freeware program: hddguru.com/software/HDD-Raw-Copy-Tool. It works like a charm to do a byte-by-byte clone of the SD card in Windows (I used it with Win7 64-bit), regardless of partitioning scheme and contents.
    – techie007
    Commented Feb 3, 2015 at 16:37
169

If you are running Linux then you can use the dd command to make a full backup of the image:

dd if=/dev/sdx of=/path/to/image

or for compression:

dd if=/dev/sdx | gzip > /path/to/image.gz

Where sdx is your SD card.

To restore the backup, you reverse the commands:

dd if=/path/to/image of=/dev/sdx

or when compressed:

gzip -dc /path/to/image.gz | dd of=/dev/sdx
13
  • 3
    I highly recommend using gzip - I have backed up some desktop partitions today and a 20Gb partition was saved in 8.9Gb. Commented Jul 4, 2012 at 15:48
  • 2
    bzip2 should compress even better, and is available on all Linux systems. On newer Linux systems xz should compress even better.The decompressors for these are bunzip2 and unxz respectively.
    – Arne
    Commented May 29, 2013 at 12:10
  • 4
    @Arne I wouldn't expect such a difference! Still, that seems to be far below my concerns. (Btw, it's cool when you reply to a comment almost 1 year old, and you get a response in 2 minutes :) )
    – yo'
    Commented Mar 24, 2014 at 10:00
  • 7
    Do not make the mistake (like I just did) of leaving the bs=1M or some similar parameter out. The default block size of 512 bytes will kill the copy performance.
    – Steven Lu
    Commented Apr 13, 2014 at 3:57
  • 1
    @Arne I tried using bzip2 now, and maybe it would be appropriate if I was backing up from my Class 4 SD card, but on this Class 10 UHS 1 SanDisk 8GB card (which was $12 last week) it is maxing out an Ivy Bridge CPU thread and limiting read speed from the card to 6MB/s (dd with Ctrl+T reports 4.2MB/s). This is not ideal because I can use gzip with this card and read off of it at a much quicker pace (dd reporting 18MB/s). Granted, if most of the disk is free space, then reading during those empty stretches will speed up. But I'll have to see what the difference is in the resulting file size.
    – Steven Lu
    Commented Apr 20, 2014 at 3:40
36

On the Mac you don't want to be using /dev/diskn. You should use /dev/rdiskn instead, where n is the number the OS uses to identify your SD card. This decreases the time required to copy by a huge amount.

So for the optimal backup process on a Mac, I would recommend doing the following:

Run diskutil list, and find the disk corresponding to your Raspberry Pi's SD card:

$ diskutil list
/dev/disk0
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:      GUID_partition_scheme                        *500.1 GB   disk0
   1:                        EFI                         209.7 MB   disk0s1
   2:                  Apple_HFS Macintosh HD            499.2 GB   disk0s2
   3:                 Apple_Boot Recovery HD             650.0 MB   disk0s3
/dev/disk1
   #:                       TYPE NAME                    SIZE       IDENTIFIER
   0:     FDisk_partition_scheme                        *7.9 GB     disk1
   1:             Windows_FAT_32                         58.7 MB    disk1s1
   2:                      Linux                         7.9 GB     disk1s2

Clearly /dev/disk1 is my 8GB SD card, the Linux partition name is also a bit of a clue.

However, instead of using /dev/disk1 with dd, you should use /dev/rdisk1, like so:

sudo dd if=/dev/rdisk1 of=/path/to/backup.img bs=1m

And to restore it, just swap the if (input file), and of (output file) parameters:

sudo dd if=/path/to/backup.img of=/dev/rdisk1 bs=1m

Or, with gzip, to save a substantial amount of space:

sudo dd if=/dev/rdisk1 bs=1m | gzip > /path/to/backup.gz

And, to copy the image back onto the SD:

gzip -dc /path/to/backup.gz | sudo dd of=/dev/rdisk1 bs=1m

For more information, see this wiki page.

3
  • 1
    I find this to be the most efficient answer and voted for it, thanks @Alex Coplan.
    – bosch
    Commented Sep 25, 2016 at 10:11
  • However, I was looking for a fool-proof GUI tool for MacOS (as Windows users have) and without the dd risks and I found "SD Clone" from Two Canoes (which I trust as I am a user of WinClone). It's pretty new -2016- and expensive (100$ with a 2 week trial) but seems to be geared towards RasPi so I'll give it a try right now and let you know in a new comment.
    – bosch
    Commented Sep 25, 2016 at 10:25
  • 3
    When coping back, unmount your SD Card if you get the following message: "Resource busy" Commented Apr 4, 2017 at 5:55
34

Besides those block-level backups, there are two common approaches to deal with the sources: to archive it continuously (1), or to use the revision control system (2).

We are going to use the command-line (any local terminal or SSH connection to a Raspberry Pi machine), right?

1. Archive

cd ~/projects
tar czvf your-raspberry-project-top-level-dir-v1.0.tgz \
         ./your-raspberry-project-top-level-dir 
scp your-raspberry-project-top-level-dir-v1.0.tgz \
         user@backup-host:/home/user/backups/

2. RCS (Git for instance)

cd ~/projects/your-raspberry-project-top-level-dir
make clean                          # Or clean it manually using rm (rm ./*.o ./*.pyc)
git init                            # Create new repo here
git add .                           # Add source files to the staging index
git status                          # Verify if it's OK
git commit -a -m "Initial import"   # Fix application's source changes
git add remote https://github.com/user/your-raspberry-project.git
git push -u origin master           # Sends the sources to your github repo
git pull && git push && git status  # Now origin/master is your tracking branch
2
  • 3
    It might also be worth noting that people can set up bare repos on other machines on their network and push from their Raspberry Pi to there, rather than having to set up a github account, ssh keys etc and push to there.
    – Mark Booth
    Commented Apr 13, 2014 at 12:06
  • 2
    That's a good start for the real answer. Code needs to be managed under version control if one wants to be able to maintain it. Version control allows to track changes, understand history of changes, manage different branches (e.g. stable vs dev) and merge between them. But it is not backup per se. However, one simply need to backup the repository (e.g. the .git folder for Git). Check Linux/Unix forums, wikis, stackexchanges, etc. for ways to backup folders under Linux. Note: I don't consider github as backup. And you don't want to publish everything to github!
    – Huygens
    Commented Feb 28, 2015 at 20:27
30

You can run this command from your Linux PC with lots of space:

ssh root@raspberrypi gzip -c /dev/mmcblk0 > img.gz

As a prerequisite you'll need to have generated .ssh keys and copied the id_XXX.pub over to /root/.ssh/authorized_keys.

It's possible to have issues with the file system since it's a live backup, but if your Raspberry Pi isn't real busy it will usually be OK.

It's probably faster to do the compression on the PC like this:

ssh root@raspberrypi dd if=/dev/mmcblk0 | gzip -c > img.gz
5
  • 1
    or with sudo 'ssh pi@raspberry sudo dd if=/dev/mmcblk0 | gzip -c > raspberry.img.gz'
    – cupakob
    Commented Nov 25, 2012 at 14:35
  • and as a reference for passwordless login, raspberrypi.stackexchange.com/a/1687/22603
    – Paolo
    Commented Jan 3, 2015 at 10:47
  • 6
    I also found useful to add block size and, as it was available, use pv to check progress. ssh root@raspberry dd if=/dev/mmcblk0 bs=1M | pv | gzip -c > img.gz
    – Paolo
    Commented Jan 3, 2015 at 14:08
  • 1
    This is a great answer if you don't want to unmount your SD card, and also works for macOS. Here's the command-line I'm using: ssh pi@raspberrypi sudo dd if=/dev/mmcblk0 | xz -9 -e --threads=4 > sd.img.xz. Doesn't require generating SSH keys doing it this way. Ctrl-T can be pressed to see the progress. Commented Dec 9, 2016 at 19:36
  • Why is gzip preferable over dd command? Commented Jan 25, 2017 at 14:19
21

If you are using Windows:

  1. Download Win32 Disk Imager.

  2. Create the file path you wish to use to save your image. (I use C:\RasPi_Bkp)

  3. Run Win32 Disk Imager

  4. Browse to your backup file path spot, and type a file name.

  5. Click save

  6. Make sure the device shown in the drop down to the right of your file path is the one you want to back up.

Win32 Disk imager in Action

  1. Click "Read"

  2. Wait.

2
  • 1
    Thanks - just the job. (Oddly, when I plug my SD card into my main PC, Windows 7 goes to BSOD! Fortunately its fine on another machine.) Commented Jul 5, 2012 at 10:01
  • For anyone that has trouble with Win32 Disk Imager as I have, try Rufus. Commented Dec 26, 2016 at 0:26
11

If your programs are all in the pi userid, there's really no reason to back up the entire filesystem, as is being suggested. what I do is to just back up the single id. I run the command:

tar -czf pi.tgz *

from pi's home directory, which creates the file pi.tgz, containing all the files and directories contained there (excluding hidden files). I then scp this file to another linux computer, but you could ftp it or e-mail it somewhere for safe-keeping... anything that got it onto another computer.

This creates a much smaller file for your back-up.

Concerned about all the additional packages you've installed along the way? Create a script that will perform those installs for you again should you need to recreate your SD card, and keep it in pi's home directory somewhere. (I have a ~/bin directory for such things). Have all the commands you need to do the installs to bring you back to the position you want to be in. It documents your changes, and allows you to quickly build up a new SD card. It would contain commands in the form of:

apt-get --assume-yes install apache2 mysqld mysql php5 php-pear

Start it out with

apt-get update
apt-get --assume-yes upgrade

so that your system also is brought up to the current level before you start adding your packages.

Since this will be in your pi.tgz file, you'll have it when you need it.

2
  • Note that for the Raspbmc spin-off, the apt-get upgrade is apparently known to cause issues. It did for me, and apparently it's a known issue . Commented May 6, 2013 at 16:11
  • This can be done remotely too, i.e.: ssh [email protected] "sudo tar -cvp ~/*" | xz -9 -e --threads=4 > raspbian.home.tar.xz Commented Dec 9, 2016 at 20:06
10

I run Raspbian and use dd and cron to do automated backups of my SD card to my external USB drive.

It is a really simple solution. It runs once a week at 2 am on a Monday morning and makes an image of the SD card.

I wrote a script which shuts down services such as lighttpd and cron, to minimise the risk of the SD card being written to in the middle of the backup, it then calls dd, before starting to the services again when the backup has finished.

I've put the script and some instructions on my blog, http://www.stuffaboutcode.com/2012/08/raspberry-pi-auto-backups.html

3
6

For Debian you could use dd and tar. This would make a complete copy of your SD card and would require external (to SD card) storage, probably mounted USB or network drive.

dd if=/dev/sdd of=yourbackupfilenamehere.dd
tar zcvf yourbackupfilenamehere.dd.tar.gz

With /dev/sdd being the location of your SD card, and of being the output file name.

4
  • This has the limitation of needing somewhere to write the image to though (that is also large enough to take the image(s). Presumably it also means a large data io through the usb hub - would take a while? Commented Jul 5, 2012 at 10:38
  • True, but it's kind of required in the question: "I want a full image of the SD card." Commented Jul 5, 2012 at 10:39
  • 1
    Why do you make a .tar.gz file of the dd-file? Wouldn't it be better to just run gzip or bzip2 on the dd-file directly?
    – Anders
    Commented Jul 25, 2012 at 21:11
  • What does /dev/sdd mean? I have /dev/mmcblk0p1 and /dev/mmcblk0p2 listed... Commented Jan 25, 2017 at 14:20
5

Fortunately the Raspberry Pi can create a backup of itself which is independent of the primary OS used to access the Raspberry (Windows, Linux, Mac). dd, tar and rsync are different tools to create backups on Linux. All these types of backups can be created by the running Pi provided it's stopping all busy tasks as mysql, smb, dlna, owncloud, seafile, apache et al before creating the backup. There is a different question where the approach is explained in more detail and a possible solution is explained here

4

If your Raspberry Pi is connected to a network and you want automatic on-the-fly backups, probably the easiest way is Bittorent Sync - very easy install and running smoothly and stable on the Pi and many other platforms.

1
  • I'd just like to ad that Sync and backup are two different things
    – Pitto
    Commented Jul 7, 2016 at 15:43
2

No more scary dd, sync, tar, ..., beginner friendly SD Card Copier

The new version of Raspbian called stretch has a very beginner friendly app called SD Card Copier. You don't need to use the Linux tools such as dd etc. It can even copy big cards to small cards.

How to do it

You start with the GUI RPi app menu icon at the very top left corner, go to Accessories, then click SD Card Copier.

All you need to do is a couple of clicks inside the GUI!

After you make the backup SD card, you can use Windows Disk Manager to read the card's image to a Windows file and store it in any Windows directory. This way you need only a physical SD card and store many versions of images in the Windows PC.

Of course you can just use the backup card as the working copy, to replace your original card, which now becomes your master card, and lock it in a safe place.

1

While searching to create an image of my customized SD card I found this post. The best answer here discusses imaging the SD card, but what I was looking for required shrinking down the filesystem to make the image as small as possible. I ended up creating my own tool to do this and outline the process at: https://raspberrypi.stackexchange.com/a/37899/32585

1

Here are 3 options:

  1. In the latest version of Raspbian, there is a tool that converts your OS and files into a .img file that you can then place onto a USB, or your PC.

  2. Plug your SD card into a Windows PC, and start up Win32 Disk Imager (install here if you haven't already.)

    In (1) type a filename & location for athe image file. In (2), select the drive letter of your SD card. Then press 3. This does the same as option 1.

  3. Plug in a USB stick to your Pi, and copy any important files across.

0

This android app will read an SD card into an .img file, and zip it at the same time: https://play.google.com/store/apps/details?id=com.redrobe.raspicardimager

0

I created a utility to backup your raspberry pi if you are Linux. This will also shrink the image of your raspberry pi, so you can put the .iso on a smaller SD card: RaspberryPiShrink

This will run a python script that will walk you through the process. Just plug in your microSD card into your Ubuntu, Linux Mint or Debain computer, and follow the in terminal instructions.

-2

I've been using usbit for Windows. It's the only tool I can find that will allow you to swap from a larger SD card to a smaller one. All I did was tick the following on the options page; Ignore size checks and Truncate oversize images.

This allowed me to swap my OpenELEC and Xbian images from a 16 GB class 4 SD card to an 8 GB class 10 card.

It's MUCH easier than resizing partition tables, etc.

2
  • 2
    Have you ever verified the files? I mean with find -type f -exec md5sum {} \; > filelist.txt?
    – Avio
    Commented Oct 5, 2012 at 22:16
  • 2
    This is not guaranteed to work, as data stored on the second half of the disk is dropped. Furthermore, the partition table is corrupted. Commented Oct 6, 2012 at 9:22

Not the answer you're looking for? Browse other questions tagged or ask your own question.