---
title: "Creating Repository in Object Storage"
description: "To create an object storage repository, use the following command: where: <provider_type> — name of the object storage provider. Veeam Agent supports the following options: amazons3 — for creating an Amazon S3 repository."
canonical: "https://helpcenter.veeam.com/docs/agentforaix/userguide/backup_object_repo_create.html"
breadcrumb: "User Guide > Performing Backup > Managing Backup Repositories > Creating Repository in Object Storage"
dateModified: "2026-11-03"
---

# Creating Repository in Object Storage

To create an object storage repository, use the following command:

```
veeamconfig objectstorage createrepository <provider_type> <options>
```

where:

- `<provider_type>` — name of the object storage provider. Veeam Agent supports the following options:

  - `amazons3` — for creating an Amazon S3 repository.
  - `s3compatible` — for creating an S3 Compatible repository (including repositories in IBM Cloud, Wasabi Cloud and MinIO Cloud).

- `<options>` — options necessary to connect to the target object storage. For more information, see the following subsections:

  - [Specifying options for Amazon S3 repository](#amazon)
  - [Specifying options for S3 Compatible repository](#s3_comp)

After Veeam Agent creates a new backup repository in the object storage location, you can specify object storage as a destination for the backup job.

### Specifying Options for Amazon S3 Repository {#amazon}

To create a backup repository in an Amazon S3 bucket, use the following command:

```
veeamconfig objectstorage createrepository amazons3 --name <repository_name> --accesskeyid <id> --region <storage_region> --bucketname <bucket_name> --folder <folder_name>
```

where:

- `<repository_name>` — name for the backup repository.
- `<id>` — access key associated with the Amazon S3 storage account.
- `<storage_region>` — region associated with the bucket.
- `<bucket_name>` — name of the bucket.

  ::: important

  You must create the bucket where you want to store your backup data beforehand. When you create a bucket, consider Amazon bucket naming rules. For example, it is not recommended that you use dots (.) in the bucket name. For more information on bucket naming rules, see [this AWS documentation article](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).

  :::

- `<folder_name>` — name of the folder in the bucket.

  If Veeam Agent does not find a folder with the name specified in the command, Veeam Agent will create a new folder in the bucket under `Veeam/Backup/` — for example, `Veeam/Backup/folder01`.

For example:

```
user@srv01:~$ veeamconfig objectstorage createrepository amazons3 --name amazon --accesskeyid AMAZONKIAWHDY4BDYCJC --region us-east-1 --bucketname bucket01 --folder folder01
```

After you use the command, Veeam Agent will prompt you to specify a secret key associated with the Amazon S3 storage account. Enter the secret key to complete the creation of the repository.

### Specifying Options for S3 Compatible Repository {#s3_comp}

To create a backup repository in an S3 compatible storage bucket, use the following command:

```
veeamconfig objectstorage createrepository s3compatible --name <repository_name> --servicepoint <address> --region <storage_region> --accesskeyid <id> [--fingerprint <ssl_thumbprint>] --bucketname <bucket_name> --folder <folder_name>
```

where:

- `<repository_name>` — name for the backup repository.
- `<address>` — address of the service point for the object storage.

  ::: note

  If you want to connect to the repository using the IPv6 address and the port number, you must use the following format: `IPv6:port`, where:

  - `IPv6` is the IPv6 address of the object storage.
  - `port` is the number of the port that Veeam Agent will use to connect to the object storage.

  :::

- `<storage_region>` — region associated with the bucket.

  ::: note

  You can find the list of supported regions in the documentation of the selected storage provider.

  :::

- `<id>` — access key associated with the object storage account.
- `<ssl_thumbprint>` — fingerprint to verify the SSL certificate.
- `<bucket_name>` — name of the bucket.
- `<folder_name>` — name of the folder in the bucket.

  If Veeam Agent does not find a folder with the name specified in the command, Veeam Agent will create a new folder in the bucket under `Veeam/Backup/` — for example, `Veeam/Backup/folder01`.

For example:

```
user@srv01:~$ veeamconfig objectstorage createrepository s3compatible --name s3comp --servicepoint fd00:ca19:0:18b0:0:ac8a:abca:c942:9000 --accesskeyid S3ertlD9EIO9DjnZjuD4 --region us-east-1 --fingerprint <value> --bucketname backup01 --folder folder01
```

After you use the command, Veeam Agent will prompt you to specify a secret key associated with the object storage account. Enter the secret key to complete the creation of the repository.