From d8af47bd21fc766085802a3baf73d4274dacd5a0 Mon Sep 17 00:00:00 2001 From: Serhat Dolmac Date: Thu, 23 Apr 2026 23:17:05 +0300 Subject: [PATCH] =?UTF-8?q?docs(cli):=20expand=20hermes=20import=20referen?= =?UTF-8?q?ce=20=E2=80=94=20add=20description,=20warning,=20and=20examples?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- website/docs/reference/cli-commands.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/website/docs/reference/cli-commands.md b/website/docs/reference/cli-commands.md index ab1ecf526..164cf70b3 100644 --- a/website/docs/reference/cli-commands.md +++ b/website/docs/reference/cli-commands.md @@ -443,12 +443,22 @@ hermes backup --quick --label "pre-upgrade" # Quick snapshot with label hermes import [options] ``` -Restore a previously created Hermes backup into your Hermes home directory. +Restore a previously created Hermes backup into your Hermes home directory. Files are overlaid onto your current Hermes home — existing files are skipped unless `--force` is used. | Option | Description | |--------|-------------| | `-f`, `--force` | Overwrite existing files without confirmation. | +:::warning +Stop the gateway before importing to avoid conflicts with running processes. +::: + +### Examples +```bash +hermes import ~/hermes-backup-20260423.zip # Restore, skip existing files +hermes import ~/hermes-backup-20260423.zip --force # Restore, overwrite existing files +``` + ## `hermes logs` ```bash