Defang

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.

Getting started

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

Installing

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 -Ls https://s.defang.io/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

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.

Support

File any issues right here on GitHub

Command completion

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)

Environment Variables

The Defang CLI recognizes the following environment variables: