Import / Backup

The Emoncms backup module is used to backup and restore an emoncms installation and migrate from an older emonPi / emonBase image to the latest image.

There are two methods available to do this:

  1. Restore an emoncms installation directly without a previous backup archive using a USB SD card reader.
  2. Export and import a compressed archive containing all emoncms user data.

The direct USB SD card reader approach is the most straightforward method for migration from an old SD card to a new SD card running the latest emonSD image. It can also minimise data loss in the event of a system failure where a recent archive backup has not been created.

The archive export/import approach is useful for creating backup snapshot’s and can be a good fall back in the case of more serious SD card corruption. An archive export will however be needed prior to the failure point.

Currently the Backup Module can only be used with Local Emoncms not

Restore using a USB SD card reader

  1. Place the old SD card in a SD card reader and plug into any of the USB ports on the Pi running the new image
  2. Navigate to Setup > Backup
  3. Click Import from USB drive to start import process

USB Import

Fixing a corrupt SD card

After a system failure the SD card may become corrupted and will not mount when the USB importer is ran. It can be possible to restore a corrupted SD card by running fsck to fix the card errors. To do this:

1. Place the old SD card in a SD card reader and plug into any of the USB ports on the Pi running the new image
2. SSH into the emonPi/emonbase
3. Run the following commands (without part in brackets) to attempt to fix the card:

sudo fsck.ext4 /dev/sda2 (root OS partition)
sudo fsck.ext2 /dev/sda3 (data partition)

4. Continue as above, Navigate to Setup > Backup and click Import from USB drive to start import process

Archive Export

  1. Navigate to Setup > Backup
  2. Click Create Backup (see screenshot below)
  3. Wait for backup to be created, then refresh the page to view Download Backup link
  4. Download .tar.gz compressed backup

backup old data

Archive Import

Importing / restoring a backup will overwrite ALL data in the current Emoncms account.

Note for If the image has been written to an SD card larger than 4GB the data partition should be expanded to fill the SD card to create sufficient space to import a backup. Do not use Raspbian raspi-config, instead connect via SSH) and run $ sudo emonSDexpand and follow prompts.

The latest has already been expanded to fit a minimum 16 GB SD card size. To expand the data partition further run: /opt/emoncms/modules/usefulscripts/sdpart/./sdpart_imagefile.

To import a backup:

  1. Check available disk space in the data partition (/var/opt/emoncms), see Local Emoncms > Setup > Admin
  2. Select .tar.gz backup file
  3. Wait for upload to complete
  4. Click Import Backup
  5. Check restore log (see below)
  6. Log out then log back into Local Emocms using the imported account login credentials

Backup tar.gz filename cannot contain any spaces; e.g., if the same backup has been downloaded more than once: rename 'emoncms-backup-2016-04-23 (1).tar' to 'emoncms-backup-2016-04-23.tar' before uploading.

emonSDexpand will run ~/usefulscripts/sdpart/./sdpart_imagefile script, for more info see Useful Scripts Readme


Successful import log example

Included in backup

  • Emoncms account credentials
  • Historic Feed data
  • Input Processing config
  • Emoncms Dashboards
  • Emoncms App settings
  • EmonHub config: emonhub.conf

Not included in backup

  • WiFi passcode & custom network config
  • Custom NodeRED flows
  • Custom openHAB settings
  • Input processing setup if migrating from Emoncms V8, input processing will need to be re-created after import and new inputs should be logged to imported feeds

How-to backup items not automatically included

  • nodeRED custom flows: select all flows then menu > export > clipboard copy the JSON text
  • Connect via SSH:
    • See Technical > Service Credentials
    • WiFi settings & password: backup copy: ~/data/wpa_supplicant.conf
    • openHAB custom config: copy ~/data/open_openHab folder

Video Guide (Export/Import method)

The following video guide was put together using emoncms v9, the appearance will be different if you are using v10 of emoncms or newer but the functionality is much the same. We will be updating this video soon.


If you have any questions or if an error occurs during the backup or import process please post in the Hardware > emonPi category of the Community Forums. Please provide as much information as possible e.g. backup / import logs and emonSD version.

Alternatively try and perform a manual import, see Backup Module Readme.

Export from an older emonPi / emonBase

If the Backup module is not visible in the Local Emoncms menu then the emonPi / emonBase is running an older version e.g Emoncms V8.x. Try the USB Import method above.

To check what software stack (emonSD pre-built SD card) version an emonPi is running see instructions on emonPi emonSD download repository and changelog