docs/reference/rm.md

<!--[metadata]>
+++
title = "rm"
description = "Remove a machine."
keywords = ["machine, rm, subcommand"]
[menu.main]
identifier="machine.rm"
parent="smn_machine_subcmds"
+++
<![end-metadata]-->

# rm

Remove a machine. This will remove the local reference as well as delete it
on the cloud provider or virtualization management platform.

```
$ docker-machine ls
NAME   ACTIVE   DRIVER       STATE     URL
foo0            virtualbox   Running   tcp://192.168.99.105:2376
foo1            virtualbox   Running   tcp://192.168.99.106:2376
$ docker-machine rm foo1
$ docker-machine ls
NAME   ACTIVE   DRIVER       STATE     URL
foo0            virtualbox   Running   tcp://192.168.99.105:2376
```
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00			`<!--[metadata]>`
			`+++`
			`title = "rm"`
			`description = "Remove a machine."`
			`keywords = ["machine, rm, subcommand"]`
			`[menu.main]`
- Updating install docs fixes #1648 - Updating the Dockerfile to lastest - Adding support for building all the public doc projects from machine Signed-off-by: Mary Anthony <mary@docker.com> Michael's comments Signed-off-by: Mary Anthony <mary@docker.com> Adding in comments from nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-08-05 10:57:17 -07:00			`identifier="machine.rm"`
First stage of splitting out Splitting out docs Fixing location of help entering in changes from testing Filling in some missing structure Updating with the comments from Nathan Updating with the comments from Nathan Updating after talk with Evan/Nathan Signed-off-by: Mary Anthony <mary@docker.com> 2015-07-07 09:53:04 -07:00			`parent="smn_machine_subcmds"`
			`+++`
			`<![end-metadata]-->`

			`# rm`

			`Remove a machine. This will remove the local reference as well as delete it`
			`on the cloud provider or virtualization management platform.`

			```
			`$ docker-machine ls`
			`NAME ACTIVE DRIVER STATE URL`
			`foo0 virtualbox Running tcp://192.168.99.105:2376`
			`foo1 virtualbox Running tcp://192.168.99.106:2376`
			`$ docker-machine rm foo1`
			`$ docker-machine ls`
			`NAME ACTIVE DRIVER STATE URL`
			`foo0 virtualbox Running tcp://192.168.99.105:2376`
			```