https://github.com/virtomize/virtomize
virtomize is an on premise automation software for your hypervisor to create, install and configure your virtual machines
https://github.com/virtomize/virtomize
Last synced: 3 months ago
JSON representation
virtomize is an on premise automation software for your hypervisor to create, install and configure your virtual machines
- Host: GitHub
- URL: https://github.com/virtomize/virtomize
- Owner: Virtomize
- License: other
- Created: 2020-08-04T08:19:00.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-07-21T12:15:43.000Z (almost 4 years ago)
- Last Synced: 2025-01-14T11:34:06.141Z (5 months ago)
- Language: Shell
- Size: 77.1 KB
- Stars: 2
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://virtomize.com)
[](https://blog.virtomize.com)
[](https://docu.virtomize.com)
[](https://virtomize.com/pricing)
[](LICENSE)
[](https://twitter.com/virtomize)
[](https://www.xing.com/companies/virtomizegmbh)
[](https://www.linkedin.com/company/virtomize/)
# Create - Deploy - Provision
[Virtomize](https://virtomize.com) is a commercial software build for automating your datacenter.
You can create, install and configure, snapshot or reinstall virtual machines with only a few clicks or via [REST API](https://docu.virtomize.com).
For currently supported hypervisors and operating systems please take a look on our [FAQ](https://virtomize.com/faq/).
We have a [free version](https://virtomize.com/pricing). Just install Virtomize using this repo or download a pre-build [virtual appliance](https://virtomize.com/downloads).
# Installation
## Installation using install script
Recommended for fast and easy installation
### Requirements
Just a fresh debian 10 system
### Installation
The installation will install docker, docker-compose and apache2 reverse proxy.
```
curl -fsSL https://raw.githubusercontent.com/Virtomize/virtomize/master/install.sh | bash
```
## Installation using virtual appliance
### Installation
Download the [latest virtual appliance](https://virtomize.com/downloads)
Follow the import procedure described in our [documentation](https://docu.virtomize.com/#import-ova).
## Manual installation using git
Recommended only for advanced users for running Virtomize on servers with multiple other services.
***We do not provide OS level support for custom installations***
### Requirements
The following software is required to install and run [Virtomize](https://virtomize.com) on your server.
- docker
- docker-compose
- apache or nginx
- git
For more information please consult our [documentation page](https://docu.virtomize.com).
Make sure the server running our software can request your hypervisor API.
We use a simple docker-compose setup to make it as easy as possible.
This will start our service on `127.0.0.1:8000`
```
cd /opt
git clone github.com/virtomize/virtomize
cd virtomize
docker-compose up -d
```
### Cron for update via ui
To enable the update button in the UI add the following cron.
```
cat </etc/cron.d/vtmz-update
* * * * * root /opt/virtomize/update.sh
EOF
```
### Reverse proxy configuration
To make sure our service can be accessed from your servers domain or IP address including SSL create a reverse proxy using Apache or Nginx.
#### Apache
debian 10 example
```
apt -y install apache2
systemctl enable apache2
a2enmod ssl
a2enmod proxy
a2enmod proxy_http
a2enmod headers
a2enmod rewrite
# default config is configured to use the snakeoil cert generated by apache on install
# if you want to change this change the apache config
cp /opt/virtomize/proxy/apache.conf /etc/apache2/sites-available/000-default.conf
# add dhparm
curl https://ssl-config.mozilla.org/ffdhe2048.txt >> /etc/ssl/certs/ssl-cert-snakeoil.pem
systemctl restart apache2
```
[apache config](proxy/apache.conf)
#### Nginx
debian 10 example
```
apt -y install nginx
systemctl enable nginx
# create a certificate or use your own
# if you want to use a different path change the nginx config
mkdir /etc/nginx/ssl
openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout /etc/nginx/ssl/nginx.key -out /etc/nginx/ssl/nginx.crt
# add dhparm
curl https://ssl-config.mozilla.org/ffdhe2048.txt > /etc/nginx/ssl/dhparam
cp /opt/virtomize/proxy/nginx.conf /etc/nginx/sites-available/default
systemctl restart nginx
```
[nginx config](proxy/nginx.conf)
# Update manually
To manually update Virtomize use the following command.
**Always create a backup before updating.**
```
cd /opt/virtomize
./update.sh -m
```
# Backup
## Default Backups
After starting Virtomize using docker-compose multiple folders are created including the `/opt/virtomize/backup` folder.
We do make daily backups and keep them for 30 days.
Just copy or sync these backups from the `backup` folder to your favorite backup storage.
## Via REST-API
You can [make a backup using our REST-API](https://docu.virtomize.com/#backup-get). This backup is not stored in the `backup` folder and only for download.
# You need a feature or found a bug
Please open an [issue](https://github.com/Virtomize/virtomize/issues/new/choose) for your feature or bug request.
# Contact
If you have questions feel free to [contact us](https://virtomize.com/contact/).