Due to some maintenance issues, this service has been switched in read-only mode, you can find more information about the why

and how to migrate your plugin documentation in this blogpost

Skip to end of metadata
Go to start of metadata

This page is a landing page for those who have installed Jenkins via its OS X installer

The installer sets up Jenkins as a launch daemon, listening on port 8080. (If you want to know more about launchd and daemons, see here and here.)

Changing boot configuration

The launch daemon picks up the command line options from a standard preferences file, /Library/Preferences/org.jenkins-ci.plist. If the file does not exist, built-in defaults are used. The preference files are manipulated using the standard utility defaults.

  • To view all settings in the file, run: defaults read /Library/Preferences/org.jenkins-ci
  • To get the value of a single setting, run: defaults read /Library/Preferences/org.jenkins-ci SETTING
  • To set the value of a setting, run: sudo defaults write /Library/Preferences/org.jenkins-ci SETTING VALUE
  • For more information, see man defaults

See Starting and Accessing Jenkins for various command line options that Jenkins support.

Supported Settings

The list of settings supported by the Jenkins launch daemon (see documentation):

  • prefix
  • httpPort
  • httpListenAddress
  • httpsPort
  • httpsListenAddress
  • ajp13Port
  • ajp13ListenAddress

Additionally, you can set also these:

  • war (Full path name to jenkins.war file.)
  • heapSize (Passed to java command-line -Xmx parameter.)
  • permGen (Passed to java command-line -XX:MaxPermSize parameter.) (SINCE 1.455?)
  • JENKINS_HOME (Full path to JENKINS_HOME directory where Jenkins keeps its files)

Starting/stopping the service

  • To manually start the daemon: sudo launchctl load /Library/LaunchDaemons/org.jenkins-ci.plist
  • To manually stop the daemon: sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist

Inheriting your existing Hudson/Jenkins installation

If you'd like your new installation to take over your existing Jenkins/Hudson data, copy your old data directory into the new JENKINS_HOME directory.

Java and OS X 10.9 Mavericks or 10.10 Yosemite

Oracle Java 8 on Mavericks or Yosemite needs Apple's Java 1.6 to function. However, all of the symlinks in /usr/bin point to Java 1.6, so when a Jenkins tries to run via /Library/Application Support/Jenkins/jenkins-runner.sh, it launches using Java 1.6. To run under Java 8, you need to do the following: 

  1. Install Apple's Java from http://support.apple.com/kb/DL1572
  2. Install Oracle Java 8
  3. Edit jenkins-runner.sh: 
    1. Add the line: 
      export JAVA_HOME="/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home"
    2. Change the last two lines to read: 
      echo "/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/bin/java" $javaArgs -jar "$war" $args
      exec "/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/bin/java" $javaArgs -jar "$war" $args

Jenkins will now run using Java 8. 

Uninstall Jenkins

To uninstall Jenkins service from your Mac OS X computer, execute uninstall script from terminal:

'/Library/Application Support/Jenkins/Uninstall.command'
  • No labels


  1. Unknown User (ihassin)

    Starting and stopping under Mountain Lion and the 1.496 installer is done via:

    • sudo launchctl unload -w /Library/LaunchDaemons/org.jenkins-ci.plist
    • sudo launchctl load -w /Library/LaunchDaemons/org.jenkins-ci.plist
  2. Unknown User (ihassin)

    After using the installer, you must create ssh keys for the shared user it created in order to use private git repos that use them.

    To do this, I:

    1. Logged in to the shared account
    2. Created the keys using the ssh-keygen -t rsa command.
    3. Uploaded the public key to my repo
    4. While in the new account, opened terminal and issued a git-ls command to get the 'add host' prompt for the first time.
    5. Logged out of the Jenkins account and returned to define the build task using the Jenkins Web.
    All worked from that point on...

  3. Unknown User (maz)


    3) where exactly do you upload the key to? What file do you upload?

    4) where in the filesystem should one do 'git-ls'? While inside a repo/git dir?

    5) Provide more details on how you did this step?



  4. Unknown User (ndistefano)

    To have jenkins start launchd on login: 

    ln -sfv /usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents

  5. Unknown User (helsing)

    For your information: The initial 'admin' password is found in this file '/Users/Shared/Jenkins/Home/secrets/initialAdminPassword'

  6. Unknown User (skillsplanet)

    Jenkins failed to start on Sierra.  Installing the JDK 9.0.1, then stopping, then re-starting the service worked!

    Reference: JENKINS-38660  Jenkins does not start on macOS 10.12 Sierra