contrib/docker
2014-02-28 22:14:59 +10:00
..
.footprint Added docker (NEW): Pack, ship and run any application as a lightweight container 2014-02-12 01:24:08 +10:00
.md5sum docker: Added some missing kernel modules to test script 2014-02-28 00:57:29 +10:00
.nostrip Added docker (NEW): Pack, ship and run any application as a lightweight container 2014-02-12 01:24:08 +10:00
docker.conf Added docker (NEW): Pack, ship and run any application as a lightweight container 2014-02-12 01:24:08 +10:00
docker.rc docker: 0.8.0 -> 0.8.1 2014-02-28 00:27:10 +10:00
Pkgfile docker: Added some missing kernel modules to test script 2014-02-28 00:57:29 +10:00
post-install Added docker (NEW): Pack, ship and run any application as a lightweight container 2014-02-12 01:24:08 +10:00
README Added docker (NEW): Pack, ship and run any application as a lightweight container 2014-02-12 01:24:08 +10:00
test_kernel_config.sh docker: Added missing CONFIG_IP_NF_FILTER to test_kernel_config.sh script 2014-02-28 22:14:59 +10:00

Kernel Requirements
===================


If you want to have a full working CRUX+Docker system you will need to rebuild your kernel with the following options enabled:

Networking:

- CONFIG_BRIDGE
- CONFIG_NETFILTER_XT_MATCH_ADDRTYPE
- CONFIG_NF_NAT
- CONFIG_NF_NAT_IPV4
- CONFIG_NF_NAT_NEEDED

LVM:

- CONFIG_BLK_DEV_DM
- CONFIG_DM_THIN_PROVISIONING
- CONFIG_EXT4_FS

Namespaces:
- CONFIG_NAMESPACES
- CONFIG_UTS_NS
- CONFIG_IPC_NS
- CONFIG_UID_NS
- CONFIG_PID_NS
- CONFIG_NET_NS

Cgroups:

- CONFIG_CGROUPS

Cgroups Controllers (*optional but highly recommended*):

- CONFIG_CGROUP_CPUACCT
- CONFIG_BLK_CGROUP
- CONFIG_MEMCG
- CONFIG_MEMCG_SWAP

You may check your kernel configuration by running the provided ``test_kernel_config.sh`` script against your kernel configuration:

::
    
    ./test_kernel_config.sh /usr/src/linux/.config
         

Other Requirements
==================


You **must** have the following ``cgroup`` mount point mounted:

::
    
    none               /cgroup       cgroup    defaults               0      0
    

Storage Backends
================

Docker comes with three main Storage Backends:

- AUFS (*requires AUFS kernel/patches*)
- devmapper
- btrfs

It is recommended you use the devmapper or btrfs backend (Default: devmapper).

To use the ``btrfs`` backend edit ``/etc/docker.conf`` and modify the ``DOCKER_OPTS`` with:

::
    
    DOCKER_OPTS="-s btrfs"
    

Docker Client
=============

The provided Docker rc script changes the group ownership of the ``/var/run/socker.sock`` UNIX Socket to ``docker``.

Add yourself to this group if you wish to access the Docker daemon on localhost via UNIX Socker.