|
|
@@ -0,0 +1,98 @@
|
|
|
+:title: Installation on CRUX Linux
|
|
|
+:description: Docker installation on CRUX Linux.
|
|
|
+:keywords: crux linux, virtualization, Docker, documentation, installation
|
|
|
+
|
|
|
+.. _crux_linux:
|
|
|
+
|
|
|
+
|
|
|
+CRUX Linux
|
|
|
+==========
|
|
|
+
|
|
|
+.. include:: install_header.inc
|
|
|
+
|
|
|
+.. include:: install_unofficial.inc
|
|
|
+
|
|
|
+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``.
|
Sven Dowideit