humanmade / humanmade/Cavalcade-Runner

Mac OS launchctl config

Open
#49 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
PHP
Stars
56
Forks
27
PR merge metrics
No merged PRs in 30d

Description

This isn't so much an issue as something that I wanted to share for the benefit of others.

I set up Cavalcade for a local site (which is powered by [Valet+](https://github.com/weprovide/valet-plus)), and I wanted to have Cavalcade automatically launch using the native Mac OS `launchctl` system.

Here's the config file I ended up using, with specifics replaced:

```xml


Label
some-site.cavalcade

ProgramArguments

bash
-lc


~/projects/Cavalcade-Runner/bin/cavalcade /path/to/wp/site

RunAtLoad


StandardOutPath
/usr/local/var/log/cavalcade.log

StandardErrorPath
/usr/local/var/log/cavalcade_error.log

```

This file is placed into my `~/Library/LaunchAgents/` directory with a `.plist` extension. For consistency, I've matched the file name with the Label `some-site.cavalcade` above. To load get this running, I then do this:

```
launchctl load -w ~/Library/LaunchAgents/some-site.cavalcade.plist
```

Contributor guide

No contributing guide indexed for this repository

Research direction

Review the macOS launchctl plist and launchctl load command included in the issue, then inspect the repository's existing documentation for the appropriate place to describe local Cavalcade setup. Done should mean the configuration and loading steps are documented accurately for a local site.

Written by the indexing model from the issue text.

Assessment

Tech stack
bash, macos
Domain
devops, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.