SiteManager on macOS
Note
The macOS download is not on the downloads page yet. It will be added as a disk image, and these steps will change with it.
SiteManager for macOS is meant for working from a laptop. It is an archive that holds the two programs. There is no installer and no service, so you start sitemanagerd yourself when you need it. Use it to run the command line against displays or against a SiteManager service on another computer, or to use the web interface on the laptop.
For a permanent installation on a wall computer, use the Windows or Linux version.
Note
The macOS programs are not signed and not notarized by Apple. macOS blocks them until you clear the quarantine flag, as described below.
Installation
- Download the archive for your Mac. The file name ends with
.tar.gz. There is one for Apple silicon (arm64) and one for Intel (x86_64). -
Open Terminal and unpack the archive. Use the real file name:
tar -xzf sitemanager-macOS-arm64-<version>.tar.gzThe archive unpacks into one folder:
sitemanager-macos-arm64, orsitemanager-macos-amd64for the Intel version. -
Clear the quarantine flag once, so macOS lets you run the programs:
xattr -dr com.apple.quarantine sitemanager-macos-arm64 -
Go into the folder:
cd sitemanager-macos-arm64
Upgrade every SiteManager on a site first
Securing a display locks out older SiteManager versions, SiteManager 2.x and other tools until it is released. Upgrade every SiteManager on a site before securing displays. See Secure your displays.
Running the service
./sitemanagerd --state-dir ~/sitemanager-state
The service runs until you stop it with Control-C or close the Terminal window. Use the same --state-dir every time, so it finds your site again. If you leave --state-dir out, it uses a folder named sitemanager-state in the folder you start it from.
Without a --listen option the service runs in local mode. Open http://127.0.0.1:8790/ in a browser on this Mac. There is no setup and no login. Then continue with First start. Add other options on the command line. They are listed in sitemanagerd reference.
Opening SiteManager to the network
To let other computers connect, start the service with --listen :8790:
./sitemanagerd --state-dir ~/sitemanager-state --listen :8790
macOS asks whether to allow incoming connections. The service then runs in network mode: HTTPS, a setup token, logins and API tokens. On the first start in network mode it prints the first-run setup token in its output. You can also print the token and the certificate fingerprint:
./sitemanagerd --state-dir ~/sitemanager-state --print-setup-token
./sitemanagerd --state-dir ~/sitemanager-state --print-fingerprint
Then continue with Opening SiteManager to the network.
On macOS the service writes the Cornerstone files of the user who runs it, under ~/Library. The idle-wall check cannot read the touch traffic on macOS, so it answers "unknown" and jobs that need it ask you for confirmation.
Running the command line
The sitemanager program is in the same folder. While sitemanagerd runs in local mode on this Mac, the command line finds it and needs no login.
To use it against a SiteManager service on another computer, which must be in network mode, store the service address and an API token once:
echo "$TOKEN" | ./sitemanager login --server https://wallpc:8790 --fingerprint AA:BB:... --token -
See The command line for how this works and for direct mode, which needs no service.
Uninstalling SiteManager
Stop the service, then delete the folder you unpacked and, if you no longer need them, the state directory (~/sitemanager-state in the examples) and the folder ~/Library/Application Support/sitemanager, which holds a command-line login if you made one.