github.com/jenkinsci/docker ↗

About jenkinsci/docker

The Official Jenkins Docker image provides a fully functional Jenkins Continuous Integration and Delivery server packaged for Docker containers and available on Docker Hub. It allows users to quickly deploy Jenkins in containerized environments without needing to manage installation complexity.

The image stores all Jenkins data, configuration, and plugins in the `/var/jenkins_home` directory, which can be managed through Docker volumes for persistence across container restarts and upgrades. The project provides comprehensive documentation on key operational concerns including volume management, JVM parameter configuration, logging setup, and plugin installation. Users can customize the image by extending it with a Dockerfile to install additional tools, configure executors, set environment variables, or add custom plugins using the jenkins-plugin-cli tool.

The repository includes support for agent connections through port 50000 for inbound TCP connections, JVM customization via environment variables, environment variable substitution in configuration files, and detailed upgrade procedures. It offers multiple deployment options including Docker Compose examples and provides guidance on DNS configuration, backing up data, and managing plugin upgrades with options to force upgrades or update existing plugins without markers.