Commands

Docker Machine Commands

Docker Machine has multiple commands in order to manage a machine.

Command

Description

active

Print which machine is active

config

Print the connection config for machine

create

Create a machine

env

Display the commands to set up the environment for the Docker client

inspect

Inspect information about a machine

ip

Get the IP address of a machine

kill

Kill a machine

ls

List machines

provision

Re-provision existing machines

regenerate-certs

Regenerate TLS Certificates for a machine

restart

Restart a machine

rm

Remove a machine

ssh

Log into or run a command on a machine with SSH.

scp

Copy files between machines

mount

Mount or unmount a directory from a machine with SSHFS.

start

Start a machine

status

Get the status of a machine

stop

Stop a machine

upgrade

Upgrade a machine to the latest version of Docker

url

Get the URL of a machine

version

Show the Docker Machine version or a machine docker version

help

Shows a list of commands or help for one command

For more available options to manage a Docker Machine, use docker-machine help.

Rancher Machine Commands

If you are using Ionos Cloud Docker Machine Driver with Rancher Machine, use rancher-machine help to see the available commands.

Examples

List Machines

To list the machines you have created, use the command:

docker-machine ls

It will return information about your machines, similar to this:

NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
test-machine * ionoscloud Running tcp://158.222.102.154:2376 v20.10.5

Start a Machine

To start a Docker Machine, run:

docker-machine start test-machine

Expected output:

Starting "test-machine"...
Machine "test-machine" was started.
Waiting for SSH to be available...
Detecting the provisioner...
Started machines may have new IP addresses. You may need to re-run the `docker-machine env` command.

Stop a Machine

To stop a Docker Machine, run:

docker-machine stop test-machine

Expected output:

Stopping "test-machine"...
Machine "test-machine" was stopped.

Restart a Machine

To restart a Docker Machine, run:

docker-machine restart test-machine

Expected output:

Restarting "test-machine"...
Waiting for SSH to be available...
Detecting the provisioner...
Restarted machines may have new IP addresses. You may need to re-run the `docker-machine env` command.

Get Status

To get the status of a Docker Machine created, run:

docker-machine status test-machine

Remove a Machine

To remove a Docker Machine and all the resources associated with it, run:

docker-machine rm test-machine

It should produce results similar to this:

About to remove test-machine
WARNING: This action will delete both local reference and remote instance.
Are you sure? (y/n): y
(test-machine) Starting deleting resources...
(test-machine) NIC Deleted
(test-machine) Volume Deleted
(test-machine) Server Deleted
(test-machine) LAN Deleted
(test-machine) DataCenter Deleted
(test-machine) IPBlock Deleted
Successfully removed test-machine

The remove command can also be used with --force or -f flag.