# Installing on Mac OS X

The easiest way to get cjdns is to use [brew](http://brew.sh/). To get the latest brew formulae run this command from your terminal:

`brew update`

Then you should be able to install cjdns with by running:

`brew install cjdns`

After which you should have a cjdroute binary available at `/usr/local/Cellar/cjdns/<version>/bin/cjdroute`. Usually brew will link the binary to your `/usr/local/bin directory`, to make it available in your `$PATH`.

# Running CJDNS as launchd daemon  
To keep cjdns running in background and to start it automatically when your Mac turns on, it is possible to create a launchd daemon.

First of all we need to create a script that will be called by launchd and run cjdroute with the specific configuration. This file will contain the path of your configuration, for this example I will assume that your settings are stored in `/etc/cjdroute.conf`. It is vital that the service will NOT run in background, so remember to edit the end of the configuration to have something similar to this:

```json
...

    // If set to non-zero, cjdns will not fork to the background.
    // Recommended for use in conjunction with "logTo":"stdout".
    "noBackground": 1
}
```

Create or/and edit the file `/usr/local/bin/cjdroute_start` with the following content:

```bash
#!/bin/bash
# You can use custom path or enable sleeping time to delay the process
/usr/local/bin/cjdroute < /etc/cjdroute.conf
```

Now that the script is created, we need to write the instructions for launchd. Create the file `/Library/LaunchDaemons/com.cjdns.cjdroute.plist` using administrator permissions (`sudo nano ...`) and insert the following content in it:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
    "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
        <string>com.cjdns.cjdroute</string>
    <key>Program</key>
        <string>/usr/local/bin/cjdroute_start</string>
    <key>RunAtLoad</key>
        <true/>
    <key>KeepAlive</key>
        <true/>
    <key>StandardOutPath</key>
        <string>/Library/Logs/CJDNS.log</string>
    <key>StandardErrorPath</key>
        <string>/Library/Logs/CJDNS-Errors.log</string>
</dict>
</plist>
```

This will keep our process alive and run it at the startup. At this point we just need to set the right permissions and load the daemon in the configuration by running the following commands in a termianl:

```bash
sudo chmod +x /usr/local/bin/cjdroute_start # Execution
sudo sudo launchctl load /Library/LaunchDaemons/com.cjdns.cjdroute.plist 
```

If everything is correct, you can now restart your Mac and it will automatically run cjdns. If you want to avoid the reboot, you can start the daemon using the following command:

```bash
sudo launchctl start com.cjdns.cjdroute # To start without rebooting
```

Enjoy!


# What if I get the error message Failed to make function call ?

```
<vik> on macos sierra I am not able to start cjdroute
<vik> 1488788811 INFO Configurator.c:427 Creating new ETHInterface [en0]
<vik> 1488788816 CRITICAL Configurator.c:97 Failed to make function call [Timed out waiting for a response], error: [ETHInterface_new]
<vik> How do I debug this problem ?
<cjd> are you starting it as root ?
<vik> No
<cjd> that would be the cause
<vik> Tx .. starting with sudo fixed it ..
```
