summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Dockerfile18
-rw-r--r--README.markdown3
-rw-r--r--docs/docker.markdown48
3 files changed, 68 insertions, 1 deletions
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 00000000..29d0e9c8
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,18 @@
+FROM ubuntu:14.04
+MAINTAINER Frederic Guillot <fred@kanboard.net>
+
+RUN apt-get update && apt-get install -y apache2 php5 php5-sqlite git && apt-get clean
+RUN echo "ServerName localhost" >> /etc/apache2/apache2.conf
+RUN cd /var/www && git clone https://github.com/fguillot/kanboard.git
+RUN rm -rf /var/www/html && mv /var/www/kanboard /var/www/html
+RUN chown -R www-data:www-data /var/www/html/data
+
+EXPOSE 80
+
+ENV APACHE_RUN_USER www-data
+ENV APACHE_RUN_GROUP www-data
+ENV APACHE_LOG_DIR /var/log/apache2
+ENV APACHE_LOCK_DIR /var/lock/apache2
+ENV APACHE_PID_FILE /var/run/apache2.pid
+
+CMD /usr/sbin/apache2ctl -D FOREGROUND
diff --git a/README.markdown b/README.markdown
index 06e4bae5..16c32a2a 100644
--- a/README.markdown
+++ b/README.markdown
@@ -105,7 +105,8 @@ Documentation
- [Command line interface](docs/cli.markdown)
- [Json-RPC API](docs/api-json-rpc.markdown)
- [Webhooks](docs/webhooks.markdown)
-- [How to use Kanboard with Vagrant](docs/vagrant.markdown)
+- [Run Kanboard with Vagrant](docs/vagrant.markdown)
+- [Run Kanboard with Docker](docs/docker.markdown)
### Contributors
diff --git a/docs/docker.markdown b/docs/docker.markdown
new file mode 100644
index 00000000..92fcf2c3
--- /dev/null
+++ b/docs/docker.markdown
@@ -0,0 +1,48 @@
+How to test Kanboard with Docker?
+=================================
+
+Kanboard can run with [Docker](https://www.docker.com).
+You can use the public image or build your own image from the `Dockerfile`.
+
+Actually, the Docker image is based on the master branch (development version).
+
+Build your own Docker image
+---------------------------
+
+From your kanboard directory run the following command:
+
+```bash
+docker build -t youruser\kanboard:master .
+```
+
+To run your image in background on the port 80:
+
+```bash
+docker run -d --name kanboard -p 80:80 -t youruser/kanboard:master
+```
+
+Run the public Kanboard image
+-----------------------------
+
+This image is stored on the [Docker Hub](https://hub.docker.com).
+
+Fetch the image on your machine:
+
+```bash
+docker pull kanboard/kanboard:master
+```
+
+Run the image:
+
+```bash
+docker run -d --name kanboard -p 80:80 -t kanboard/kanboard:master
+```
+
+Store your data on a volume
+---------------------------
+
+You can also save your data outside of the container, on the local machine:
+
+```bash
+docker run -d --name kanboard -v /your/local/data/folder:/var/www/html/data -p 80:80 -t kanboard/kanboard:master
+```