Download - virtual machines
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!
