Alternate Installation Methods


  • Atlas Automation Hub is setup to install on an Ubuntu server, however with a few tweaks to the install script it will work well on most Linux OS.
  • curl or wget should be installed
  • Ideally, you will have your own git repository, holding updated config files, and will publish from there.

An install script is provided to easily install onto your Ubuntu server. Update the publish/ file “dns” value to be the dns of your server, and the “remote” to point to your repo path. If you plan to use ssl you can add the certs into the publish folder as well. Use names “cert.crt” and “cert.key”.

The publish takes place over SSH from a git server. It is possible to use an accesskey when publishing from fabric.

Update username and hostname with your planned login. Commands require sudo. sudo bash...

Method Command
fabric cd publish && fab publish && cd ..
curl bash -c "$(curl -kfsSL"
wget bash -c "$(wget -O-"

After cloning the repository the script will install all packages necessary to start up the app.


A configuration file should be created at the project root, along size the file.

The custom configuration file should be called Settings can be copied from and updated as needed.

At a minimum, the should import the base configuration.

from config import Config as BaseConfig

class Config(BaseConfig):
    ALLOWED_HOSTS = ["localhost"]

Creating Database

export FLASK_APP=web;export FLASK_DEBUG=0;export FLASK_ENV=production;
flask db init;
flask db upgrade;
flask cli seed

# add demo data in needed
# flask cli seed_demo


There are two primary authentication options -

  • SAML2
  • LDAP


The PySAML2 library is used for SAML authentication, and all the sp configuration parameters are supported. See the example config file for an ADFS setup example.

SAML2 requires that the xmlsec1 binary be present and mapped to in the config file.


LDAP login follows this basic process:

  1. file holds the general connection info. A connection to the ldap server is made with the service account credentials supplied in the config file.
  2. Once a connection is established and a user attempts to access the site the package first verifies that the user exists, by doing a search for the user. If the user exists we save their details and groups.
  3. If the user exists then we attempt to log them in… this returns true if they had a valid username/pass.
  4. Finally, as this site can be restricted to users in a certain LDAP group, for example, we only allow users that have the “Analytics” group on their profile.
The python package python-simpleldap has been customized to work with this installation, but most paramters will be accepted.