Databox Container Manager

Databox OS container manager and dashboard server.

Installation

All Databox components, including the container manager, run in Docker containers. So first, install and run Docker: https://www.docker.com/products/docker

Known issues:

In some cases, the time in docker containers on mac can get out of sync with the system clock. This causes the HTTPS certs generated by the CM from being valid. See docker/for-mac#17. Fix: restart docker for mac.

Running

Once docker is installed, just run the flowing to get your databox up and running.

docker run \
	-v /var/run/docker.sock:/var/run/docker.sock \
	--name databox-cm \
	--label databox.type=container-manager \
	-p 8989:8989 \
	-t databoxsystems/databox-cm

Once Its started point a web browser at 127.0.0.1:8989 and have fun. This is databoxes normal mode of operation an will use an external app store and image repository for apps.

Development

To develop for the Databox platform, it may be necessary to run the platform in dev mode. This will enable a local app store and image repository to be run in containers on your machine. In this mode it is possible to build and replace any part of the platform.

First get the clone this repository:

git clone https://github.com/me-box/databox-container-manager.git
cd databox-container-manager
npm install

Then launch in dev mode by executing ./DevStartInContiner.sh. A shell inside the container manager will be launched, and additional instructions on commands to execute in this shell may be output.

NB: Mount ./certs and ./slaStore as volumes if you want ssl certs and launched apps to save between restarts.

To test a Databox app, follow app dev documentation to build it, then push the app image to the local registry that is launched automatically in dev mode (localhost:5000). The app can then be launched normally through the dashboard.

ENV VARS

• DATABOX_DEV=1 enables dev mode
• PORT=8081 overrides default port (8989)