nightly

Defang CLI

This is the Command Line Interface (CLI) for Defang. This is a beta version and is provided as-is, intended primarily for testing purposes.
For alternative installation methods, please check the README.

Manual installation Instructions

1. Download the archive file for your Operating System.
2. Extract the archive. This should reveal the binary file for Defang.
3. Manually place the binary file in a directory that's included in your system's PATH environment variable.

Additional Step for MacOS Users

If you're having trouble running the binary on MacOS, please check our FAQs.

Please remember this software is in beta, so please report any issues or feedback through our GitHub page. Your help in improving Defang is greatly appreciated!

Changelog

• 16a39d5: Add login annotation to stack commands (#2077) (@lionello)
• 2391057: fix: warn when project or service name exceeds 16 characters (#2080) (@jordanstephens)
• b91ded7: fix: update tenant label from "personal tenant" to "default tenant" for clarity (@lionello)
• cdcd9da: fix(aws): check AWS_WEB_IDENTITY_TOKEN_FILE iff DEFANG_ACCESS_TOKEN (@lionello)
• c89b107: fix: warn when stack name exceeds 16 characters to prevent resource name issues (@lionello)

v3.5.6

What's Changed

• docs: add CLAUDE.md and .claude/ agent configuration by @simple-agent-manager[bot] in #2062
• record deployment even if putStack fails by @jordanstephens in #2067
• Retry when creating service account in case IAM is being enabled by @edwardrf in #2072
• Dedupe NPM workflow steps by @lionello in #2045
• fix(aws): use survey for AWS login code input by @jordanstephens in #2070
• chore(deps): bump go.opentelemetry.io/otel from 1.40.0 to 1.41.0 in /src by @dependabot[bot] in #2075

New Contributors

• @simple-agent-manager[bot] made their first contribution in #2062

Full Changelog: v3.5.5...v3.5.6

v3.5.5

What's Changed

• Handle 403 during first GCP up by @lionello in #2061

Full Changelog: v3.5.4...v3.5.5

v3.5.4

What's Changed

• Prevent creating stack with name of existing stack by @jordanstephens in #1969
• Install specific CLI versions by @lionello in #2040
• feat(stacks): show account in interactive stack selector labels by @jordanstephens in #2043
• feat: add NPM workflow for building and testing packages by @lionello in #2044
• feat(stack): add Account column to stack ls table by @jordanstephens in #2042
• Fix Compute Engine instance group manager monitoring by @jordanstephens in #2025
• replace openai-access-gateway with litellm by @jordanstephens in #2012
• Add Claude Code plugin (deploy skill + MCP server) by @jordanstephens in #2041
• Add Codex plugin with deploy skill and MCP server by @jordanstephens in #2047
• ignore .claude/settings.local.json by @jordanstephens in #2049
• Add estimate and debug skills by @jordanstephens in #2048
• Rename debug skill to status by @jordanstephens in #2056
• Add DNS resolve grpc APIs by @edwardrf in #2057
• fix: only check for existing stack when interactive by @lionello in #2058

Full Changelog: v3.5.3...v3.5.4

v3.5.3

What's Changed

• Fix GCP expired oauth token does not prompt for new login by @edwardrf in #2033
• chore: SHA-pin all GHA actions and add Dependabot by @lionello in #2034
• chore(deps): bump the github-actions group across 1 directory with 6 updates by @dependabot[bot] in #2036
• Update dependencies in our NPM package by @lionello in #2035
• feat: press D to toggle debug mode by @lionello in #2039
• Fix races in AWS compose up by @lionello in #2038

Full Changelog: v3.5.2...v3.5.3

v3.5.2

What's Changed

• chore(deps-dev): bump brace-expansion from 2.0.2 to 2.0.3 in /pkgs/npm by @dependabot[bot] in #2009
• chore(deps-dev): bump path-to-regexp from 8.2.0 to 8.4.0 in /pkgs/npm by @dependabot[bot] in #2008
• chore(deps): bump github.com/go-jose/go-jose/v4 from 4.1.3 to 4.1.4 in /src by @dependabot[bot] in #2014
• fix(aws): add CodeBuild log to subscribe events by @lionello in #2017
• fix(stacks): add project name to stack errors by @lionello in #2022
• feat(cd): add CD task/job/build ID to Deployment msg by @lionello in #2023
• Gracefully handle GCP logging quota exhaustion by @jordanstephens in #2024
• chore(deps): bump github.com/aws/aws-sdk-go-v2/service/cloudwatchlogs from 1.35.4 to 1.65.0 in /src by @dependabot[bot] in #2028
• Fix cert gen error message by @lionello in #2026
• chore(deps): bump github.com/aws/aws-sdk-go-v2/service/s3 from 1.48.1 to 1.97.3 in /src by @dependabot[bot] in #2029

Full Changelog: v3.5.1...v3.5.2

v3.5.1

Full Changelog: v3.5.0...v3.5.1

v3.5.0

What's Changed

• chore: rename Region in 'cd ls' to CdRegion by @lionello in #1994
• fix: don't write file outside of refered project dir by @lionello in #1993
• Use auth portal for better gcp and aws oauth UX by @edwardrf in #1992
• fix(aws): use mutex for deployment-etag cache by @lionello in #1996
• Enable resource manager is enabled before testing credential permissions by @edwardrf in #1999
• Replace ECS Fargate with CodeBuild for running CD by @lionello in #1984
• Fix aws OIDC github login by @edwardrf in #2000
• Authenticate to clouds should handle context cancel correctly by @edwardrf in #2003
• chore(deps-dev): bump picomatch from 2.3.1 to 2.3.2 in /pkgs/npm by @dependabot[bot] in #2005
• chore(deps): bump github.com/buger/jsonparser from 1.1.1 to 1.1.2 in /src by @dependabot[bot] in #1997
• chore(deps): bump google.golang.org/grpc from 1.73.0 to 1.79.3 in /src by @dependabot[bot] in #1995
• Fix panic when loading invalid Compose file by @lionello in #2006

Full Changelog: v3.4.0...v3.5.0

v3.4.0

What's Changed

• GCP and AWS interactive login, with GCP WIF provider github token support by @edwardrf in #1956
• feat: pin CD/Pulumi version unless --allow-upgrade by @lionello in #1982
• Remote Stack Deletion by @jordanstephens in #1963
• feat: add --force to 'cd setup' to allow CD downgrades by @lionello in #1989
• CI gate for go test coverage by @jordanstephens in #1988

Full Changelog: v3.3.2...v3.4.0

v3.3.2

What's Changed

• Fix panics by @lionello in #1974
• Only push release tags by @jordanstephens in #1968
• Document token regeneration steps in smoketests.yml by @jordanstephens in #1975
• Fix DeleteParameters for AWS by @lionello in #1977
• chore: replace buf by connectrpc by @lionello in #1980
• chore(deps): bump tar from 7.5.8 to 7.5.11 in /pkgs/npm by @dependabot[bot] in #1976
• chore(deps): bump go.opentelemetry.io/otel/sdk from 1.36.0 to 1.40.0 in /src by @dependabot[bot] in #1953
• increase retry limit for reading new gcp resources by @jordanstephens in #1979
• chore(deps): bump github.com/docker/cli from 27.3.1+incompatible to 29.2.0+incompatible in /src by @dependabot[bot] in #1958

Full Changelog: v3.3.1...v3.3.2