Configuration
Full reference for configuring the GetMac GitLab Executor.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
GETMAC_CLOUD_API_KEY | Yes | — | Your GetMac API key |
GETMAC_CLOUD_PROJECT_ID | Yes | — | Your GetMac project ID |
GETMAC_CLOUD_API_URL | Yes | https://api.getmac.io/v1 | GetMac API endpoint |
GETMAC_CLOUD_MACHINE_IMAGE | No | macos-sequoia | VM operating system image |
GETMAC_CLOUD_MACHINE_TYPE | No | mac-m4-c4-m8 | Hardware specification |
GETMAC_CLOUD_REGION | No | eu-central-ltu-1 | Geographic region |
GETMAC_CLOUD_SSH_PRIVATE_KEY_PATH | No | $HOME/.ssh/id_rsa | Path to SSH private key |
GETMAC_CLOUD_DEBUG | No | — | Enable debug logging |
Machine Images
| Image | macOS Version | Description |
|---|---|---|
macos-sonoma | macOS 14 (Sonoma) | Stable release |
macos-sequoia | macOS 15 (Sequoia) | Stable release (default) |
macos-tahoe | macOS 26 (Tahoe) | Latest stable release |
macos-tahoe-beta | macOS 26 (Tahoe Beta) | Beta release |
See Runner Images — Installed Tools for details on what's pre-installed on each image.
Machine Types
| Type | CPU | Memory |
|---|---|---|
mac-m4-c4-m8 | 4 cores (Apple M4) | 8 GB |
Regions
| Region | Location |
|---|---|
eu-central-ltu-1 | Europe (Lithuania) |
SSH Key Configuration
By default the executor uses $HOME/.ssh/id_rsa as the SSH private key. Override this by setting GETMAC_CLOUD_SSH_PRIVATE_KEY_PATH:
export GETMAC_CLOUD_SSH_PRIVATE_KEY_PATH="/path/to/your/key"
Debug Mode
Enable verbose logging by setting the GETMAC_CLOUD_DEBUG environment variable:
export GETMAC_CLOUD_DEBUG=true