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
-
Download & Extract:
- Get the latest
appcfg
release for your OS from GitHub Releases. - Extract the downloaded archive.
- Get the latest
-
Install Executable:
- Move the
appcfg
executable (e.g.,appcfg
orappcfg.exe
) to a directory in your system'sPATH
(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
).
- Move the
-
Make Callable:
- If not already in a
PATH
directory, add the executable's location to your system'sPATH
environment variable or create a shell alias (e.g.,alias appcfg='/path/to/appcfg'
).
- If not already in a
-
Verify:
- Open a new terminal and run
appcfg --version
to confirm.
- Open a new terminal and run
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:
In Mac OS, go to System Settings > Privacy & Security > Approve external app in the settings:
After you approve the app, rerun appcfg --version
to verify the installation.