This guide contains how to install and run Cocktail Mini.
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
Minic requires Docker to run the Cocktail Mini container. Install Docker, depending on your host operating system. Refer to following link.
- 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.
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 Windows
Open the Docker for Windows menu by right-clicking the Docker icon in the Notifications area (or System tray).
Select Settings… to open the Settings dialog.
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.
If your docker is configured as a Windows containers, you must switch it to a Linux containers
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.
To run minic, type the “start” command on your prompt.
$ minic start
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)
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.
Only one user is available on The Cocktail Mini.
- Role : Admin
- Id : firstname.lastname@example.org
- Password : admin0000
After you logined, you can see the main dashboard of Cocktail Mini.
Now you can experience the Cocktail Cloud !