improve docs and hints for portable mode

rear · Apr 10, 2024 · c0b7a8f · c0b7a8f
1 parent 38bfd4e
commit c0b7a8f
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 2 deletions.
diff --git a/doc/user-guide/17-Portable-Mode.adoc b/doc/user-guide/17-Portable-Mode.adoc
@@ -10,7 +10,15 @@ The purpose of the portable mode is to solve special scenarios where the ReaR re
 
 To create a portable rescue archive, run `rear mkrescue` or `rear mkbackup` with the `OUTPUT=PORTABLE` option. This will create a portable rescue archive in the `output/` directory. The archive is a tarball with the name `rear-<hostname>-portable.tar.gz`. It will be also copied to the `OUTPUT_URL` if it is set.
 
-To recover a system from a portable rescue archive, you need to extract the archive on your rescue system, change into the directory and run `./usr/sbin/rear -p recover`. The recovery process will then use the extracted ReaR installation to recover the system.
+To recover a system from a portable rescue archive, you need to 
+
+1. extract the archive on your rescue system into a directory
+
+2. set the machine hostname to the target machine, e.g. via `hostnamectl hostname <hostname>` or `hostname <hostname>`
+
+3. change into the directory and run `./usr/sbin/rear -p recover`
+
+The recovery process will then use the extracted ReaR installation to recover the system.
 
 == Caveats
 

diff --git a/usr/share/rear/init/default/002_check_rear_recover_mode.sh b/usr/share/rear/init/default/002_check_rear_recover_mode.sh
@@ -30,7 +30,7 @@ else
     # We are in the normal/original system:
     case "$WORKFLOW" in
         (recover|layoutonly|restoreonly|finalizeonly|mountonly)
-            Error "The workflow $WORKFLOW is only supported in the ReaR rescue/recovery system"
+            Error "The workflow $WORKFLOW is only supported in the ReaR rescue/recovery system, use --portable to disable this check."
             ;;
         (*)
             LogPrint "Running workflow $WORKFLOW on the normal/original system"