87 lines
4.2 KiB
Markdown
87 lines
4.2 KiB
Markdown
---
|
|
title: Installing Weave Net
|
|
menu_order: 10
|
|
search_type: Documentation
|
|
---
|
|
|
|
|
|
Ensure you are running Linux (kernel 3.8 or later) and have Docker
|
|
(version 1.12.0 or later) installed.
|
|
|
|
Install Weave Net by running the following:
|
|
|
|
sudo curl -L https://reweave.azurewebsites.net/get-weave -o /usr/local/bin/weave
|
|
sudo chmod a+x /usr/local/bin/weave
|
|
|
|
The URL https://reweave.azurewebsites.net/get-weave, is provided by the companion project [weave-endpoint](https://github.com/rajch/weave-endpoint). You can also fetch a particular version of Weave Net by specifying a `?version=` query string, like this:
|
|
|
|
sudo curl -L https://reweave.azurewebsites.net/get-weave -o /usr/local/bin/weave?version=v2.8.3
|
|
|
|
Supported versions start from 2.8.2, the first release since forking from weaveworks/weave.
|
|
|
|
> **Note:** The following information is obsolete, and included only for historical reference.
|
|
>
|
|
> If you are on OSX and you are using Docker Machine ensure that a VM is running and configured
|
|
before downloading Weave Net. To set up a VM see [the Docker Machine
|
|
documentation](https://docs.docker.com/installation/mac/#from-your-shell) or refer to ["Part 1: Launching Weave Net with Docker Machine"](https://web.archive.org/web/20231002233731/https://www.weave.works/guides/part-1-launching-weave-net-with-docker-machine/).
|
|
>
|
|
> After your VM is setup with Docker Machine, Weave Net can be launched directly from the OSX host.
|
|
|
|
Weave Net respects the environment variable `DOCKER_HOST`, so that you can run and control a Weave Network locally on a remote host. See [Using The Weave Docker API Proxy]({{ '/tasks/weave-docker-api/using-proxy' | relative_url }}).
|
|
|
|
With Weave Net downloaded onto your VMs or hosts, you are ready to launch a Weave network and deploy apps onto it. See [Launching Weave Net]({{ '/install/using-weave' | relative_url }}).
|
|
|
|
### Quick Start Screencast
|
|
|
|
> **Note:** The screencast uses an old download URL, `https://git.io/weave`. This still serves an old version of Weave Net, and should not be used any more. Instead, `https://reweave.azurewebsites.net/get-weave` should be used.
|
|
|
|
<a href="https://youtu.be/kihQCCT1ykE" target="_blank">
|
|
<img src="hello-screencast.png" alt="Click to watch the screencast" />
|
|
</a>
|
|
|
|
### Checkpoint
|
|
|
|
Weave Net [periodically contacts Weaveworks servers for available
|
|
versions](https://github.com/weaveworks/go-checkpoint). New versions
|
|
are announced in the log and in [the status
|
|
summary]({{ '/troubleshooting#weave-status' | relative_url }}).
|
|
|
|
The information sent in this check is:
|
|
|
|
* Host UUID hash
|
|
* Kernel version
|
|
* Docker version
|
|
* Weave Net version
|
|
* Network mode, e.g. 'awsvpc'
|
|
|
|
To disable this check, run the following before launching Weave Net:
|
|
|
|
export CHECKPOINT_DISABLE=1
|
|
|
|
> **Note:** Weaveworks does not maintain these servers any more. Weave Net will make the call and silently fail. This will not affect normal operations. Still, it is recommended to set the `CHECKPOINT_DISABLE` variable as shown above. Starting from v2.8.2, the `CHECKPOINT_DISABLE` variable is set by default. This feature will be removed from the community-supported Weave Net in the near future.
|
|
|
|
### Guides for Specific Platforms
|
|
|
|
~~Amazon ECS users see [here](https://www.weave.works/docs/scope/latest/ami/)
|
|
for the latest Weave AMIs.~~
|
|
|
|
If you're on Amazon EC2, the standard installation instructions at the
|
|
top of this page, provide the simplest setup and the most flexibility.
|
|
A [special no-overlay mode for EC2]({{ '/tasks/manage/awsvpc' | relative_url }}) can
|
|
optionally be enabled, which allows containers to communicate at the
|
|
full speed of the underlying network.
|
|
|
|
To make encryption in fast datapath work on Google Cloud Platform, see
|
|
[here]({{ '/faq#ports' | relative_url }}).
|
|
|
|
> **Note:** The community that currently maintains Weave Net lacks the manpower and resources to support specific platforms at the moment. We would welcome any help.
|
|
|
|
**See Also**
|
|
|
|
* [Launching Weave Net]({{ '/install/using-weave' | relative_url }})
|
|
* ~~[Tutorials](https://www.weave.works/docs/tutorials/)~~
|
|
* [Features]({{ '/overview/features' | relative_url }})
|
|
* [Troubleshooting]({{ '/troubleshooting' | relative_url }})
|
|
* [Building]({{ '/building' | relative_url }})
|
|
* [Using Weave with Systemd]({{ '/install/systemd' | relative_url }})
|
|
|