133

How do I restart, say for example my httpd or afpd, running any Mac OS X >= 10.5 (Leopard-), without having to use the GUI and go to System Preferences -> Sharing and unchecking/checking "Web Sharing"?

I'm looking for the canonical equivalent to Debian's invoke-rc.d apache2 restart.

EDIT: The question is about launchd controlled services in general, not specifically Apache (-which was simply an example).

  • 1
    From the answers so far, is correct to assume there is no single launchctl command to restart a service? – JS. Aug 25 '16 at 20:09
  • @JS. According to the manual page, kickstart together with the -k option seems to do the trick. See my answer below ... – jochen Jan 3 at 16:08
146

Hi launchctl(8) is your friend. Just keep in mind that some of the services (sshd for example) are disabled in the configuration file so you will need to use the -w switch when loading them. Here is a sshd example:

$ sudo launchctl load -w /System/Library/LaunchDaemons/ssh.plist 

You can stop the service using the unload subcommand.

$ sudo launchctl unload  /System/Library/LaunchDaemons/ssh.plist 

To list the services, as you might have already guessed use the 'list' subcommand ;)

have fun, n

  • 8
    In addition, launchctl list does not complain but does not show everything, sudo launchctl list is needed for that. – conny Oct 26 '10 at 16:17
  • 8
    It's not that it doesn't show everything, it shows a completely different list. When you run launchctl as a normal user, it shows/manages LaunchAgents running in your user session; run as root, it shows/manages the system-wide LaunchDaemons. – Gordon Davisson Oct 26 '10 at 16:32
  • 1
    I can see "com.openssh.sshd" in that list, so I guess that config is "loaded". Now, how come for example sudo launchctl start com.openssh.sshd doesn't do anything, not evan fail with an error message, even less so actually launch anything? – conny Oct 26 '10 at 16:39
  • 2
    @conny It might be confusing in the general case, however when you are writing a service and you suspect for example that something nasty is happening on startup, you can load it once and the use 'stop'/'start' to debug the issue. – nayden Oct 28 '10 at 21:08
  • 6
    Why no mention of launchctl start <label> or launchctl stop <label>? If it's already started by launchctl there's no need to reload the plist file (unless it changed as well?). It is annoying there is no restart or reload command. Anyone know of a single-command way of making (for example) mongod pick up a config file change? I'm just not satisfied with ... stop ... && ... start .... – Brian May 18 '15 at 17:18
7

sudo launchctl load -w /System/Library/LaunchDaemons/org.apache.httpd.plist

2

You are looking for launchctl.

SYNOPSIS
 launchctl [subcommand [arguments ...]]

DESCRIPTION
 launchctl interfaces with launchd to load, unload daemons/agents and gen-
 erally control launchd.  launchctl supports taking subcommands on the
 command line, interactively or even redirected from standard input.
 These commands can be stored in $HOME/.launchd.conf or /etc/launchd.conf
 to be read at the time launchd starts.
  • 2
    But reading the man-page does not tell me what the equivalent of either invoke-rc.d my-little-daemon restart is ... It refers to "job_label" but does not tell me how to list the "job_label"s available. – conny Oct 26 '10 at 13:51
  • I think nayden's response has got this covered. – eric.s Oct 28 '10 at 13:29
2

You could simply do

sudo launchctl stop com.openssh.sshd

If you don't known the full service name, you can do

sudo launchctl list

If you still don't find the service you expected, try to run without the root identity:

launchctl list

And you don't need to unload and load service.

  • 1
    I tried this and now I can't use ssh from my Mac. Rebooting doesn't fix. Replacing stop with start also doesn't fix. – P i May 25 '17 at 8:38
  • 1
    I tried this and I still can ssh to my Mac! – Michael Oct 1 '17 at 21:57
  • @dmitriy-apollonin It does not work, you must use sudo unload /System/Library/LaunchDaemons/ssh.plist instead. – SebMa Aug 7 '18 at 9:21
  • The question is about restarting a service, but I don't think that launchctl stop does restart a service. – jochen Jan 3 at 13:50
2

Just in case if you are looking for launchctl reload, you can define shell function in your ~/.bashrc/.zshrc as I did:

function lctl {
    COMMAND=$1
    PLIST_FILE=$2
    if [ "$COMMAND" = "reload" ] && [ -n "$PLIST_FILE" ]
      then
        echo "reloading ${PLIST_FILE}.."
        launchctl unload ${PLIST_FILE}
        launchctl load ${PLIST_FILE}
      else
        echo "either command not specified or plist file is not defined"
    fi
}

Command execution looks like -> lctl reload <your-plist-name>.plist

1
sudo apachectl restart

Works with other OSses as well as it is part of Apache.

  • 1
    Even though the topic doesn't mention apache in particular, I should have anticipated this interpretation.... I'm sorry, but that was not what I was looking for :) – conny Oct 26 '10 at 13:20
  • Ok, I catched the httpd part, for which using apachectl is the easier variant :) – Sven Oct 26 '10 at 14:30
0

There is a small & useful app for this named Lingon. Lingon freeware edition is here sometimes restarting a service can be tricky.

syslog -w

reading helps though.

0

To restart a service, you can use the launchctl kickstart command, together with the -k option. For example, to restart apache, you can use

sudo launchctl kickstart -k system/org.apache.httpd

This information is from the launchctl manual page:

 kickstart [-kp] service-target
          Instructs launchd to run the specified service immediately, regardless of its
          configured launch conditions.

          -k       If the service is already running, kill the running instance before
                   restarting the service.
          [...]

Your Answer

By clicking "Post Your Answer", you acknowledge that you have read our updated terms of service, privacy policy and cookie policy, and that your continued use of the website is subject to these policies.

Not the answer you're looking for? Browse other questions tagged or ask your own question.