Skip to content

Instantly share code, notes, and snippets.

@orgcontrib
Created November 9, 2025 10:41
Show Gist options
  • Select an option

  • Save orgcontrib/ff91a1a79067e5072a6bd85ed408b805 to your computer and use it in GitHub Desktop.

Select an option

Save orgcontrib/ff91a1a79067e5072a6bd85ed408b805 to your computer and use it in GitHub Desktop.
HOWTO Import/Export GNOME Boxes (VMs)

HOWTO Import/Export GNOME Boxes (VMs)

WIP Feature (work in progress)

Issue#444 as of now: 2025-11-09.

Hints about the current state of affairs

dacbarbos@vivobookone:~$ ll ~/.var/app/org.gnome.Boxes/data/gnome-boxes/images
ls: cannot access '/home/dacbarbos/.var/app/org.gnome.Boxes/data/gnome-boxes/images': No such file or directory
dacbarbos@vivobookone:~$ # the new way hasn't landed yet (as of F43/GNOME-Boxes-49.0)
dacbarbos@vivobookone:~$ virsh list --all
 Id   Name     State
-------------------------
 -    debian   shut off
 -    win7     shut off

dacbarbos@vivobookone:~$ # so where are my VMs (disk images)?
dacbarbos@vivobookone:~$ ll ~/.local/share/gnome-boxes/images
total 61366800
-rwxr--r--. 1 dacbarbos dacbarbos 31938445484 Nov  9 10:50 debian
-rwxr--r--. 1 dacbarbos dacbarbos 30901403648 Nov  8 22:13 win7
dacbarbos@vivobookone:~$ # what's the default image format?
dacbarbos@vivobookone:~$ file ~/.local/share/gnome-boxes/images/debian
/home/dacbarbos/.local/share/gnome-boxes/images/debian: QEMU QCOW Image (v3), 32212254720 bytes (v3), 32212254720 bytes
dacbarbos@vivobookone:~$ 

EXPORT: Simply copy/backup your source image file(s) onto some external storage (e.g., a USB drive).
cp ~/.local/share/gnome-boxes/images/debian /run/media/$USER/debian.qcow2
IMPORT: Simply use the Install from File (+ menu option) in the app's window (upper-left corner).
TIP: It's important to set the correct OS when it is undetected or unknown during import or installation.

NOTE: To maintain consistency, I suggest installing the image in its place before importing it.
EXAMPLE: install /run/media/$USER/debian.qcow2 -m 744 -t ~/.local/share/gnome-boxes/images
Optional, but recommended (for the sake of consistency), is to rename it without the qcow2 extension.

@orgcontrib
Copy link
Author

I made a follow up video for this gist showing how I imported my win11 vm https://youtu.be/bxpiW5WPMzM.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment