Skip to content

jenkinsci/remoting

Repository files navigation

Jenkins Remoting layer

GitHub release Join the chat at https://gitter.im/jenkinsci/remoting

Jenkins remoting is an executable JAR, which implements communication layer in Jenkins automation server. It's being used for controller <=> agent and controller <=> CLI communications.

In general, this library contains the bootstrap code to bridge separate JVMs into a single semi-shared space. It includes: TCP-based communication protocols, data serialization, Java classloading.

The library is reusable outside Jenkins.

Downloads

Jenkins Remoting libraries are supplied as a part of the Jenkins distributions, and it is recommended to use versions from there to ensure compatibility with your Jenkins instance. You can download the ${JENKINS_URL}/jnlpJars/agent.jar from your Jenkins server. If you need a specific Remoting version, it can be downloaded from the Jenkins artifact repository. Recent artifacts are available here.

For usage in Docker, the Jenkins project also provides official agent images which bundle Remoting: jenkins/agent and jenkins/inbound-agent. We recommend using and extending these images if you need to run agents in Docker.

Documentation

Remoting documentation is under development. More info will appear soon. Feel free to contribute.

User documentation:

Previous versions:

Developer documentation:

Reporting issues

Remoting library uses the Jenkins bugtracker. Issues should be reported there in the JENKINS project with the remoting component.

See How to report an issue for more details about Jenkins issue reporting.

More info