Where CompanyBrain writes to
Everything CompanyBrain fetches goes straight to storage you choose. Below you find, per storage, how it connects, which permissions we ask for, what the folders look like and which files appear.
Folder structure
By default we write per AI platform, per employee and per day. The path is adjustable with the fields {source}, {user}, {yyyy}, {mm}, {dd} and {project}.
{source}/{user}/{yyyy}/{mm}/{yyyy}-{mm}-{dd}.jsonl
{source}/{user}/journal-{yyyy}-{mm}.md
{source}/{user}/bijlagen/{yyyy}/{mm}/{record-id}/{bestandsnaam}
File formats
- JSONL per platform, employee and day. Every line is a record with id, time, source, user, kind, project, summary and the full original response of the platform.
- Markdown per employee per month: a readable journal with a line per event.
- Attachments as the original file, only for Claude Enterprise, up to the configured size (25 MB by default). On storage that cannot write binary files only the details of the attachment are in the logs.
Every run is idempotent: records are merged on their id, so there are never duplicate lines, even if a day runs again.
Azure Blob Storage
Object storage in your own Azure environment
How it connects
- With a SAS URL (recommended)
- With a service principal
Which permissions we ask for
With a SAS URL: Read, Add, Create, Write and List on that one container (Delete is optional). With a service principal: the role Storage Blob Data Contributor, on that container only.
Steps for the administrator
- Create a storage account in Azure with a container in it.
- Open the container and choose Shared access tokens.
- Give the permissions Read, Add, Create, Write and List and choose a long expiry date.
- Copy the full SAS URL and paste it below.
Amazon S3
Object storage in your own AWS environment
How it connects
- With an IAM role (recommended)
- With an access key
Which permissions we ask for
An IAM role or access key with only PutObject, GetObject, DeleteObject and ListBucket on the bucket and folder. For an IAM role we show the trust and permissions policy to copy.
Steps for the administrator
- Create a bucket in AWS.
- Create an IAM role with the permissions policy below.
- Copy the trust policy below into the role.
- Enter the bucket, the region and the ARN of the role below.
S3-compatible
Hetzner, Cloudflare R2, MinIO and other S3 storage
How it connects
- With an access key
Which permissions we ask for
A key pair with access to that bucket only.
Steps for the administrator
- Create a bucket and a key pair with access to that bucket only at your provider.
- Look up the address of the storage, for Hetzner that is https://location.your-objectstorage.com.
- Enter the address, the bucket and both keys below.
OneDrive
A folder of its own in your OneDrive
How it connects
- Sign in with Microsoft
Which permissions we ask for
Sign in with Microsoft with only the permission Files.ReadWrite.AppFolder. CompanyBrain only sees its own folder Apps/CompanyBrain.
Steps for the administrator
- Click Connect and sign in with your Microsoft account.
- Give consent. CompanyBrain gets a folder of its own, Apps/CompanyBrain.
Google Drive
A folder of its own in your Google Drive
How it connects
- Sign in with Google
Which permissions we ask for
Sign in with Google with only the permission drive.file. CompanyBrain only sees the folder it creates itself.
Steps for the administrator
- Click Connect and sign in with your Google account.
- Give consent. CompanyBrain only sees the folder it creates itself.
Dropbox
A folder of its own in your Dropbox
How it connects
- Sign in with Dropbox
Which permissions we ask for
Sign in with Dropbox with the permissions files.content.write and files.content.read. CompanyBrain gets a folder of its own, Apps/CompanyBrain.
Steps for the administrator
- Click Connect and sign in to Dropbox.
- Give consent. CompanyBrain gets a folder of its own, Apps/CompanyBrain.
GitHub
A private repository on GitHub
How it connects
- With an access token
Which permissions we ask for
A fine-grained token with only the Contents permission on that one private repository.
Steps for the administrator
- Create a private repository on GitHub.
- Create a fine-grained access token that may only read and write this repository (Contents).
- Enter the token and the name of the repository below.
Azure DevOps
A Git repository in Azure DevOps
How it connects
- With an access token
Which permissions we ask for
An access token with the Code permission (read and write).
Steps for the administrator
- Create a Git repository in your Azure DevOps project.
- Create an access token with the permission Code (read and write).
- Enter the token and the details of the repository below.
Tip: turn on immutable storage (WORM) or a retention policy on the storage. Then nobody can change the logs afterwards.