Install

Assimilator can be installed through Docker or cloned into a directory and run from there. Personally I prefer Docker since it’s more reliable, but both ways work.

The Docker Way

The best way to install Assimilator is through Docker:

$ docker pull videlanicolas/assimilator:stable

The latest build is constantly improving, I recomend the stable version or instead the latest tag which are also stable:

$ docker pull videlanicolas/assimilator:1.2.2

Run a container:

$ docker run -d -v /path/to/configuration:/etc/assimilator/ -p 443:443 videlanicolas/assimilator:stable

Docker containers are not peristent, so if you want to maintain your configured Firewalls and API keys you should mount an external directory into the container, that’s what the -v is for.

The Repo-Cloning Way

A.K.A I don’t trust your Docker image.

You can clone the repo from Github and build your image of Assimilator from the dockerfile.

$ git clone https://github.com/videlanicolas/assimilator.git $ docker build -t assimilator .

If you don’t want to use Docker there is a bash script to install the dependencies. Also there is another bash script to generate a random certificate for HTTPS connections.

$ git clone https://github.com/videlanicolas/assimilator.git $ chmod +x install.sh generate_certificate.sh $ ./generate_certificate.sh $ ./install.sh