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(3w ago)4110.6k↑406.7%6[30 issues](https://github.com/laravel/cloud-cli/issues)[1 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 3w ago READMEChangelog (10)Dependencies (44)Versions (87)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 50 — FairBetter than 95% of packages Maintenance79 Regular maintenance activity Popularity40 Moderate usage in the ecosystem Community16 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 96.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 22d 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 (444 commits)")[![JoshSalway](https://avatars.githubusercontent.com/u/1491451?v=4)](https://github.com/JoshSalway "JoshSalway (9 commits)")[![mateusjatenee](https://avatars.githubusercontent.com/u/10816999?v=4)](https://github.com/mateusjatenee "mateusjatenee (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)")[![nunomaduro](https://avatars.githubusercontent.com/u/5457236?v=4)](https://github.com/nunomaduro "nunomaduro (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. 76518.2M118](/packages/laravel-mcp)[mehrancodes/laravel-harbor A CLI tool to Quickly create On-Demand preview environment for your apps. 10095.6k](/packages/mehrancodes-laravel-harbor)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)