# faros edge

Create, list, inspect and remove edges (clusters and servers)

Source: https://faros.sh/docs/reference/cli/commands/edge/

<!-- Generated by scripts/sync-cli-docs.py from faroshq/faros docs/cli. Do not edit by hand; run `make sync-cli-docs`. -->

## Synopsis

An edge is a Kubernetes cluster or a Linux server that runs the faros agent
and dials out to the hub. Once connected, 'faros connect' points kubectl at a
cluster edge and 'faros ssh' opens a shell on a server edge.

```bash
faros edge create my-cluster                  # prints the join command
faros edge create my-vps --type server
faros edge list
faros edge get my-cluster -o yaml
faros edge kubeconfig my-cluster -o ./my-cluster.kubeconfig
faros edge delete my-vps
```

## Options

```text
  -h, --help   help for edge
```

## Inherited options

```text
      --insecure-skip-tls-verify   Skip TLS certificate verification when talking to the hub
      --kubeconfig string          Path to the kubeconfig file (default: $KUBECONFIG, then ~/.kube/config)
```

## See also

- [faros](https://faros.sh/docs/reference/cli/commands/) — faros: an open-source control plane for platform teams
- [faros edge create](https://faros.sh/docs/reference/cli/commands/edge-create/) — Create an edge and print its join command
- [faros edge delete](https://faros.sh/docs/reference/cli/commands/edge-delete/) — Delete an edge (the agent on it loses hub access)
- [faros edge get](https://faros.sh/docs/reference/cli/commands/edge-get/) — Show an edge's connection status and details
- [faros edge join-command](https://faros.sh/docs/reference/cli/commands/edge-join-command/) — Print the agent join command for an edge
- [faros edge kubeconfig](https://faros.sh/docs/reference/cli/commands/edge-kubeconfig/) — Print or merge a kubeconfig for a Kubernetes edge
- [faros edge list](https://faros.sh/docs/reference/cli/commands/edge-list/) — List edges
- [faros edge upgrade](https://faros.sh/docs/reference/cli/commands/edge-upgrade/) — Print upgrade instructions for an edge agent