Bref Cloud documentation

Bref Cloud is the service that complements the open-source Bref project. It deploys, monitors and operates serverless PHP applications on AWS Lambda, in your own AWS account, without the AWS complexity.

To get started, create a Bref Cloud account . There is a free plan for personal projects, and paid plans come with a free trial. See the pricing.

Learn more about Bref CloudGet started with Bref Cloud

What Bref Cloud does

Deploy

• One command: bref deploy from your machine or from GitHub Actions. No AWS credentials to create, distribute or rotate: Bref Cloud generates short-lived credentials for every deployment.
• Databases and networks: create MySQL or PostgreSQL databases (fixed instances, or serverless databases that scale and pause on their own) and private networks in a few clicks.
• Environments: manage dev, staging and production across AWS accounts and regions from one dashboard, with the history of every deployment (also available from the terminal with bref deployments).

Monitor

• Overview: a diagram of each environment’s architecture with live metrics on every component.
• Logs: search logs or tail them in real time in the dashboard, or search them from the terminal with bref logs.
• Metrics: Lambda invocations, concurrency, duration and errors, API Gateway, queues and dead-letter queues.
• Traces: a trace explorer optimized for PHP applications, with a free Bref X-Ray license included. See database queries, HTTP calls and AWS calls inside each invocation, and filter traces by route, job, command, cold start, or your own annotations, over up to 30 days.
• Performance: the slowest database queries, the latency of every route, and the slowest jobs of your application, computed from the last 30 days of traces.
• Health checks: verify that the database, the cache and the Lambda configuration of a deployed application are healthy (Laravel only for now).

Learn more about monitoring with Bref Cloud.

Operate

• Queues: watch queues and dead-letter queues, and retry, delete or flush failed Laravel jobs.
• Commands: run console commands (Artisan, Symfony console…) on a deployed environment from the dashboard.
• Secrets: create and manage secrets for all your applications.
• Files: browse, upload, rename and delete files in S3 buckets.

AI agents

AI agents like Claude Code, Cursor or Codex can read the logs and the deployments of your applications with the bref CLI: bref logs, bref deployments, bref deployments:show and bref deployments:logs. For example, an agent can look for the error behind a bug report, or find why a deployment failed.

The CLI detects when an agent runs it and adapts its output: no colors or spinners, logs as compact text, and deployments as JSON.

Team and security

• Team members: invite teammates with read-only, write or admin access. They never need AWS access.
• AWS access: Bref Cloud connects to your AWS accounts through IAM roles and temporary credentials, never long-lived access keys. Learn more.