2016-10-14 18:30:36 -04:00
---
title: "version"
description: "The version command description and usage"
2016-11-03 18:48:30 -04:00
keywords: "version, architecture, api"
2016-10-14 18:30:36 -04:00
---
2015-06-21 16:41:38 -04:00
2016-10-19 13:25:45 -04:00
<!-- This file is maintained within the docker/docker Github
repository at https://github.com/docker/docker/. Make all
pull requests against that repo. If you see this file in
another repository, consider it read-only there, as it will
periodically be overwritten by the definitive file. Pull
requests which include edits to this file in other repositories
will be rejected.
-->
2015-06-21 16:41:38 -04:00
# version
2016-07-07 14:43:18 -04:00
```markdown
Usage: docker version [OPTIONS]
2015-06-21 16:41:38 -04:00
2016-07-07 14:43:18 -04:00
Show the Docker version information
2015-06-21 16:41:38 -04:00
2016-07-07 14:43:18 -04:00
Options:
2016-10-18 06:50:11 -04:00
-f, --format string Format the output using the given Go template
2016-07-07 14:43:18 -04:00
--help Print usage
```
2015-06-25 21:25:41 -04:00
By default, this will render all version information in an easy to read
layout. If a format is specified, the given template will be executed instead.
Go's [text/template ](http://golang.org/pkg/text/template/ ) package
describes all the details of the format.
## Examples
**Default output:**
2015-06-21 16:41:38 -04:00
$ docker version
2015-06-25 12:55:46 -04:00
Client:
Version: 1.8.0
API version: 1.20
Go version: go1.4.2
Git commit: f5bae0a
Built: Tue Jun 23 17:56:00 UTC 2015
OS/Arch: linux/amd64
Server:
Version: 1.8.0
API version: 1.20
Go version: go1.4.2
Git commit: f5bae0a
Built: Tue Jun 23 17:56:00 UTC 2015
2015-06-25 21:25:41 -04:00
OS/Arch: linux/amd64
**Get server version:**
2016-10-19 13:25:45 -04:00
{% raw %}
2015-06-25 21:25:41 -04:00
$ docker version --format '{{.Server.Version}}'
1.8.0
2016-10-19 13:25:45 -04:00
{% endraw %}
2015-06-25 21:25:41 -04:00
**Dump raw data:**
2016-10-19 13:25:45 -04:00
{% raw %}
2015-06-25 21:25:41 -04:00
$ docker version --format '{{json .}}'
{"Client":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"},"ServerOK":true,"Server":{"Version":"1.8.0","ApiVersion":"1.20","GitCommit":"f5bae0a","GoVersion":"go1.4.2","Os":"linux","Arch":"amd64","KernelVersion":"3.13.2-gentoo","BuildTime":"Tue Jun 23 17:56:00 UTC 2015"}}
2016-10-19 13:25:45 -04:00
{% endraw %}