Manually Create Whonix VM Settings

Whonix ®

Download

Windows Linux Mac VirtualBox KVM Qubes Intel / AMD64 ARM64 PPC64 USB ISO Raspberry Pi More options Source Code

About

Overview Features Whonix vs VPNs Why Open Source? Project Activities Contributors Mission & Vision

Docs

Documentation FAQ Troubleshooting

Community

Forums Forum Best Practices Contribute

Support

Self Support First Policy Search Engines, Docs and AI Support (Limited) Reporting Bugs Contact (Restricted)

Tools Upload file Special pages Recent changes Print Version Page meta What links here Related changes Page information

Page Read Edit History Move Protection Unwatch Watch Delete Purge

User Preferences Watchlist Contributions Logout Create account Login

Donate

• Only got a backup of .vdi virtual machine hard disk files? Want to restore them? That's what this page is for.
• Want to create a backup of Whonix? See Backup Whonix VMs instead.
• In case you want to use other operating systems behind Whonix-Gateway^™, other than the default Whonix-Workstation^™, then rather read the Other Operating Systems page.

Advanced users only!

The following instructions are useful, if you have a backup of Whonix .vdi (or .vdmk) hard disk images but want to restore them. This could be the case if your VM settings file is damaged or missing for some reason or if you only made a backup of the .vdi files.

1. Install Whonix normally.

The easiest is probably to download and import a new Whonix as if getting started with Whonix for the first time.

This is required to get the required Whonix VM settings (which configure important things such as connecting Whonix-Workstation to Whonix-Gateway.

2. Power off the VM.

If not already.

3. Replace the virtual hard disk files.

Note: This step is unspecific to Whonix

In the VirtualBox VMs folder ~/VirtualBox VMs, replace the original .vdi with the version from your backup.

4. Done.

Whonix The most watertight privacy operating system in the world.

Dark mode

Follow us on social media

Supported by Power Up Privacy

Whonix is proudly supported until 2025 by Power Up Privacy, a privacy advocacy group that seeks to supercharge privacy projects with resources so they can complete their mission of making our world a better place. (Strictly subject to our sponsorship policy.)

At Whonix we value freedom and trust, supporting Open Source and Freedom Software

By using this website, you acknowledge you have read, understood, and agree to be bound by these agreements: Terms of Service, Privacy Policy, Cookie Policy, E-Sign Consent, DMCA, Imprint 2012- 2025 ENCRYPTED SUPPORT LLC

Your support makes
all the difference!

We believe security software like Whonix needs to remain open source and independent. Would you help sustain and grow the project? Learn more about our 13 year success story and maybe DONATE!