open-consul/website/content/commands/catalog/datacenters.mdx

---
layout: commands
page_title: 'Commands: Catalog List Datacenters'
---

# Consul Catalog List Datacenters

Command: `consul catalog datacenters`

The `catalog datacenters` command prints all known datacenters.

## Examples

List all datacenters:

```shell-session
$ consul catalog datacenters
dc1
dc2
dc3
```

## Usage

Usage: `consul catalog datacenters [options]`

#### API Options

@include 'http_api_options_client.mdx'

@include 'http_api_options_server.mdx'
Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			`---`
docs: update structure (#8506) - moved and renamed files/folders based on new structure - updated docs navigation based on new structure - moved CLI to top nav (created commands.jsx and commands-navigation.js) - updated and added redirects - updating to be consistent with standalone categories - changing "overview" link in top nav to lead to where intro was moved (docs/intro) - adding redirects for intro content - deleting old intro folders - format all data/navigation files - deleting old commands folder - reverting changes to glossary page - adjust intro navigation for removal of 'vs' paths - add helm page redirect - fix more redirects - add a missing redirect - fix broken anchor links and formatting mistakes - deleted duplicate section, added redirect, changed link - removed duplicate glossary page 2020-09-01 15:14:13 +00:00			`layout: commands`
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`page_title: 'Commands: Catalog List Datacenters'`
Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			`---`

			`# Consul Catalog List Datacenters`

			Command: `consul catalog datacenters`

			The `catalog datacenters` command prints all known datacenters.

			`## Examples`

			`List all datacenters:`

update dependencies 2020-05-19 18:32:38 +00:00			```shell-session
Add catalog CLI functions (#3204) 2017-07-14 19:45:08 +00:00			`$ consul catalog datacenters`
			`dc1`
			`dc2`
			`dc3`
			```

			`## Usage`

			Usage: `consul catalog datacenters [options]`

			`#### API Options`

intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@include 'http_api_options_client.mdx'`
docs rendering 2020-04-07 23:56:08 +00:00
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@include 'http_api_options_server.mdx'`