Install appcfg

Prev Next

This document provides instructions for installing, configuring, and initializing the appcfg command-line interface (CLI) for managing Gladly applications.

Quick MacOS example

cd ~/Downloads
tar -xzvf appcfg-<version>-mac-apple.zip
chmod a+x appcfg
mv appcfg ~/.local/bin/
echo 'alias appcfg=~/.local/bin/appcfg' >> ~/.zshrc
appcfg --version

General Installation Steps for appcfg

  1. Download & Extract:

    • Get the latest appcfg release for your OS from GitHub Releases.
    • Extract the downloaded archive.
  2. Install Executable:

    • Move the appcfg executable (e.g., appcfg or appcfg.exe) to a directory in your system's PATH (like /usr/local/bin or a custom scripts folder) or a location you plan to alias.
    • On Linux/macOS: Ensure it has execute permissions (e.g., chmod +x appcfg).
  3. Make Callable:

    • If not already in a PATH directory, add the executable's location to your system's PATH environment variable or create a shell alias (e.g., alias appcfg='/path/to/appcfg').
  4. Verify:

    • Open a new terminal and run appcfg --version to confirm.
Mac Users

Due to macOS security settings (Gatekeeper), you may need to explicitly allow appcfg to run the first time.
If you get a modal similar to:
image.png
In Mac OS, go to System Settings > Privacy & Security > Approve external app in the settings:
image.png
After you approve the app, rerun appcfg --version to verify the installation.