Guacamole Gateway

Primary goal is to use Vagrant to deploy Guacamole on CentOS as a means to provide a HTML5 GUI for multiple Projects.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

You will need some software on your CentOS or Solaris Host Machine, here are the most important:

git
Vagrant
Virtualbox

Installalation

A step by step series of examples that tell you how to get a development env running

To ease deployment, we have a few handy scripts that will utlize a package manager for each OS to get the pre-requisite software for your host OS.

CentOS 7

We will utilize YUM and a few other bash commands to get the Virtualbox, Git, and Vagrant installed.

YUM

yum -y install gcc dkms make qt libgomp patch kernel-headers kernel-devel binutils glibc-headers glibc-devel font-forge
cd /etc/yum.repo.d/
wget http://download.virtualbox.org/virtualbox/rpm/rhel/virtualbox.repo
yum install -y VirtualBox-5.1
/sbin/rcvboxdrv setup
yum -y install https://releases.hashicorp.com/vagrant/1.9.6/vagrant_1.9.6_x86_64.rpm
sudo yum install git

Downloading Vagrant-Guacamole-CentOS-8.1 Project

Open up a terminal and perform the following git command:

git clone https://github.com/Makr91/Vagrant-Guacamole-CentOS-8.1.git
cd Vagrant-Guacamole-CentOS-8.1

Starting Vagrant

The installation process is estimated to take about 15 - 30 Minutes (mayber longer on older machines)

vagrant up

Built With

• Vagrant - Portable Development Environment Suite.
• VirtualBox - Hypervisor.
• Ansible - Virtual Manchine Automation Management.
• vagrant-vbguest - A Vagrant plugin to keep your VirtualBox Guest Additions up to date.
• vagrant-reload - A Vagrant plugin that allows you to reload a Vagrant plugin as a provisioning step.
• vagrant-disksize - A Vagrant plugin to resize disks in VirtualBox.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

• Mark Gilbert - Initial work - Makr91

See also the list of contributors who participated in this project.

License

This project is licensed under the SSPL v3 License - see the LICENSE.md file for details

Acknowledgments

• Hat tip to anyone whose code was used