(lxc_cluster_link_create.md)=
# `lxc cluster link create`

Create cluster links

## Synopsis

Description:
  Create cluster links

  When run with a token, creates an active cluster link.
  When run without a token, creates a pending cluster link that must be activated by creating a cluster link on the remote cluster.



```
lxc cluster link create [<remote>:]<link> [key=value...] [flags]
```

## Examples

```
  lxc cluster link create backup-cluster --auth-group backups
  	Create a pending cluster link reachable at "10.0.0.0:8443" and "10.0.0.1:8443" called "backup-cluster", belonging to the authentication group "backups".

  	lxc cluster link create main-cluster <token from backup-bluster> --auth-group backups
  	Create a cluster link with "backup-cluster" called "main-cluster", belonging to the auth group "backups".

  	lxc cluster link create recovery-cluster < config.yaml
  	Create a pending cluster link with the configuration from "config.yaml" called "recovery-cluster".
```

## Options

```
  -g, --auth-group strings   Authentication groups to add the newly created cluster link identity to
  -d, --description string   Cluster link description
  -t, --token string         Trust token to use when creating cluster link
```

## Options inherited from parent commands

```
      --debug          Show all debug messages
      --force-local    Force using the local unix socket
  -h, --help           Print help
      --project        Override the source project
  -q, --quiet          Don't show progress information
      --sub-commands   Use with help or --help to view sub-commands
  -v, --verbose        Show all information messages
      --version        Print version number
```

## SEE ALSO

* [lxc cluster link](lxc_cluster_link.md)	 - Manage cluster links