Docker and YunoHost

Here is a small memo-documentation page on how to test/develop YunoHost with Docker.

Find other ways to install YunoHost here.

Install Docker

Pre-requisite : A x86 computer under Ubuntu 12.04 (or above), or ArchLinux.

Under Ubuntu :

# 12.04 only
sudo apt-get update
sudo apt-get install linux-image-generic-lts-raring linux-headers-generic-lts-raring
sudo reboot

# In every cases
curl -s https://get.docker.io/ubuntu/ | sudo sh

Under ArchLinux :

sudo pacman -Sy docker

Note: You may have to start Docker's daemon manually (as root: service docker start, systemctl start docker or simply docker -d)

Build the YunoHost container

The following command will fetch a Debian Wheezy base image, clone the YunoHost's install script in it, and run it.

docker build -t yunohost:init https://raw.githubusercontent.com/YunoHost/Kremlin/master/docker/Dockerfile

You can check that the container is successfully built with the docker images command.

Run the container

docker run -d -t yunohost:init /sbin/init

This command will start a container based on the yunohost image (tag init) that you just created.
You will then be able to postinstall all this by entering the container's IP address (172.17.0.2 by default) into a web browser.

Notice: You may want to forward some of your container's ports, find more information or these pages:

Advanced usage

Some useful commands:

Snapshot container's state

docker commit <container_ID> yunohost:TheTagIWant
# Example : docker commit 3e85317430db yunohost:03052014

Assign an IP to a container

# You will need iptables, and to activate IP forwarding on your system
iptables -t nat -A PREROUTING -d <IP.to.assign> -j DNAT --to-destination <container.IP>
iptables -t nat -A POSTROUTING -s '<container.IP>/32' -o eth0 -j SNAT --to-source <IP.to.assign>
# Be careful on the network interface (here eth0)

Log in a YunoHost running container

# You will need:
# * your container's ID
docker ps --no-trunc | grep yunohost
# * your container's PID
docker ps -q | xargs docker inspect --format '{{.State.Pid}}'
# * `util-linux` package
apt-get install util-linux || pacman -S util-linux

# Run the nsenter command with the right parameters
nsenter --target <PID> --mount --uts --ipc --net --pid /bin/bash

# Otherwise, with docker
docker run -t -i yunohost:init /bin/bash

2.6 KiB Raw Blame History