Drone ships as a single binary file and is distributed as a minimalist 20 MB Docker image. Download the official Drone image from DockerHub:
sudo docker pull teaci/drone:0.4.2.5
For a full list of available tags, see the teaci/drone Docker Hub repo.
/etc/drone/dronerc file to store configuration variables in
KEY=VALUE format. Docker will use this file to load environment variables from disk. Please note these variables should never be quoted. For example:
We’ll be adding to this file as we progress through the setup process.
Select and Configure a Remote Driver
Select and Configure a Database
Now that you have configured your Remote Driver, you are ready to set up the Database that Drone will use for storing state. See the Databases article for a walkthrough.
Create and Run a Drone Container
Create and run your container:
sudo docker run \ --volume /var/lib/drone:/var/lib/drone \ --volume /var/run/docker.sock:/var/run/docker.sock \ --env-file /etc/drone/dronerc \ --restart=always \ --publish=80:8000 \ --detach=true \ --name=drone \ teaci/drone:0.4.2.5
Please note configuration parameters are provided to Docker using the
--env-file flag. Any changes to the
dronerc file require you to stop, remove and re-create the container:
sudo docker stop drone sudo docker rm drone sudo docker run ...
At this point, you should have a running Drone instance. If you are running into issues, read the following Troubleshooting and Common Errors sections. If that fails, see Getting Help.
Assuming everything went well, you are ready to look at our Usage documentation and get some builds going.
- For a full list of configuration options for Drone itself, see Settings Reference.
- If your Drone instance needs to go through a proxy server, see Network Proxy.
- If you’d like to park Drone behind a reverse proxy, see Reverse Proxy.
Please use the Drone logs troubleshoot issues:
sudo docker logs drone
For more verbose logging add
DEBUG to your
The below error indicates you did not setup your GitHub (or GitLab, Gogs, Bitbucket) integration prior to starting Drone. Please configure version control integration per the above installation instructions.
FATA unknown remote driver
The below error indicates you forgot to run Drone with
--volume /var/lib/drone:/var/lib/drone per the above installation guide. This is important because you need to mount your database on the host machine.
INFO using database driver sqlite3 INFO using database config /var/lib/drone/drone.sqlite ERRO unable to open database file FATA migration failed