Skip to content

wakaru44/my_dockerplace

Repository files navigation

My Docker Place

My Dockerplace is a simple UI to control your Docker containers (locally).

It's in early alpha development, as a sort of "experiment" with docker.

It's a simple web, that runs locally backed by python. You start from a simple "desktop":

An example of the desktop, with your docker services on display

And see the output on the web

An example (with fake data) of how the output would look like

There are some alternatives on the market, like 'docker compose ui', which does a pretty good job, and other interesting things like 'shipyard','lorry,io', etc... that we will explore shortly.

TL;DR - Quickstart

You will need Python >2.7 clone the repo

git clone https://github.com/wakaru44/my_dockerplace.git
cd my_dockerplace

customize your docker home folder (where your containers live)

vim settings.py

install dependencies and run the app. To install with your "system" python:

make install-global && make run

To install with virtualenv (you will need it set up)

make install && make run

Requirements

All your docker services must reside under a single folder. This folder will be scanned for services. Inside this folder, you must place a Makefile. The app will read it to find the tasks you can perform on that service.

Configuration

Change the folder in settings.py to the one in your machine.

Installing a link in the desktop

To install an icon in your system, you can use the existing template.

  • Copy the file in files/my_dockerplace.desktop to your desktop (usually on ~/Desktop)

  • Edit the file ~/Desktop/my_dockerplace.desktop and change {{app_home}} with the absolute path to your "my dockerplace" setup.

  • Edit the file run.sh in this folder and change APP_HOME variable to point to your "my dockerplace" setup.

  • Change the permissions to make that link executable

    chmod +x ~/Desktop/my_dockerplace.desktop

  • and you should see a link on it

Running

There are tasks ready in a Makefile. Just run

make

to see the available tasks.

Improvements:

  • do some previous validation of the destination folder, docker setup.

  • allow the app to shut down itself

  • add a link to the start menu/the system apps. Automatically (not with manual steps in README).

  • Ensure compat with virtualenv, and avoid sudo in the pip install

  • Move the "DEBUG" switch to the environment, instead of the config file

  • Ease the creation of new apps, and downloading apps from the marketplace

About

A centraliced web interface for your local docker containers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published