Troubleshooting

A DNS name won't open (NXDOMAIN / "can't find server")

  • Make sure a default DNS domain is set and starred in Settings → Apple, and that you clicked Restart Services.
  • Only containers created after that resolve — recreate older ones with Assign / Change DNS Name… on the container.
  • macOS may have cached the old negative result. Flush it:
Terminal
dscacheutil -flushcache

The container's IP always works regardless — Gantry's open-in-browser uses it. See Local DNS names.

apple/container containers don't appear

The background services must be running. Start them from the menu-bar strip or Settings → Apple. If the CLI is missing or outdated, Gantry's setup prompt links to the official installer.

The menu-bar panel is empty

It only lists connected hosts. Check the host's status dot in the sidebar; if it failed, open the host and retry the connection.

An SSH host won't connect

  • Confirm you can ssh to it from Terminal with the same credentials.
  • If the key has a passphrase, choose Key file auth and let Gantry store it in the Keychain.
  • Use the host's Reconnect action after fixing credentials.

"Gantry is damaged" or won't open

The build isn't notarized yet. Clear the quarantine flag:

Terminal
xattr -dr com.apple.quarantine /Applications/Gantry.app

Still stuck? Open an issue on GitHub.