---
title: "Backup and Restore"
description: "Backups of LumiScan Annotation Web: what they contain, automatic and manual backups, downloading them in the browser and restoring on the command line."
product: "LumiScan Annotation Web"
component: "lumiscan-annotation-web"
version: "2.2.0"
display_version: "2.2.0.0"
latest_version: false
language: "en"
url: "https://docs.hdvisionsystems.com/en/lumiscan-annotation-web/2.2.0/backup-and-restore.html"
---

# Backup and Restore – LumiScan Annotation Web

## What a backup contains

A backup is one tar file with everything the server keeps apart from the images:

- the database: accounts, group mappings, projects and members, the history of all annotations, revision notes,
- the files of the configuration folder: configuration, secret files, certificates,
- the folder `tls` next to the configuration: the HTTPS certificate, so the clients keep trusting it after a restore,
- the settings of every project.

The images and annotation files are backed up with the project folders themselves (your usual file backup), or per project with the [export](https://docs.hdvisionsystems.com/en/lumiscan-annotation-web/2.2.0/projects.html#exporting-and-importing).

> [!WARNING]
> Backups contain password hashes and secrets. Store them as carefully as the server itself.

## Automatic backups

Every `backup.every_hours` hours (default 24) into `backup.dir` (default `backups` next to the configuration). The newest `backup.keep` (default 14) are kept.

## In the browser

Admins: your name → **Users and sign-in** → **Backups**. The list shows the backups on the server; **Make a backup now** makes one, **Download** downloads it.

![Tab Backups: what a backup contains, the automatic schedule and folder, the list of backups with Download, and the button Make a backup now](https://docs.hdvisionsystems.com/en/lumiscan-annotation-web/2.2.0/_images/screens/backups.png)

## On the command line

Also while the server runs:

```none
lumiscan-annotation-server --config <configuration> --backup D:\Backups\annotation.tar
```

## Restoring

1. Stop the server.
2. Restore:
   ```none
   lumiscan-annotation-server --config <configuration> --restore <backup.tar>
   ```
3. Start the server.

The current database and every file the restore replaces are kept next to them as `…before-restore-<time>`. Sessions are not restored: everyone signs in again. The restore refuses to run while the server answers on its port (`--force` overrides this).