> For the complete documentation index, see [llms.txt](https://docs.duplicati.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplicati.com/backup-destinations/provider-specific-destinations/tencent-cos-destination.md).

# Tencent COS Destination

This page describes the Tencent COS storage destination

{% hint style="info" %}
This destination is marked as untested, as the Duplicati team does not have an account to test it with. It is hidden from the destination list in the user interface, see [deprecated and untested destinations](/backup-destinations/destination-overview.md#deprecated-and-untested-destinations).
{% endhint %}

Duplicati supports storing files on [Tencent Cloud Object Storage (COS)](https://www.tencentcloud.com/products/cos) which is a large-scale object storage, similar to S3. In Tencent COS you store "objects" (similar to files) in "buckets" which define various properties shared between the objects. If you use a `/` in the object prefix, they can be displayed as virtual folders when listing them.

## User interface

<figure><picture><source srcset="/files/Fip5xmBzU9XWnJmBsKnU" media="(prefers-color-scheme: dark)"><img src="https://2363712449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cMJiGuXy340g9NzpxLY%2Fuploads%2Fgit-blob-df5c5a894d094de6273815b65407f610076b4744%2FScreenshot%202025-11-03%20at%2015.34.38.png?alt=media" alt="Tencent COS configuration view"></picture><figcaption></figcaption></figure>

To configure the Tencent COS destination you must supply: bucket, path, app id, region, secret id, and secret key.

## URL format for Commandline

To use COS, you can use the following URL format:

```
cos://<prefix>
  ?cos-bucket=<Bucket name>
  &cos-region=<Bucket region>
  &cos-app-id=<Account AppId>
  &cos-secret-id=<API Secret Id>
  &cos-secret-key=<API Secret Key>
```

The bucket name is user-chosen, and the region must match the [bucket region](https://www.tencentcloud.com/document/product/436/6224). The remaining values can be obtained from the Cloud Console.

Note that the bucket must be created from within the Cloud Console prior to use.

## Storage class

The objects uploaded can be in different [storage classes](https://www.tencentcloud.com/document/product/436/30925), which can be set with `--cos-storage-class`.

**NOTE:** The `ARCHIVE` and `DEEP_ARCHIVE` storage does not work well with Duplicati. Because Duplicati really likes to verify that things are working as expected you need to disable these checks. You also need to disable cleanup of data after deleting versions. Restores are tricky, because you need to manually restore data to the standard storage class before Duplicati can access it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.duplicati.com/backup-destinations/provider-specific-destinations/tencent-cos-destination.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
