page_title: Installation on CRUX Linux
page_description: Docker installation on CRUX Linux.
page_keywords: crux linux, virtualization, Docker, documentation, installation

# CRUX Linux

Note

Docker is still under heavy development! We don’t recommend using it in
production yet, but we’re getting closer with each release. Please see
our blog post, ["Getting to Docker
1.0"](http://blog.docker.io/2013/08/getting-to-docker-1-0/)

Note

This is a community contributed installation path. The only ‘official’
installation is using the [*Ubuntu*](../ubuntulinux/#ubuntu-linux)
installation path. This version may be out of date because it depends on
some binaries to be updated and published

Installing on CRUX Linux can be handled via the ports from [James
Mills](http://prologic.shortcircuit.net.au/):

-   [docker](https://bitbucket.org/prologic/ports/src/tip/docker/)
-   [docker-bin](https://bitbucket.org/prologic/ports/src/tip/docker-bin/)
-   [docker-git](https://bitbucket.org/prologic/ports/src/tip/docker-git/)

The `docker` port will install the latest tagged
version of Docker. The `docker-bin` port will
install the latest tagged versin of Docker from upstream built binaries.
The `docker-git` package will build from the current
master branch.

## Installation

For the time being (*until the CRUX Docker port(s) get into the official
contrib repository*) you will need to install [James
Mills’](https://bitbucket.org/prologic/ports) ports repository. You can
do so via:

Download the `httpup` file to
`/etc/ports/`:

    curl -q -o - http://crux.nu/portdb/?a=getup&q=prologic > /etc/ports/prologic.httpup

Add `prtdir /usr/ports/prologic` to
`/etc/prt-get.conf`:

    vim /etc/prt-get.conf

    # or:
    echo "prtdir /usr/ports/prologic" >> /etc/prt-get.conf

Update ports and prt-get cache:

    ports -u
    prt-get cache

To install (*and its dependencies*):

    prt-get depinst docker

Use `docker-bin` for the upstream binary or
`docker-git` to build and install from the master
branch from git.

## Kernel Requirements

To have a working **CRUX+Docker** Host you must ensure your Kernel has
the necessary modules enabled for LXC containers to function correctly
and Docker Daemon to work properly.

Please read the `README.rst`:

    prt-get readme docker

There is a `test_kernel_config.sh` script in the
above ports which you can use to test your Kernel configuration:

    cd /usr/ports/prologic/docker
    ./test_kernel_config.sh /usr/src/linux/.config

## Starting Docker

There is a rc script created for Docker. To start the Docker service:

    sudo su -
    /etc/rc.d/docker start

To start on system boot:

-   Edit `/etc/rc.conf`
-   Put `docker` into the `SERVICES=(...)`
 array after `net`.