open-consul/website/source/docs/commands/configtest.html.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.