Download - virtual machines
RocketGit as a virtual machine
On this page you will find instructions on how to deploy RocketGit using a virtualization solution:
* qemu/KVM/libvirt
* VMware ESXi
* VMware Player
* VirtualBox
* common section
qemu based virtualization
Steps to follow:
* make sure libvirtd is started:
systemctl enable libvirtd
systemctl start libvirtd

* download qemu image (~130 MiB):
wget -c -O /var/lib/libvirt/images/rocketgit1-main.qcow2.xz http://downloads.rocketgit.com/vm/last/rocketgit1.qcow2.xz

* download libvirt vm description file (4 KiB):
wget -c -O /var/lib/libvirt/images/rocketgit.xml http://downloads.rocketgit.com/vm/last/rocketgit.xml

* decompress qemu image:
cd /var/lib/libvirt/images/
xz -v -d rocketgit1-main.qcow2.xz

* create a clone of the image to be able to start over or to make multiple instances:
qemu-img create -f qcow2 -b rocketgit1-main.qcow2 rocketgit1.qcow2

* add the rocketgit1 virtual machine:
virsh define --file /var/lib/libvirt/images/rocketgit.xml

* make it start at boot:
virsh autostart rocketgit1

* now, you may want to change some virtual machine parameters using virt-manager or 'virsh edit rocketgit1' command; pay attention to the network definition

* make sure no other virtualization system is running (like VirtualBox)

* start the virtual machine:
virsh start rocketgit1

* attach to the console to find out the ip address:
virsh console rocketgit1

* now, point your browser to the found ip address, using http or https and create an admin account

If you want to create a new RocketGit instance, you can create a new image based on rocketgit1-main:
cd /var/lib/libvirt/images/
qemu-img create -f qcow2 -b rocketgit1-main.qcow2 rocketgit2.qcow2
# edit rocketgit.xml and replace any reference of rocketgit1 to
# rocketgit2; leave alone the reference to rocketgit1-main.qcow2
virsh define --file rocketgit.xml
virsh edit rocketgit2
virsh autostart rocketgit2
virsh start rocketgit2
virsh console rocketgit2

Now, please follow the common section below to finish the installation.
VMware ESXi based virtualization
Steps to follow:
* download VMX config file (2 KiB) from http://downloads.rocketgit.com/vm/rocketgit1-esx.vmx
* download VMDK image (~200 MiB) from http://downloads.rocketgit.com/vm/last/rocketgit1.vmdk.zip in the same folder as the previous file
* decompress the image and move both files to an ESX datastore
* in VMware Client, browse the datastore, right click on .vmx file, and choose "Add to inventory"
* now, you may want to change some virtual machine parameters; pay attention to the network definition
* start the virtual machine
* attach to the console to find out the ip address
* point your browser to the found ip address, using http or https and create an admin account
Now, please follow the common section below to finish the installation.
VMware Player based virtualization
Steps to follow:
* if you do not have a VMware virtualization solution, go to VMware site and download VMware Player. Choose try for free. It is around 75 MiB. And then, install it
* download VMX config file (2 KiB) from http://downloads.rocketgit.com/vm/rocketgit1.vmx
* download VMDK image (~200 MiB) from http://downloads.rocketgit.com/vm/last/rocketgit1.vmdk.zip
* decompress the image
* start VMware Player
* choose "Open a Virtual Machine", select the .vmx file and press "Open"
* now, you may want to change some virtual machine parameters; pay attention to the network definition
* start the virtual machine, using "Play virtual machine"; choose "I copied it" if asked
* attach to the console to find out the ip address
* point your browser to the found ip address, using http or https and create an admin account
Now, please follow the common section below to finish the installation.
Oracle's VirtualBox based virtualization
Steps to follow:
* if you do not have VirtualBox installed, go to VirtualBox site, download a proper executable (around 106 MiB) and install it
* download the OVF file (12 KiB) from http://downloads.rocketgit.com/vm/rocketgit1.ovf
* download the compressed VMDK image (~200 MiB) from http://downloads.rocketgit.com/vm/last/rocketgit1.vmdk.zip
* decompress the image
* start VirtualBox, choose "File" menu, then "Import Appliance..."; select the .ovf file just downloaded and press "Next"
* you may want to change some virtual machine parameters and then press "Import"
* when asked about the license, choose "Agree"
* start the virtual machine by pressing "Start" button; login into the virtual machine to find out the ip address
* point your browser to the found ip address, using http or https and create an admin account
Now, please follow the common section below to finish the installation.
Common section for all virtualization solutions
You must check the following list because you may want to:
* extend the disk space; maybe adding some swap space
* set the virtual machine to auto boot at host start
* add the VM in the distribution update plan
* run timedatectl set-timezone 'Continent/City' to set the timezone (needs a restart of some services or a reboot)
* change the root password: run 'passwd' (initial password is 'aaaa')
* allow this virtual machine to send mail (add it to the relay allow list)
* set a static IP address instead of DHCP
* add it to the DNS server to be able to access it by name
* generate new SSL/TLS certificates / keys
* customize /etc/rocketgit/config.php
* customize /etc/httpd_or_nginx/conf.d/rocketgit.conf
* login into RocketGit as admin and tweak settings in Admin -> Settings

Enjoy your new RocketGit instance!