Appendix D: Docker Quickstart

The following command can be used to fetch and load our Docker container into your local registry so that you can get started:

curl "link_to_container" | docker load

Linux

Once loaded, a local Kloudless Enterprise instance with the following command:

docker run -d -p 80:80 -p 8080:8080 \
--ulimit nofile=1024000:1024000 \
-v /tmp/ke-data:/data -v /tmp/ke-log:/data/log \
--cap-add SYS_PTRACE \
kloudless-enterprise:1.25.0 docker_entry

Windows

On a Windows 2016 machine, a named volume must be used instead:

docker volume create --name volume01
docker run -d --name kloudless -p 80:80 -p 8080:8080 -p 22:22 \
-v C:/Users/Administrator/kloudless/shared:/shared \
-v volume01:/data \
--cap-add SYS_PTRACE \
kloudless-enterprise:1.25.0 docker_entry

Be sure to enable sharing of the Drive under Shared Drives in Docker’s Settings. In addition, Hyper-V must be enabled on the host.

Configuration

The commands above will start a stand alone appliance that uses its own local database and broker, which is sufficient for demo or development purposes. To configure the license key, copy it into the data volume directory, via the shared directory if necessary. Once copied, run the following command to obtain a shell in the container's environment:

docker exec -ti container_id ke_shell

Once in the shell set the license key as follows:

sudo ke_manage_license_key set /data/lk-filename

After that finishes, visit http://localhost:8080 to see the developer portal.