Installing Cocktail Mini

This guide contains how to install and run Cocktail Mini.

System requirements

Minic is available on multiple operating systems.

  • macOS : El Capitan 10.11 and newer macOS releases
  • Windows : Windows 10 Pro, Enterprise and Education (1607 Anniversary Update, Build 14393 or later)
  • Ubuntu : Xenial 16.04(LTS) and 18.04(LTS)
  • CentOS 7

Minic requires at least 2 cores of CPU and 4 Gbytes of memory. So, your device(PC, notebook etc.) should have more resources then this requirements.

  • 2 Cores of CPU or above
  • 8 Gbytes of memory or above

Install Docker

Minic requires Docker to run the Cocktail Mini container. Install Docker, depending on your host operating system. Refer to following link.

Docker install

  • Recommended Docker Version: 18.05 and 18.06

In macOS and Windows, Docker is launched on virtual machine that is hosted on your PC or notebook. So, all containers(including Cocktail Mini container) only use resources that the virtual machine has. Because of this reason, you should configure the Docker’s advanced options of resources for running Minic.

Configure Docker resources setting

Docker for Mac

Click the whale in the top status bar, and choose “Preferences” menu.

docker menubar

docker for mac

On the Advanced tab, you can see the resources available to Docker. Set the CPUs value to 2 cores and the Memory value to 4.0 GiB as follows.

docker for mac advanced

Docker for Windows

Open the Docker for Windows menu by right-clicking the Docker icon in the Notifications area (or System tray).

docker for mac advanced1

Select Settings… to open the Settings dialog.

docker for mac advanced2

On the Advanced tab, you can see the resources available to Docker. Set the CPUs value to 2 cores and the Memory value to 4096 MB. The Linux VM restarts after changing the settings on the Advanced tab. This takes a few seconds.

docker for mac advanced3

If your docker is configured as a Windows containers, you must switch it to a Linux containers

docker for mac advanced4

Download and install Minic

Minic is distributed in zip or tar.gz file that is consists of a single executable file.

Download the Minic distribution file from following links, depending your operating system.

After downloading, unzip the downloaded file to your PATH directory.

Now, you ready to run Minic.

Running Minic

To run minic, type the “start” command on your prompt.

$ minic start

The minic start command has several steps on processing.

At first, the start command download the Cocktail Mini container image. It takes one or more minutes, depending your network speed. And then, it runs kubernetes cluster and Cocktail Mini. At this time, your prompt is changed to “status mode”.(see following image)

minic status

Cocktail Mini is consist of containers(pods) that are run on kubernetes. So, you should wait untill all containers are run. (As like the above image, all pod status will be changed to “Running(green)” when to be ready)

Type “o” to open Cocktail Mini and you can see the login screen of Cocktail Mini as following.

minic-login

Only one user is available on The Cocktail Mini.

  • Role : Admin
  • Id : admin@acornsoft.io
  • Password : admin0000

After you logined, you can see the main dashboard of Cocktail Mini.

minic status

Now you can experience the Cocktail Cloud !

Updated: