---
title: "Install appcfg"
slug: "install-appcfg"
updated: 2025-09-09T14:06:07Z
published: 2025-09-09T14:06:07Z
canonical: "help.gladly.com/install-appcfg"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gladly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install appcfg

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

### Linux / Windows Susbystem for Linux Installation

Download the latest version of appcfg for your architecture and OS from [https://github.com/gladly/app-platform-appcfg-cli/releases/latest](https://github.com/gladly/app-platform-appcfg-cli/releases/latest)

unzip the downloaded file, and move it to `~/.local/bin`: `mv appcfg-<version>-linux-intel -r ~/.local/bin`

for convenience, add an alias for appcfg: `echo 'alias appcfg=~/.local/bin/appcfg' >> ~/.bashrc`

reload your .bashrc to pick up the alias: `source ~/.bashrc`

test that you are able to execute appcfg: `appcfg --version`

### Windows Installation

Download the latest version of appcfg for your architecture and OS from [https://github.com/gladly/app-platform-appcfg-cli/releases/latest](https://github.com/gladly/app-platform-appcfg-cli/releases/latest)

[Install PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.5) if it is not already installed. PowerShell is required for autocompletion in appcfg under Windows. If you are unfamiliar with PowerShell, or run into issues with your profile, [this documentation](https://learn.microsoft.com/en-us/powershell/scripting/learn/shell/creating-profiles?view=powershell-7.5) is a good reference.

In PowerShell, create a directory for appcfg: `mkdir ~/.local/bin`

Unzip the appcfg download to ~/.local/bin: `Expand-Archive -Path "~\Downloads\appcfg-4.1.1-win.zip" -DestinationPath "~\.local\bin"`

For convenience, create an alias for appcfg: `Test-Path $PROFILE` if `FALSE` is returned, create a profile file using: `New-Item -ItemType File -Path $PROFILE -Force`

open the profile file in notepad: `notepad $PROFILE`

add the following to set the alias: `Set-Alias -Name appcfg ~\.local\bin\appcfg`

save your changes in notepad; reload your profile to apply the alias: `. $PROFILE`

Test the alias by getting the appcfg version: `appcfg --version`

### macOS Installation

Download the latest version of appcfg for your architecture and OS from [https://github.com/gladly/app-platform-appcfg-cli/releases/latest](https://github.com/gladly/app-platform-appcfg-cli/releases/latest)

Unzip appcfg: `cd ~/Downloads` `tar -xzvf appcfg-<version>-mac-apple.zip`

Move appcfg to a directory, and make it executable: `mv appcfg ~/.local/bin/` `chmod a+x ~/.local/bin/appcfg`

For convenience, create an alias for appcfg: `echo 'alias appcfg=~/.local/bin/appcfg' >> ~/.zshrc`

Test the alias by getting the appcfg version: `appcfg --version`

          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](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/image%28137%29.png?sv=2026-02-06&spr=https&st=2026-10-31T12%3A43%3A22Z&se=2026-10-31T13%3A43%3A22Z&sr=c&sp=r&sig=6krpGAUppKD9W1MR1Zdb6IU4Q1XbwmeR05mZ3yKYJHE%3D) In Mac OS, go to System Settings > Privacy & Security > Approve external app in the settings: ![image.png](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/image%28138%29.png?sv=2026-02-06&spr=https&st=2026-10-31T12%3A43%3A22Z&se=2026-10-31T13%3A43%3A22Z&sr=c&sp=r&sig=6krpGAUppKD9W1MR1Zdb6IU4Q1XbwmeR05mZ3yKYJHE%3D) After you approve the app, rerun `appcfg --version` to verify the installation.