home-assistant.github.io/source/_docs/ecosystem/backup/backup_usb.markdown
Erik-jan Riemers af46e2cf72 A backup solution towards an USB drive (#2528)
You can add this one under the backup category too.
2017-04-29 12:06:38 +02:00

3.9 KiB

layout title description date sidebar comments sharing footer
page Configuration Backup to USB drive Instructions how backup your Home Assistant configuration to USB stick 2017-04-29 11:00 true false true true

Backing upyour Home Assistant configuration to USB. A good plus side is that you don't need to mask all your passwords since the backup is locally at your home/residence.

{% linkable_title Requirements %}

First you need a USB stick. Once you have one you need to prepare it to be used on your device. Once connected you want to format/work with the drive. To know what path it is in, you can check with dmesg.

root@hassbian:/media# dmesg|grep sd
[    0.909712] sdhci: Secure Digital Host Controller Interface driver
[    0.916414] sdhci: Copyright(c) Pierre Ossman
[    0.923366] sdhost: log_buf @ bac07000 (fac07000)
[    0.989001] mmc0: sdhost-bcm2835 loaded - DMA enabled (>1)
[    1.049095] sdhci-pltfm: SDHCI platform and OF driver helper
[726257.743301] sd 0:0:0:0: Attached scsi generic sg0 type 0
[726259.184810] sd 0:0:0:0: [sda] 124846080 512-byte logical blocks: (63.9 GB/59.5 GiB)
[726259.185603] sd 0:0:0:0: [sda] Write Protect is off
[726259.185613] sd 0:0:0:0: [sda] Mode Sense: 23 00 00 00
[726259.186432] sd 0:0:0:0: [sda] No Caching mode page found
[726259.186445] sd 0:0:0:0: [sda] Assuming drive cache: write through
[726259.206085]  sda: sda1
[726259.209004] sd 0:0:0:0: [sda] Attached SCSI removable disk

Here we see we have a drive on /dev/sda1. We assume you created a partition on the drive to start with. This can be any type of partition. Preffered is a linux one so you can set permissions! Mount the drive (as root) to /media

root@hassbian:~# mount /dev/sda1 /media/

{% linkable_title Prepare USB Stick %}

Cd into it and create a folder called 'hassbackup' and chown it to the user that runs homeassistant. In my case group and user are both homeassistant.

root@hassbian:~# cd /media/
root@hassbian:/media# mkdir hassbackup
root@hassbian:/media# chown homeassistant:homeassistant hassbackup/
root@hassbian:/media# ls -al
total 28
drwxr-xr-x  4 root          root           4096 Apr 29 10:36 .
drwxr-xr-x 22 root          root           4096 Mar 22 18:37 ..
drwxr-xr-x  2 homeassistant homeassistant  4096 Apr 29 10:36 hassbackup
drwx------  2 root          root          16384 Apr 29 10:18 lost+found

You can ignore 'lost+found'.

{% linkable_title Install Dependency %}

In order to preserve space on your drive we use zip. Install that too.

root@hassbian:/media# apt-get install zip
Reading package lists... Done
Building dependency tree
etc etc etc
Setting up zip (3.0-8) ...

{% linkable_title Install & run script %}

Become the homeassistant user and place the following script to a place of your liking. Don't forget to 'chmod +x usb_backup.sh'

Open up the file and change the paths you want to use, then simply run the usb_backup.sh

homeassistant@hassbian:~ $ .homeassistant/extraconfig/shell_code/usb_backup.sh
[i] Creating backup
[i] Backup complete: /media/hassbackup/hass-config_20170429_112728.zip
[i] Keeping all files no prunning set

{% linkable_title Crontab %}

In order for this to automaticly make a backup every night at 3, you can add a crontab for it as the homeassistant user. Change below path to where you placed the usb_backup.sh and run the following line.

(crontab -l 2>/dev/null; echo "0 3 * * * /home/homeassistant/.homeassistant/extraconfig/shell_code/usb_backup.sh") | crontab -

{% linkable_title Auto mount %}

This does not automaticly mount your usb drive at boot. You need to do that manually or add a line to your /etc/fstab If your drive is on /dev/sda1, you could add a entry to your /etc/fstab like so:

/dev/sda1  /media               ext4    defaults,noatime  0       1

Manual: 'mount /dev/sda1 /media'