{"id":49425435,"url":"https://github.com/upsun/cli","last_synced_at":"2026-05-27T13:02:13.676Z","repository":{"id":343720643,"uuid":"1124953883","full_name":"upsun/cli","owner":"upsun","description":"The unified tool for managing your Upsun services from the command line.","archived":false,"fork":false,"pushed_at":"2026-05-26T10:45:03.000Z","size":12691,"stargazers_count":2,"open_issues_count":14,"forks_count":5,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-26T12:33:04.726Z","etag":null,"topics":["cli","cloud","command-line","paas"],"latest_commit_sha":null,"homepage":"https://developer.upsun.com/cli","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/upsun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-29T22:54:35.000Z","updated_at":"2026-05-20T23:47:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/upsun/cli","commit_stats":null,"previous_names":["upsun/cli"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/upsun/cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/upsun%2Fcli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/upsun%2Fcli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/upsun%2Fcli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/upsun%2Fcli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/upsun","download_url":"https://codeload.github.com/upsun/cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/upsun%2Fcli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33566873,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cloud","command-line","paas"],"created_at":"2026-04-29T09:10:01.006Z","updated_at":"2026-05-27T13:02:13.670Z","avatar_url":"https://github.com/upsun.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Upsun CLI\n\nThe **Upsun CLI** is the official command-line interface for [Upsun](https://upsun.com).\n\nThis repository hosts the source code and releases of the CLI.\n\n\u003e This product includes PHP software, freely available from [the PHP website](https://www.php.net/software)\n\n## Install\n\nTo install the CLI, use either [Homebrew](https://brew.sh/) (on Linux, macOS, or the Windows Subsystem for Linux) or [Scoop](https://scoop.sh/) (on Windows):\n\n### HomeBrew\n\n```console\nbrew install upsun/tap/upsun-cli\n```\n\n### Scoop\n\n```console\nscoop bucket add upsun https://github.com/upsun/homebrew-tap.git\nscoop install upsun\n```\n\n### Bash installer\n\nUse the bash installer for an automated installation, using the most preferable way for your system.\n\n```console\ncurl -fsSL https://raw.githubusercontent.com/upsun/cli/main/installer.sh | bash\n```\n\nThe installer is configurable using the following environment variables:\n\n* `INSTALL_LOG` - the install log file\n* `INSTALL_METHOD` - force a specific installation method, possible values are `brew` and `raw`\n* `INSTALL_DIR` - the installation directory for the `raw` installation method, for example you can use `INSTALL_DIR=$HOME/.local/bin` for a single user installation\n* `VERSION` - the version of the CLI to install, if you need a version other than the latest one\n\n#### Installation configuration examples\n\n\u003cdetails\u003e\n    \u003csummary\u003eForce the CLI to be installed using the raw method\u003c/summary\u003e\n\n    curl -fsSL https://raw.githubusercontent.com/upsun/cli/main/installer.sh | INSTALL_METHOD=raw bash\n\u003c/details\u003e\n\n\u003cdetails\u003e\n    \u003csummary\u003eInstall a specific version\u003c/summary\u003e\n\n    curl -fsSL https://raw.githubusercontent.com/upsun/cli/main/installer.sh | VERSION=5.0.0 bash\n\u003c/details\u003e\n\n\u003cdetails\u003e\n    \u003csummary\u003eInstall the CLI in a user owned directory\u003c/summary\u003e\n\n    curl -fsSL https://raw.githubusercontent.com/upsun/cli/main/installer.sh | INSTALL_METHOD=raw INSTALL_DIR=$HOME/.local/bin bash\n\u003c/details\u003e\n\n### Nix profile\n\nRefer to the [Nix documentation if you are not on NixOS](https://nix.dev/manual/nix/2.24/installation/installing-binary.html).\n\n```console\nnix profile install nixpkgs#upsun\n```\n\n### Alpine\n\n```console\n# Add the signing key and repository\nsudo mkdir -p /etc/apk/keys\nsudo curl -fsSL -o /etc/apk/keys/repositories-upsun-com.rsa.pub https://repositories.upsun.com/alpine/repositories-upsun-com.rsa.pub\necho \"https://repositories.upsun.com/alpine\" | sudo tee -a /etc/apk/repositories\n\n# Install the CLI\nsudo apk add upsun-cli\n```\n\n### Ubuntu/Debian\n\n```console\n# Add the signing key and repository\nsudo mkdir -p /etc/apt/keyrings\nsudo curl -fsSL https://repositories.upsun.com/gpg.key -o /etc/apt/keyrings/upsun.asc\necho \"deb [signed-by=/etc/apt/keyrings/upsun.asc] https://repositories.upsun.com/debian stable main\" | sudo tee /etc/apt/sources.list.d/upsun.list\n\n# Install the CLI\nsudo apt-get update\nsudo apt-get install -y upsun-cli\n```\n\n### RPM (Fedora, RHEL, CentOS, AlmaLinux, Rocky)\n\n```console\n# Add the repository\nsudo tee /etc/yum.repos.d/upsun.repo \u003c\u003c 'EOF'\n[upsun]\nname=Upsun CLI\nbaseurl=https://repositories.upsun.com/rpm/$basearch\nenabled=1\ngpgcheck=1\ngpgkey=https://repositories.upsun.com/gpg.key\nEOF\n\n# Install the CLI (use yum on older systems)\nsudo dnf install -y upsun-cli\n```\n\n### Manual installation\n\nFor manual installation, you can also [download the latest binaries](https://github.com/upsun/cli/releases/latest).\n\n### Docker\n\nThe CLI is also available as a Docker image:\n\n```console\ndocker run --rm -it ghcr.io/upsun/cli\n```\n\n## Upgrade\n\nUpgrade using the same tool:\n\n### HomeBrew\n\n```console\nbrew update \u0026\u0026 brew upgrade upsun/tap/upsun-cli\n```\n\n### Scoop\n\n```console\nscoop update upsun\n```\n\n### Bash installer\n\n```console\ncurl -fsSL https://raw.githubusercontent.com/upsun/cli/main/installer.sh | bash\n```\n\n### Alpine\n\n```console\nsudo apk update \u0026\u0026 sudo apk upgrade upsun-cli\n```\n\n### Ubuntu/Debian\n\n```console\nsudo apt-get update \u0026\u0026 sudo apt-get upgrade upsun-cli\n```\n\n### CentOS/RHEL/Fedora\n\n```console\nsudo dnf upgrade -y upsun-cli\n```\n\n## Building\n\nBuild a single binary:\n\n```console\nmake single\n```\n\nBuild a snapshot:\n\n```console\nmake snapshot\n```\n\nBuild a snapshot for a vendor:\n\n```console\n# Download the config file at internal/config/embedded-config.yaml\nmake vendor-snapshot VENDOR_NAME='Vendor Name' VENDOR_BINARY='vendorcli'\n```\n\n## Creating a Release\n\nReleases are automated via GitHub Actions. To create a new release:\n\n1. Create and push a new tag:\n   ```console\n   git tag -m 'Release v5.0.0' 'v5.0.0'\n   git push origin v5.0.0\n   ```\n\n2. The [Release workflow](.github/workflows/release.yml) will automatically:\n   - Build binaries for all platforms\n   - Sign packages (APK, DEB, RPM)\n   - Create a GitHub release with all artifacts\n   - Update package repositories at repositories.upsun.com\n   - Build and push Docker image to ghcr.io/upsun/cli\n\n## Licenses\n\nThis binary redistributes PHP in a binary form, which comes with the [PHP License](https://www.php.net/license/3_01.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fupsun%2Fcli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fupsun%2Fcli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fupsun%2Fcli/lists"}