PHPackages laravel/cloud-cli - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. laravel/cloud-cli ActiveProject[Framework](/categories/framework) laravel/cloud-cli ================= CLI to interact with Laravel Cloud v0.5.0(2mo ago)4116.1k↑344.9%7[6 issues](https://github.com/laravel/cloud-cli/issues)[2 PRs](https://github.com/laravel/cloud-cli/pulls)MITPHPPHP ^8.2CI passing Since Jan 20Pushed 1mo ago1 watchersCompare [ Source](https://github.com/laravel/cloud-cli)[ Packagist](https://packagist.org/packages/laravel/cloud-cli)[ Docs](https://cloud.laravel.com)[ RSS](/packages/laravel-cloud-cli/feed)WikiDiscussions main Synced 4w ago READMEChangelog (10)Dependencies (44)Versions (89)Used By (0) Laravel Cloud CLI ================= [](#laravel-cloud-cli) A Laravel Zero CLI for deploying and managing applications on [Laravel Cloud](https://cloud.laravel.com). Authenticate via OAuth, create and manage applications, environments, databases, caches, object storage, domains, and more—all from the terminal. Requirements ------------ [](#requirements) - **PHP 8.2+** - **Composer** - **GitHub CLI (`gh`)** — installed and authenticated (used for repo linking and GitHub API) - **Git** — for repository detection and `repo:config` Installation ------------ [](#installation) Clone the repository and install dependencies: ``` gh repo clone laravel/cloud-cli cd cloud-cli composer install ``` Setup Alias ----------- [](#setup-alias) To use the `cloud` command from anywhere, add an alias to your shell configuration: **For Zsh (macOS default):** ``` echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc source ~/.zshrc ``` **For Bash:** ``` echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc source ~/.bashrc ``` Or manually add the alias to your `~/.zshrc` or `~/.bashrc` file: ``` alias cloud="php /path/to/cloud-cli/cloud" ``` Authentication -------------- [](#authentication) Before using most commands, authenticate with Laravel Cloud: ``` cloud auth ``` This opens a browser for OAuth. API tokens are stored in `~/.config/cloud/config.json`. To manage tokens (e.g. for CI): ``` cloud auth:token ``` Repository configuration ------------------------ [](#repository-configuration) Link the current Git repo to a Laravel Cloud application and set defaults (application, environment) so you don’t have to pass them every time: ``` cloud repo:config ``` Run this from your project root after `cloud auth`. Quick start ----------- [](#quick-start) 1. **Ship** — Guided flow to create an application and deploy it: ``` cloud ship ``` 2. **Deploy** — Deploy an existing application (uses repo config or prompts): ``` cloud deploy ``` 3. **Dashboard** — Open the app in the Laravel Cloud dashboard: ``` cloud dashboard ``` 4. **Shell completions** — Enable tab completion: ``` cloud completions ``` Commands reference ------------------ [](#commands-reference) Many commands accept an optional resource ID/name and support `--json` for machine-readable output. When run interactively without arguments, the CLI will prompt for application, environment, or other context as needed. ### Auth & config [](#auth--config) CommandDescription`cloud auth`Authenticate with Laravel Cloud (browser OAuth)`cloud auth:token`Manage API tokens`cloud repo:config`Configure defaults for the current repository### Applications [](#applications) CommandDescription`cloud application:list`List applications`cloud application:get`Get application details`cloud application:create`Create an application`cloud application:update`Update an application`cloud application:delete`Delete an application### Environments [](#environments) CommandDescription`cloud environment:list`List environments`cloud environment:get`Get environment details`cloud environment:create`Create an environment`cloud environment:update`Update an environment`cloud environment:delete`Delete an environment`cloud environment:variables`Manage environment variables (append, set, or replace)`cloud environment:logs`View environment logs### Deploy & ship [](#deploy--ship) CommandDescription`cloud ship`Ship the application to Laravel Cloud (guided)`cloud deploy`Deploy to Laravel Cloud`cloud deploy:monitor`Monitor deployments`cloud deployment:list`List deployments`cloud deployment:get`Get deployment details### Instances [](#instances) CommandDescription`cloud instance:list`List instances`cloud instance:get`Get instance details`cloud instance:create`Create an instance`cloud instance:update`Update an instance`cloud instance:delete`Delete an instance`cloud instance:sizes`List available instance sizes### Databases [](#databases) CommandDescription`cloud database-cluster:list`List database clusters`cloud database-cluster:get`Get cluster details`cloud database-cluster:create`Create a database cluster`cloud database-cluster:update`Update a database cluster`cloud database-cluster:delete`Delete a database cluster`cloud database:list`List databases (schemas) in a cluster`cloud database:get`Get database details`cloud database:create`Create a database`cloud database:delete`Delete a database`cloud database:open`Open database locally`cloud database-snapshot:list`List snapshots`cloud database-snapshot:get`Get snapshot details`cloud database-snapshot:create`Create a snapshot`cloud database-snapshot:delete`Delete a snapshot`cloud database-restore:create`Create a restore from snapshot or PITR### Cache [](#cache) CommandDescription`cloud cache:list`List caches`cloud cache:get`Get cache details`cloud cache:create`Create a cache`cloud cache:update`Update a cache`cloud cache:delete`Delete a cache`cloud cache:types`List available cache types### Object storage (buckets) [](#object-storage-buckets) CommandDescription`cloud bucket:list`List buckets`cloud bucket:get`Get bucket details`cloud bucket:create`Create a bucket`cloud bucket:update`Update a bucket`cloud bucket:delete`Delete a bucket`cloud bucket-key:list`List bucket keys`cloud bucket-key:get`Get bucket key details`cloud bucket-key:create`Create a bucket key`cloud bucket-key:update`Update a bucket key`cloud bucket-key:delete`Delete a bucket key### Domains [](#domains) CommandDescription`cloud domain:list`List domains`cloud domain:get`Get domain details`cloud domain:create`Create a domain`cloud domain:update`Update a domain`cloud domain:delete`Delete a domain`cloud domain:verify`Verify domain DNS### WebSockets [](#websockets) CommandDescription`cloud websocket-cluster:list`List WebSocket clusters`cloud websocket-cluster:get`Get cluster details`cloud websocket-cluster:create`Create a WebSocket cluster`cloud websocket-cluster:update`Update a WebSocket cluster`cloud websocket-cluster:delete`Delete a WebSocket cluster`cloud websocket-application:list`List WebSocket applications`cloud websocket-application:get`Get application details`cloud websocket-application:create`Create a WebSocket application`cloud websocket-application:update`Update a WebSocket application`cloud websocket-application:delete`Delete a WebSocket application### Background processes [](#background-processes) CommandDescription`cloud background-process:list`List background processes`cloud background-process:get`Get process details`cloud background-process:create`Create a background process`cloud background-process:update`Update a background process`cloud background-process:delete`Delete a background process### Commands (scheduled/one-off) [](#commands-scheduledone-off) CommandDescription`cloud command:list`List commands for an environment`cloud command:get`Get command details`cloud command:run`Run a command on an environment### Usage [](#usage) CommandDescription`cloud usage`View billing summary for the current period`cloud usage --detailed`Full breakdown with per-app, per-resource, and add-on tables`cloud usage --period=previous`View a previous billing period (current, previous, 1, 2, 3)`cloud usage --environment=`Filter usage by environment### Other [](#other) CommandDescription`cloud dashboard`Open app in Cloud dashboard`cloud browser`Open the application in the browser`cloud ip:addresses`Get Laravel Cloud IP addresses by region`cloud dedicated-cluster:list`List dedicated clusters`cloud completions`Generate and install shell completionsConfiguration ------------- [](#configuration) - **User config:** `~/.config/cloud/config.json` (auth tokens and preferences). - **Repo defaults:** After `cloud repo:config`, the current Git repo stores which application and environment to use so you can run `cloud deploy` and similar without selecting every time. Development ----------- [](#development) - **Code style:** Laravel/PSR-12. Format with [Laravel Pint](https://laravel.com/docs/pint): ``` ./vendor/bin/pint --dirty ``` - **Tests:** [Pest](https://pestphp.com/): ``` ./vendor/bin/pest ``` - **Static analysis:** [PHPStan](https://phpstan.org/): ``` ./vendor/bin/phpstan analyse ``` Links ----- [](#links) - [Laravel Cloud](https://cloud.laravel.com) - [Laravel Cloud API docs](https://cloud.laravel.com/docs/api/introduction) - [Laravel Zero](https://laravel-zero.com) ### Health Score 52 — FairBetter than 96% of packages Maintenance86 Actively maintained with recent releases Popularity40 Moderate usage in the ecosystem Community17 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 95.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~3 days Total 31 Last Release 67d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/463230?v=4)[Taylor Otwell](/maintainers/taylorotwell)[@taylorotwell](https://github.com/taylorotwell) --- Top Contributors [![joetannenbaum](https://avatars.githubusercontent.com/u/2702148?v=4)](https://github.com/joetannenbaum "joetannenbaum (447 commits)")[![JoshSalway](https://avatars.githubusercontent.com/u/1491451?v=4)](https://github.com/JoshSalway "JoshSalway (9 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![mateusjatenee](https://avatars.githubusercontent.com/u/10816999?v=4)](https://github.com/mateusjatenee "mateusjatenee (3 commits)")[![nunomaduro](https://avatars.githubusercontent.com/u/5457236?v=4)](https://github.com/nunomaduro "nunomaduro (3 commits)")[![pushpak1300](https://avatars.githubusercontent.com/u/31663512?v=4)](https://github.com/pushpak1300 "pushpak1300 (2 commits)")[![Frostist](https://avatars.githubusercontent.com/u/37545822?v=4)](https://github.com/Frostist "Frostist (1 commits)") --- Tags clilaravelcloud ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/laravel-cloud-cli/health.svg) ``` [![Health](https://phpackages.com/badges/laravel-cloud-cli/health.svg)](https://phpackages.com/packages/laravel-cloud-cli) ``` ### Alternatives [laravel/mcp Rapidly build MCP servers for your Laravel applications. 79227.1M206](/packages/laravel-mcp)[mehrancodes/laravel-harbor A CLI tool to Quickly create On-Demand preview environment for your apps. 99100.2k](/packages/mehrancodes-laravel-harbor)[erag/laravel-disposable-email A Laravel package to detect and block disposable email addresses. 265192.2k1](/packages/erag-laravel-disposable-email)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum)[codebar-ag/laravel-docuware DocuWare integration with Laravel 1125.1k](/packages/codebar-ag-laravel-docuware) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)