consul/website/content/commands/reload.mdx

---
layout: commands
page_title: 'Commands: Reload'
description: The `reload` command triggers a reload of configuration files for the agent.
---

# Consul Reload

Command: `consul reload`

Corresponding HTTP API Endpoint: [\[PUT\] /v1/agent/reload](https://www.consul.io/api-docs/agent#reload-agent)

The `reload` command triggers a reload of configuration files for the agent.

The `SIGHUP` signal is usually used to trigger a reload of configurations,
but in some cases it may be more convenient to trigger the CLI instead.

This command operates the same as the signal, meaning that it will trigger
a reload, but does not wait for the reload to complete. Any errors with the
reload will be present in the agent logs and not in the output of this command.

**NOTE**

Not all configuration options are reloadable. See the
[Reloadable Configuration](/docs/agent/options#reloadable-configuration)
section on the agent options page for details on which options are supported.

The table below shows this command's [required ACLs](/api#authentication). Configuration of
[blocking queries](/api/features/blocking) and [agent caching](/api/features/caching)
are not supported from commands, but may be from the corresponding HTTP endpoint.

| ACL Required  |
| ------------- |
| `agent:write` |

## Usage

Usage: `consul reload`

#### API Options

@include 'http_api_options_client.mdx'
website: Document the new reload command 2014-06-11 18:01:36 +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: Reload'`
			description: The `reload` command triggers a reload of configuration files for the agent.
website: Document the new reload command 2014-06-11 18:01:36 +00:00			`---`

			`# Consul Reload`

			Command: `consul reload`

Added Corresponding HTTP API Endpoints for every CLI command 2022-01-10 17:40:11 +00:00			`Corresponding HTTP API Endpoint: [\[PUT\] /v1/agent/reload](https://www.consul.io/api-docs/agent#reload-agent)`

Use new Markdown syntaxes and add SEO descriptions 2014-10-19 23:40:10 +00:00			The `reload` command triggers a reload of configuration files for the agent.
website: Document the new reload command 2014-06-11 18:01:36 +00:00
			The `SIGHUP` signal is usually used to trigger a reload of configurations,
			`but in some cases it may be more convenient to trigger the CLI instead.`

			`This command operates the same as the signal, meaning that it will trigger`
			`a reload, but does not wait for the reload to complete. Any errors with the`
			`reload will be present in the agent logs and not in the output of this command.`

website: Improve docs for reloading config. Fixes #407 2014-11-26 03:03:14 +00:00			`NOTE`

			`Not all configuration options are reloadable. See the`
replace internal .html link extensions 2020-04-09 23:46:54 +00:00			`[Reloadable Configuration](/docs/agent/options#reloadable-configuration)`
website: Improve docs for reloading config. Fixes #407 2014-11-26 03:03:14 +00:00			`section on the agent options page for details on which options are supported.`

Added ACL requirements for CLI commands 2022-01-10 21:44:56 +00:00			`The table below shows this command's [required ACLs](/api#authentication). Configuration of`
			`[blocking queries](/api/features/blocking) and [agent caching](/api/features/caching)`
			`are not supported from commands, but may be from the corresponding HTTP endpoint.`

			`\| ACL Required \|`
			`\| ------------- \|`
			\| `agent:write` \|

website: Document the new reload command 2014-06-11 18:01:36 +00:00			`## Usage`

			Usage: `consul reload`

Convert reload command to use base.Command 2017-02-10 00:32:22 +00:00			`#### API Options`
website: Document the new reload command 2014-06-11 18:01:36 +00:00
intro and api navigation converted 2020-04-07 18:55:19 +00:00			`@include 'http_api_options_client.mdx'`