Cloud Recording

Cloud recording allows you to record your meetings and store those files in a storage bucket owned by you and your organization.
This feature requires the use of Amazon S3 storage. You can review their plans and pricing on the AWS site. Amazon also offers some free tier options to explore. Note that if you're creating an AWS account from scratch it can sometimes take up to 24 hours.

Setup in Whereby

You can access recording settings and options from the “Configure” → “Recording” section of your organization's dashboard. You can also specify recording preferences via the API during a room creation request.
When configuring cloud recording options via the dashboard, it will apply these as default settings for all rooms created. However, you can override the defaults by specifying different preferences within the POST requests used to create meetings.
Select "Cloud Recording" and input your S3 information.
After setting up the appropriate information, select how you would like to trigger your recording in rooms.
  • Auto-start (1 person) Recordings will start when the first person joins and end when the last person leaves
  • Auto-start (2 people) Recordings will start when 2 people join a room and end when the last person leaves
  • Prompt host Display a prompt to the host to manually start recording
  • Manual Host will manually start by clicking "Record" in the toolbar
Then select the format that you'd like the recordings to be saved as, we currently offer .mkv and .mp4. Recording quality is set to 720p, however individual video feeds may appear in lower quality depending on their network connection, device, and preferences.
File names will be automatically set to [room name]-[start time in ISO format].mkv and is the time when the recording started.

Managing recording activity

You can use our webhook events to track when a recording has started and stopped. The roleName will be set to recorder, and will use the room.client.joined and room.client.left events accordingly.
In addition to tracking recordings, we offer browser methods to start and stop recordings at your leisure via our SDK's Embed Element.

Setup and information in S3

There are a few pieces of information to gather from your S3 instance to create and connect your bucket with Whereby. We'll outline each one briefly below and how to locate the information.
Creating a Bucket
S3 info for Whereby
Creating an S3 bucket can be done from the Amazon S3 console page. If S3 isn't presented as an option you can search for it within the services search at the top of the page.
For in depth instructions about bucket naming conventions and settings, please follow the Amazon support guide "Create your first S3 bucket".
Host: This is also known as your Bucket name. No URL is required, you can simply copy and paste your bucket name found in your S3 console.
Access Key ID & Access Secret: You can locate or create your Access Key and Access secret in the "Identity and Access Management" (IAM) section of your console.
It's recommended and considered best practice to create IAM users with the appropriate permissions for your AWS Access Keys. Sharing the credentials of a Root user can allow unrestricted access to all resources in your AWS account, including billing information. For more information, check out Amazon's support article: Best practices for managing AWS access keys
Where to create Access Keys