> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataraven.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Core Concepts

> Understand the DataRaven data model

DataRaven organizes data movement around a few key primitives.

## Teams

Everything in DataRaven lives inside a **Team**. Teams are collaborative workspaces with:

* **Role-based access** — Owner, Admin, Member roles
* **Shared resources** — Locations, tasks, and vault connections are scoped to a team
* **Independent billing** — Each team has its own subscription (Free or Pro)

## Locations

A **Location** is a configured connection to a storage backend. Think of it as a named pointer to a
bucket, container, or directory on a remote provider.

Locations support 40+ backends including S3-compatible stores, GCS, Azure Blob, and more.

## Tasks

A **Task** defines a data movement operation between two locations. Tasks specify:

* **Source and destination** locations
* **Transfer mode** — copy, sync, or move
* **Filters** — include/exclude patterns
* **Schedule** — optional cron expression for recurring runs
* **Bandwidth limits** and other rclone flags

## Executions

An **Execution** is a single run of a task. Each execution captures:

* Start/end time and duration
* Bytes transferred and files processed
* Status (running, completed, failed, stopped)
* Full rclone logs (downloadable or streamable)

## Vault Connections

DataRaven's **zero-knowledge credential architecture** means your cloud credentials are never retained
on our systems. Instead, you connect a **Vault** — a secrets manager you already trust:

* **1Password** — Connect via Service Account
* **Doppler** — Project-level access
* **Infisical** — Machine identity tokens

Locations reference secrets stored in your vault. DataRaven resolves them at transfer time and
discards them immediately after.

## Secrets

**Secrets** are references to credentials stored in your connected vault. They map a secret name in
DataRaven to a path/key in your vault provider.

## Notifications

Configure **Notifications** to get real-time alerts when configurations change & task execution events. Supports webhooks and
integrations for monitoring your data pipeline.
