#Installer for the Engines System

How to Use

For use on a fresh Ubuntu 14.04 or 15.x installation
While Engines is in a prelease stage we do not recommend installation onto a live system.

sudo apt-get install -y git

git clone https://github.com/EnginesOS/EnginesInstaller

cd EnginesInstaller

sudo  ./install_engines.sh 

The installer will take 25mins for a cloud installation, a local install will take longer dependening on the speed of your Internet connection The total download is about 2.GB

Once finished the installer will present a url to open to configure the installation. The user name and password combination for the initial login is admin:password

System Requirements
2GB Ram 40 GB HD

Configuration

DNS

On the first run wizard you will need to fill in a default domain and DNS hosting type, there are three main ways DNS can be configured.
Do not use a .local suffix for the default domain.

Private This will setup up a DNS zone hosted on the engines server for the default domain with records published using the engines server LAN IP address.
To access the engines system you will need to set your workstations DNS server to the engines server.

Public - hosted Externally Set the default domain in the first run wizard as some.domain.name You will need to add the following DNS records

   some.domain.name.	A  the_external_ip_address_of_engines_server
   *.some.domain.name.	A  the_external_ip_address_of_engines_server
  

You may wish to set TTLs
some.domain.name. does not need to be a top level domain as in mycompany.com, but can engines.mycompany.com even engines.testing.mycompany.com as in

   engines.testing.mycompany.com.	A  the_external_ip_address_of_engines_server
   *.engines.testing.mycompany.com.	A  the_external_ip_address_of_engines_server
  

Web access to engines and services (where applicable) is then through hostname.some.domain.name in the example above mgmt.engines.testing.mycompany.com

Public - Self Hosted Not recommended for anything other that testing purposes, when set engines creates and publishes the above DNS entries as an authoritive server on the public ip address of the engines server

You can change these latter and add additional domains through the management application and mix types.

Comming soon
Dynamic DNS provider support
Future
Zeroconf domains

Ports

If you are installing Engines remotely you will need atleast port 10443 publicly acessible to access the management interface

RequiredPorts

Management Interface 8484/TCP

Webpages hosted 80,443/TCP

Optional Ports

FTP Ports 989,990/TCP

Email 25,465,993,995/TCP

DNS 53/UDP

VPN 1194/TCP+UDP

ssh to mgmt 828

ssh to host 22

Other Versions

Installer syntax
sudo ./install_engines.sh {branch}
The available branches for the EnginesSystem are

beta-rc (default)

master

current

beta-rc with support for updating to future versions hopefully all the way up to beta-release and beyond

master is the latest stable

current is the bleeding edge

Support and Issues

If you have any queries and problems please email support@engines.onl or raise an issue on github

With the Installer @ https://github.com/EnginesOS/EnginesInstaller/issues/new

With the Engines System @ https://github.com/EnginesOS/System/issues/new

With the Engines Management Interface @ https://github.com/EnginesOS/SystemGui/issues/new