Skip to main content
Jamf Nation, hosted by Jamf, is the largest Apple IT management community in the world. Dialog with your fellow IT professionals, gain insight about Apple device deployments, share best practices and bounce ideas off each other. Join the conversation.

Uninstalling a JDS Instance

Disclaimer: This article is no longer being updated. The Jamf Distribution Server was discontinued at the end of 2017.

Overview

This article explains how to uninstall a Jamf Distribution Server (JDS) instance.

Procedure

  1. (Mac only) Execute the following command to stop the JDS launch daemon:
    sudo launchctl unload /Library/LaunchDaemons/com.jamfsoftware.jamfdspolicy.plist
  2. Create a backup of the Apache configuration file stored in the following location:
    • Mac: /Library/Server/Web/Config/apache2/sites/0000_any_443_.conf Note: If you manually configured the JDS instance on a server with macOS Server 5.0.x installed, the Apache configuration file is stored in the following location: /Library/Server/Web/Config/apache2/sites/0000_127.0.0.1_34543_.conf For more information, see the Troubleshooting Jamf Distribution Server (JDS) Issues on Computers with macOS Server 5.0.x Installed Knowledge Base article.
    • Ubuntu: /etc/apache2/sites-enabled/default-ssl
    • RHEL: /etc/httpd/conf.d/ssl.conf
  3. Execute the following command to replace the Apache configuration file with the backup that the JDS Installer created during installation:
    • Mac:
      sudo cp /Library/JDS/conf/.0000_any_443_.conf /Library/Server/Web/Config/apache2/sites/0000_any_443_.conf
      Note: If you manually configured the JDS instance on a server with macOS Server 5.0.x installed, you will need to use the backup you created during the manual configuration process. For more information, see the Troubleshooting Jamf Distribution Server (JDS) Issues on Computers with macOS Server v5.0.x Installed Knowledge Base article.
    • Ubuntu:
      sudo cp /usr/local/jds/conf/.default-ssl /etc/apache2/sites-enabled/default-ssl
    • RHEL:
      sudo cp /usr/local/jds/conf/.ssl.conf /etc/httpd/conf.d/ssl.conf
  4. Execute the following commands to remove the jamfds binary and associated files:
    • Mac:
      sudo rm -r /Library/JDS
      sudo rm /Library/LaunchDaemons/com.jamfsoftware.jamfdspolicy.plist
      For the Casper Suite v9.8 or later:
      sudo rm /usr/local/bin/jamfds
      For the Casper Suite v9.73 or earlier:
      sudo rm /usr/sbin/jamfds
    • Ubuntu and RHEL:
      sudo rm -r /usr/local/jds
      sudo rm /usr/local/sbin/jamfds
Like Comment
Order by:
SOLVED Posted: by luispalumbo

Hi Erin,
I've installed two instances of JDS on my server, one on the same server and another one on a Linux server. Both as a test.
After uninstalling them following your instructions above, they are still available on my JSS Summary. If I want to start a new JDS instance, how can I remove these ones from there?

Thanks,
Luis Palumbo

Like
SOLVED Posted: by matt.jamison

You forgot to include deleting the cron job in Linux.

Like
SOLVED Posted: by matt.jamison

@luispalumbo You need to go into JSS, click on each JDS server registered and click Delete next to the Edit button. This removes them from JSS.

Like
SOLVED Posted: by debbie.campbell

Updated to add steps for removing the crontabs (Ubuntu and RHEL) and deleting the JDS instance from the JSS.

Like
SOLVED Posted: by biomarin
Updated to add steps for removing the crontabs (Ubuntu and RHEL) and deleting the JDS instance from the JSS.

I don't see these updates.

Like
SOLVED Posted: by benducklow

@erin.miska - Like @matt.jamison stated in his post above, shouldn't step 1 be removing the JDS instance from with the JSS > Settings > Computer Management > JDS Instances then doing the cleanup from the server-side (the steps you have listed)?

Like
SOLVED Posted: by pmcgurn

This guide is missing a step. Part of the Linux install modified cron to run the jamfds binary every 5 minutes. Removal of that step should be documented.

Like
SOLVED Posted: by charliwest

For those wondering what the linux step is, most likely as the user you installed it all as run crontab -e and remove the jds line from the file.

Like

Jamf wants to hear your feedback around Jamf Pro: LDAP Servers and Reports!