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.

Monitor

• Overview: a diagram of each environment’s architecture with live metrics on every component.
• Logs: search logs or tail them in real time.
• 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.

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.