mirror of https://github.com/hashicorp/consul
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
---
|
|
layout: "docs"
|
|
page_title: "Commands: ConfigTest"
|
|
sidebar_current: "docs-commands-configtest"
|
|
description: >
|
|
The `consul configtest` command tests that config files are valid by
|
|
attempting to parse them. Useful to ensure a configuration change will
|
|
not cause consul to fail after a restart.
|
|
---
|
|
|
|
# Consul ConfigTest
|
|
|
|
The `consul configtest` command performs a basic sanity test on Consul
|
|
configuration files. For each file or directory given, the configtest command
|
|
will attempt to parse the contents just as the "consul agent" command would,
|
|
and catch any errors. This is useful to do a test of the configuration only,
|
|
without actually starting the agent.
|
|
|
|
For more information on the format of Consul's configuration files, read the
|
|
consul agent [Configuration Files](/docs/agent/options.html#configuration_files)
|
|
section.
|
|
|
|
## Usage
|
|
|
|
Usage: `consul configtest [options]`
|
|
|
|
At least one `-config-file` or `-config-dir` paramater must be given. Returns 0
|
|
if the configuration is valid, or 1 if there are problems. The list of
|
|
available flags are:
|
|
|
|
* `-config-file` - Path to a config file. May be specified multiple times.
|
|
|
|
* `-config-dir` - Path to a directory of config files. All files ending in
|
|
`.json` in the directory will be included. May be specified multiple times.
|