https://github.com/u1035/vbox-vm-backup
Command line utility to make backups of Oracle VirtualBox virtual machines
https://github.com/u1035/vbox-vm-backup
backup command-line-tool csharp virtualbox
Last synced: 11 months ago
JSON representation
Command line utility to make backups of Oracle VirtualBox virtual machines
- Host: GitHub
- URL: https://github.com/u1035/vbox-vm-backup
- Owner: u1035
- License: gpl-3.0
- Created: 2019-03-10T08:43:49.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-03-19T18:36:25.000Z (over 7 years ago)
- Last Synced: 2025-08-04T13:49:57.234Z (11 months ago)
- Topics: backup, command-line-tool, csharp, virtualbox
- Language: C#
- Size: 300 KB
- Stars: 4
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# vbox-vm-backup
Command line utility to make backups of Oracle VirtualBox virtual machines
## Requirements
Windows, .NET Framework 4.5
## Download
Current version - 0.2-alpha, [can be dowloaded here.](https://github.com/u1035/vbox-vm-backup/releases/tag/0.2-alpha) Be careful - may contain bugs)
## How it works
It sends shutdown signal to VM (emulating pressing ACPI power button), waits for it's correct shutdown, compresses *.vdi dynamic disk images if necessary, and copies all VM files to specified folder and then starts VM back. Then waits some time for VM starts, and proceeding to the next VM.
Program processes virtual machines sequentally, one by one, to decrease overall downtime and disk load.
This utility is designed to be started manually or by Windows Task Scheduler (you should make a task manually), makes a log file of it's work (**vbox-vm-backup.log** in program folder) and uses XML config file (**settings.xml** in program folder).
## Installation
Just copy **vbox-vm-backup.exe** and your **settings.xml** to any folder on your disk and add a task to run executable in Windows Task Manager.
## Settings
Example settings.xml included in release package and rather intuitive:
```XML
XMPPServer
C:\Users\user\Desktop\VMs\XMPPServer\
D:\
7
30000
C:\Program Files\Oracle\VirtualBox\
1
WebServer
C:\Users\user\Desktop\VMs\WebServer\
D:\
7
30000
C:\Program Files\Oracle\VirtualBox\
1
Mini Windows XP
C:\Users\user\Desktop\VMs\Mini Windows XP
D:\
7
30000
C:\Program Files\Oracle\VirtualBox\
1
```
There are three example VMs - XMPPServer, WebServer and Mini Windows XP machine (these are VM names in VirtualBox Control Panel). You can also use VM UUID instead of name.
So program copies files from `C:\Users\user\Desktop\VMs\XMPPServer` to `D:\XMPPServer_Date-Time`
Waits for 90 seconds (**WaitVMToStart**), allowing first VM to start.
Then goes for next VM - `C:\Users\user\Desktop\VMs\WebServer` to `D:\WebServer_Date-Time`
If there are more copies of this VM, then **NumberOfCopies**, oldest copies are deleted.
**VBoxInstallPath** is a path to VirtualBox executables (VBoxManage.exe and VirtualBoxVM.exe).
**CompressVDI** controls compression of VM disk images, set to 1 to yes, 0 to skip.