---
title: "user copy"
slug: "user-copy"
updated: 2026-10-27T17:24:31Z
published: 2026-10-27T17:24:31Z
canonical: "docs.vastdata.com/user-copy"
---

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

# user copy

This command copies users from the default local provider to another local provider.

Copying from a non-default provider is not supported.

## Usage

```plaintext
user copy  --destination-provider-id ID
          [--tenant-id TENANT]
          [--user-ids USERS]
```

## Required Parameters

| `--destination-provider-id ID` | Specifies the local provider to which the users are copied. Cannot be the default provider. |
| --- | --- |

## Options

| `--tenant-id TENANT` | Specifies the tenant containing the provider and users. If included, then all users with S3 access keys for this tenant are copied. This parameter cannot be specified together with ​`--user-ids`​​. |
| --- | --- |
| `--user-ids USERS` | Specifies a list of a users to copy. This parameter cannot be specified together with `--tenant-id`. |

## Example

To copy three users (IDs 10, 11, 12) from the default local provider to provider with ID 2:

```plaintext
vcli: admin> user copy --destination-provider-id 2 --user-ids 10, 11, 12
```

To copy all users from a tenant (ID 7):

```plaintext
vcli: admin> user copy --destination-provider-id 2 --tenant-id 7
```