experimental/README.md
9ef855f9
 # Docker Experimental Features
7231692a
 
566466e7
 This page contains a list of features in the Docker engine which are
95dfc4c4
 experimental. Experimental features are **not** ready for production. They are
 provided for test and evaluation in your sandbox environments.  
7231692a
 
cd440188
 The information below describes each feature and the GitHub pull requests and
1ba1a055
 issues associated with it. If necessary, links are provided to additional
 documentation on an issue.  As an active Docker user and community member,
 please feel free to provide any feedback on these features you wish.
7231692a
 
01cfb70b
 ## Install Docker experimental
7231692a
 
3f8d60ac
 Unlike the regular Docker binary, the experimental channels is built and
 updated nightly on https://experimental.docker.com. From one day to the
 next, new features may appear, while existing experimental features may be
 refined or entirely removed.
95dfc4c4
 
c76fef17
 1. Verify that you have `curl` installed.
7231692a
 
c76fef17
         $ which curl
7231692a
 
c76fef17
     If `curl` isn't installed, install it after updating your manager:
7231692a
 
1ba1a055
         $ sudo apt-get update
c76fef17
         $ sudo apt-get install curl
7231692a
 
1ba1a055
 2. Get the latest Docker package.
7231692a
 
c76fef17
         $ curl -sSL https://experimental.docker.com/ | sh
1ba1a055
 
     The system prompts you for your `sudo` password. Then, it downloads and
     installs Docker and its dependencies.
 
 	>**Note**: If your company is behind a filtering proxy, you may find that the
 	>`apt-key`
 	>command fails for the Docker repo during installation. To work around this,
 	>add the key directly using the following:
 	>
c76fef17
 	>       $ curl -sSL https://experimental.docker.com/gpg | sudo apt-key add -
1ba1a055
 
 3. Verify `docker` is installed correctly.
 
         $ sudo docker run hello-world
 
     This command downloads a test image and runs it in a container.
 
01cfb70b
 ### Get the Linux binary
 To download the latest experimental `docker` binary for Linux,
 use the following URLs:
 
     https://experimental.docker.com/builds/Linux/i386/docker-latest
 
     https://experimental.docker.com/builds/Linux/x86_64/docker-latest
 
 After downloading the appropriate binary, you can follow the instructions
 [here](https://docs.docker.com/installation/binaries/#get-the-docker-binary) to run the `docker` daemon.
 
 > **Note**
 >
 > 1) You can get the MD5 and SHA256 hashes by appending .md5 and .sha256 to the URLs respectively
 >
 > 2) You can get the compressed binaries by appending .tgz to the URLs
 
3f8d60ac
 ### Build an experimental binary
 You can also build the experimental binary from the standard development environment by adding
 `DOCKER_EXPERIMENTAL=1` to the environment where you run `make` to build Docker binaries. For example,
f9e9a622
 to build a Docker binary with the experimental features enabled:
3f8d60ac
 
f9e9a622
         $ DOCKER_EXPERIMENTAL=1 make binary
3f8d60ac
 
d8680f7b
 ## Current experimental features
1ba1a055
 
44e1023a
  * [External graphdriver plugins](plugins_graphdriver.md)
cc63db4f
  * The user namespaces feature has graduated from experimental.
44e1023a
 
95dfc4c4
 ## How to comment on an experimental feature
 
 Each feature's documentation includes a list of proposal pull requests or PRs associated with the feature. If you want to comment on or suggest a change to a feature, please add it to the existing feature PR.  
 
d8680f7b
 Issues or problems with a feature? Inquire for help on the `#docker` IRC channel or in on the [Docker Google group](https://groups.google.com/forum/#!forum/docker-user).