Add Docker config file and documentation

This commit is contained in:
Frédéric Guillot 2014-10-13 19:24:09 -04:00
parent 6fdf3264aa
commit d0e6d2e1f1
3 changed files with 68 additions and 1 deletions

18
Dockerfile Normal file
View File

@ -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

View File

@ -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

48
docs/docker.markdown Normal file
View File

@ -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
```