Skip to content

Home

Jump to bottom
Oleksandr Motsak edited this page Oct 5, 2016 · 4 revisions

Welcome to the Hilbert::Docker-Images wiki!

Recent documentation is in README.md

Sorry the following is a bit outdated

Getting Started with individual image development using Hilbert::Docker-Images:

  • Get a clean repository: git clone https://github.com/hilbert/hilbert-docker-images.git
  • Choose necessary images according to the main readme (e.g. kivy, kiosk, chrome, iceweasel)
  • for each of them do:
  • cd into corresponding image-sub-directory of your checkout and run make pull (in case of custom changes use make build after pulling parent image)

Howto Run/Test images:

Preparation

It is strongly recommended to add your user into the following groups: video, audio, docker, input.

For example with

gpasswd -a `whoami` video && gpasswd -a `whoami` audio && gpasswd -a `whoami` docker && gpasswd -a `whoami` input

Customization

Two ways:

  • choose LIBGL CUSTOMIZATION from the main menu, or
  • cd into /dummy sub-directory of your checkout and run make check

Note: be prepared to choose which one of your ALSA-card devices has to be the default one.

Currently customization creates /tmp/OGL.tgz with some pre-configuration and OpenGL-related things depending on your currently loaded kernel modules for GPU.

Note: you may store OGL.tgz locally and copy it into /tmp/ in order to avoid running this step more than once (e.g. if rebooting you system cleans /tmp/).

Note: in what follows it will be assumed that you have already customized for you host system

make check (for chosen image)

  • pull or build the image
  • cd into corresponding sub-directory of your checkout
  • run make check.

Note: it is often easily possible to change what is executed inside image by changing make variables CMD or ARGS etc. Please read the corresponding Makefile for details in each individual case.

Run :demo

  • Pull or build :demo in addition to all the images you are planning to use for demonstration
  • cd into /demo sub-directory of your checkout
  • run make check

Note: it will be assumes that you have already set all necessary settings beforehand

Docker problem with PTMX:

Please either start :ptmx service with a wrokaround or follow https://github.com/hilbert/hilbert-docker-images#x11-would-not-create-a-new-terminal-with-the-following-error-message

Clone this wiki locally