Defang is a radically simpler way for developers to create, deploy, and manage cloud applications.
This repo includes:
- Public releases of the Defang CLI; click here for the latest version
- Samples in Golang, Python, and Node.js that show how to accomplish various tasks and deploy them to the DOP using a Docker Compose file using the Defang CLI.
- Samples that show how to deploy an app using the Defang Pulumi Provider.
- Read our Getting Started page
- Follow the installation instructions from the Installing page
- Take a look at our Samples folder for example projects in various programming languages.
- Try the AI integration by running
defang generate
- Start your new service with
defang compose up
Install the Defang CLI from one of the following sources:
- Using the Homebrew package manager defang-io/defang tap:
brew install defang-io/defang/defang
- Using a shell script:
. <(curl -s https://raw.githubusercontent.com/defang-io/defang/main/src/bin/install.sh)
- Using Go:
go install github.com/defang-io/defang/src/cmd/cli@latest
- Using the Nix package manager:
- with Nix-Env:
nix-env -if https://github.com/defang-io/defang/archive/main.tar.gz
- or with Flakes:
nix profile install github:defang-io/defang#defang-bin --refresh
- with Nix-Env:
- Download the latest binary of the Defang CLI. For this beta, MacOS users will have to explicitly allow running of downloaded programs in the OS security settings.
- File any issues right here on GitHub
The Defang CLI supports command completion for Bash, Zsh, Fish, and Powershell. To get the shell script for command completion, run the following command:
defang completion [bash|zsh|fish|powershell]
If you're using Bash, you can add the following to your ~/.bashrc
file:
source <(defang completion bash)
If you're using Zsh, you can add the following to your ~/.zshrc
file:
source <(defang completion zsh)
or pipe the output to a file called _defang
in the directory with the completions.
If you're using Fish, you can add the following to your ~/.config/fish/config.fish
file:
defang completion fish | source
If you're using Powershell, you can add the following to your $HOME\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
file:
Invoke-Expression -Command (defang completion powershell | Out-String)
The Defang CLI recognizes the following environment variables:
COMPOSE_PROJECT_NAME
- The name of the project to use; overrides the name in thecompose.yaml
fileDEFANG_ACCESS_TOKEN
- The access token to use for authentication; if not specified, uses token fromdefang login
DEFANG_CD_IMAGE
- The image to use for the Continuous Deployment (CD) pipeline; defaults topublic.ecr.aws/defang-io/cd:public-beta
DEFANG_DEBUG
- set this to1
ortrue
to enable debug loggingDEFANG_DISABLE_ANALYTICS
- If set totrue
, disables sending analytics to Defang; defaults tofalse
DEFANG_FABRIC
- The address of the Defang Fabric to use; defaults tofabric-prod1.defang.dev
DEFANG_HIDE_HINTS
- If set totrue
, hides hints in the CLI output; defaults tofalse
DEFANG_HIDE_UPDATE
- If set totrue
, hides the update notification; defaults tofalse
DEFANG_PROVIDER
- The name of the cloud provider to use,auto
(default),aws
, ordefang
NO_COLOR
- If set to any value, disables color output; by default, color output is enabled depending on the terminalXDG_STATE_HOME
- The directory to use for storing state; defaults to~/.local/state