Skip to content

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

  1. 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).
  2. Open Terminal and unpack the archive. Use the real file name:

    tar -xzf sitemanager-macOS-arm64-<version>.tar.gz
    

    The archive unpacks into one folder: sitemanager-macos-arm64, or sitemanager-macos-amd64 for the Intel version.

  3. Clear the quarantine flag once, so macOS lets you run the programs:

    xattr -dr com.apple.quarantine sitemanager-macos-arm64
    
  4. 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.

Next step

Start SiteManager for the first time.