Installing On-Premise Console on macOS

Installation Prerequisites and Recommendations

Setting up the On-Premise Console in operating systems other than Windows requires working, up-to-date installations of both Docker and Docker Compose, as well as a Docker account. For detailed installation instructions, see Installing Docker on macOS.

The macOS On-Premise Console will work best when the following system requirements are met:

• Any macOS that can run Docker, preferably OS X 10.11 or higher
• Docker Engine 1.10.0 or higher
• Docker Compose 1.6.0 or higher

Installing On-Premise Console

Once you have Docker installed and working on your macOS device, you can install the Avast Business On-Premise Console the following way:

1. Download docker-compose.yml (template configuration) and docker-compose.env (configuration properties) to the same folder on your machine. If you have macOS Sierra, you can show hidden files in the folder with CMD + SHIFT + .
   1. If you have Git installed, you can retrieve the configuration files by running the following command: git clone https://github.com/avast/management-console-config.git
2. Right-click the .env file and select Open with TextEdit.
3. Set the AFB_HOSTNAME property to your device’s IP address or name. Save your changes
   1. If your device’s IP address changes after you have set the AFB_HOSTNAME property, you will need to edit the .env file with the new device IP address and complete steps 2 and 3 again
4. If desired, you can also edit your database username and password or the ports the Console will use for communication
5. Open the terminal and CD to the directory with the .yml and .env files, then run the following command: docker-compose up
6. Once the application has started, you can access the On-Premise Console via a web browser. Open a browser and navigate to https://<hostname>:<port number> where <hostname> is the name or IP address of the device and <port number> is the port number