Skip to content

Getting Started

This guide explains how to install licobox and getting started with it.

1. Install licobox

licobox can be installed using Homebrew package manager:

shell
brew install licobox/licobox-tap/licobox

2. Install Docker client CLI

Docker client is required to interact with Licobox docker engine, skip this step if you already have one. Docker client can be installed with brew:

shell
brew install docker

3. Start licobox

Once licobox is installed, you can start licobox:

shell
licobox start

It will be up and running within seconds.

Docker context is automatically switched to licobox. If it hasn’t switched, make sure to set the Docker context to licobox by running licobox config-docker set-context

4. Running Container

Once licobox is started, run the following to get started:

shell
docker run -d -it -p 3000:3000 ghcr.io/licobox/getting-started:latest

Once it’s up and running, visit http://localhost:3000 in your browser.

licobox is now running and can be used to manage Docker containers.

Demo

The following demo shows how start licobox, run a container and access an exposed port