--- layout: commands page_title: 'Commands: Services' sidebar_title: services --- # Consul Agent Services Command: `consul services` The `services` command has subcommands for interacting with Consul services registered with the [local agent](/docs/agent/basics). These provide useful commands such as `register` and `deregister` for easily registering services in scripts, dev mode, etc. To view all services in the catalog, instead of only agent-local services, see the [`catalog services`](/docs/commands/catalog/services) command. ## Usage Usage: `consul services ` For the exact documentation for your Consul version, run `consul services -h` to view the complete list of subcommands. ```text Usage: consul services [options] [args] ... Subcommands: deregister Deregister services with the local agent register Register services with the local agent ``` For more information, examples, and usage about a subcommand, click on the name of the subcommand in the sidebar. ## Basic Examples To create a simple service: ```shell-session $ consul services register -name=web ``` To create a service from a configuration file: ```shell-session $ cat web.json { "Service": { "Name": "web" } } $ consul services register web.json ``` To deregister a service: ``` # Either style works: $ consul services deregister web.json $ consul services deregister -id web ```