ACAEngine is distributed as a set of docker containers that are designed to deploy to your on-prem infrastructure or private cloud. To keep things simple for development, testing, and experimentation this is also packaged as a prebuilt environment that you can run on your local machine.
This environment runs across MacOS, Windows, or Linux - feel free to pick where you work best.
In order to run this environment you will need two common tools:
Vagrant: a tool for managing virtual environments.
VirtualBox: an open source, cross-platform virtualisation provider.
Outside of these, nothing will need to be installed or modified on your machine.
Setup these now, then drop back - we’ve prepared some music to play while you do this...
Now that you have the required tools, choose a directory where you'd like to work, then run
vagrant init acaengine/dev-env
This will create a Vagrantfile that contains your environment config.
Open a terminal window in the same directory as your vagrant file and run:
You will see some updates while your environment boots up. This may take a couple of minutes the first time it runs. When it’s complete you will be provided with a URL and authentication details to log in.
Congratulations you’re ready to go!
When you’re done working with ACA Engine use
to shutdown your environment.
You can continue to use these two commands to start and stop your local ACAEngine instance as you need.
Changes that you make, such as adding or removing devices, systems, or zones will persist across restarts. To return to a fresh deployment run
The next time you run
vagrant up you'll be presented with a fresh deploy.