# dokploy_destination (Data Source)

Looks up an S3-compatible backup destination already registered in Dokploy.

A shared backup target is typically created once and referenced from several projects:

```terraform
data "dokploy_destination" "backups" {
  name = "cloudflare-r2"
}

resource "dokploy_backup" "db" {
  destination_id = data.dokploy_destination.backups.id
  # ...
}
```

~> **Credentials are not exposed.** `access_key` and `secret_access_key` exist on the `dokploy_destination` resource but deliberately not here: consumers need only the id, and copying an access key into every consumer's state widens its blast radius for no gain.

~> Dokploy does not enforce name uniqueness. If two destinations share a name this data source fails rather than picking one; look the record up by `id` in that case.

## Example Usage

```terraform
# Look up a backup destination that already exists in Dokploy, by name.
data "dokploy_destination" "backups" {
  name = "cloudflare-r2"
}

# Or by id, when the name is ambiguous or you already hold the id.
data "dokploy_destination" "by_id" {
  id = "V1StGXR8_Z5jdHi6B-myT"
}

# The usual reason to look one up: a shared S3 target created once and
# referenced from several projects.
resource "dokploy_backup" "db" {
  service_id     = dokploy_postgres.main.id
  service_type   = "postgres"
  destination_id = data.dokploy_destination.backups.id
  database       = "app"
  prefix         = "app/"
  schedule       = "0 3 * * *"
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Optional

- `id` (String) Destination id. Set this to look it up by id, or leave it unset and set `name`.
- `name` (String) Display name as shown in Dokploy. Exactly one of `id` or `name` must be set.

### Read-Only

- `additional_flags` (List of String) Extra flags passed to the underlying storage client. Empty when none are set.
- `bucket` (String) Bucket name.
- `created_at` (String) Creation timestamp (server-side).
- `endpoint` (String) S3 endpoint URL.
- `provider_name` (String) Storage provider label, e.g. `Cloudflare`, `AWS`, `DigitalOcean`.
- `region` (String) Bucket region.