---
updatedAt: 2025-11-05T21:08:51.000Z
agentTools:
  projectIndex: https://esf.eurotech.com/llms.txt
---

# Snapshot Management

The overall configuration of ESF is stored in an XML file called a snapshot. This file includes all of the parameters for every service running in ESF. The original configuration file is named **snapshot\_0.xml**. This section describes how snapshots may be used.

Each time a configuration change is made to one of the ESF components, a new XML file is created using the naming convention **snapshot\_\[time as a long integer].xml**. The nine most recent snapshots are saved, as well as the original snapshot 0.

# How to Access Snapshots

To display snapshots using the [Gateway Administration Console](https://esf.eurotech.com/docs/gateway-administration-console), select **Settings** from the **System** area, and then click on the **Snapshots** tab. The following three operations are available: **Download**, **Upload and Apply**, and **Rollback**.

![2424](https://files.readme.io/4538e28-ESF_Snapshots.png "ESF_Snapshots.png")

# How to Use Snapshots

## Download

The **Download** option provides the ability to save a snapshot file onto your computer. This file may then be edited, uploaded back to the device, or transferred to another equivalent device.

Starting from ESF 7.1, the snapshot can be downloaded in two formats:

* **XML**: The original XML snapshot format.
* **JSON**: The JSON format used by the [Configuration v2 REST APIs and CONF-V2 request handler](https://esf.eurotech.com/docs/configuration-v2-rest-apis-and-conf-v2-request-handler). For example the downloaded snapshot can be used as is as a body for the [PUT/configurableComponents/configurations/\_update](https://esf.eurotech.com/docs/configuration-v2-rest-apis-and-conf-v2-request-handler#putconfigurablecomponentsconfigurations_update) request. The `takeSnapshot` parameter specified by the CONF-V2 request is missing from the downloaded JSON file, if that parameter is not specified, a new snapshot will be created by default.

Pressing the **Download** button will trigger a dialog that allows choosing the desired format.

![2408](https://files.readme.io/f983f29-Screen_Shot_2021-12-09_at_5.21.06_PM.png "Screen Shot 2021-12-09 at 5.21.06 PM.png")

## Upload and Apply

The **Upload and Apply** option  provides the ability to import an snaphsot file from your computer (XML or JSON) and upload it onto the device. This function updates every service in ESF with the parameters defined in the snapshot file.

> ❗️ Carefully select the file to be uploaded. An incorrect file may crash ESF and make it unresponsive.

![2422](https://files.readme.io/a9bc92e-ESF_Snapshots-upload.png "ESF_Snapshots-upload.png")

## Rollback

The **Rollback** option provides the ability to restore the system to a previous configuration.

![2424](https://files.readme.io/a4e63d8-ESF_Snapshots-rollback.png "ESF_Snapshots-rollback.png")