woodpecker/doc/install-docker.md
2015-05-25 15:41:01 -07:00

1.5 KiB

An official Drone image is available in the Docker registry. This is the recommended way to install and run Drone on non-Ubuntu environments. Pull the latest Drone image to get started:

sudo docker pull drone/drone

An example command to run your Drone instance with GitHub enabled:

sudo docker run -d \
	-v /var/lib/drone:/var/lib/drone \
	-e DRONE_GITHUB_CLIENT=c0aaff74c060ff4a950d \
	-e DRONE_GITHUB_SECRET=1ac1eae5ff1b490892f5 \
	-p 80:80 --name=drone drone/drone

Persistence

When running Drone inside Docker we recommend mounting a volume for your sqlite database. This ensures the database is not lost if the container is accidentally stopped and removed. Below is an example that mounts /var/lib/drone on your host machine:

sudo docker run \
	-v /var/lib/drone:/var/lib/drone \
	--name=drone drone/drone

Configuration

When running Drone inside Docker we recommend using environment variables to configure the system. All configuration attributes in the drone.toml may also be provided as environment variables. Below demonstrates how to configure GitHub from environment variables:

sudo docker run \
	-e DRONE_GITHUB_CLIENT=c0aaff74c060ff4a950d \
	-e DRONE_GITHUB_SECRET=1ac1eae5ff1b490892f5 \
	--name=drone drone/drone

Logging

When running Drone inside Docker the logs are sent to stdout / stderr. You can view the log output by running the following command:

docker logs drone