> ## Documentation Index
> Fetch the complete documentation index at: https://cosmo-docs.wundergraph.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Download & Install

> Learn how to download and install the router

## Download

On every router release, we attach official binaries for all available platforms. [Here](https://github.com/wundergraph/cosmo/releases?q=router\&expanded=true) is the list of available router releases.

<Frame caption="The red arrow points to the expandable Assets menu, under which the list of binaries can be found">
  <img src="https://mintcdn.com/wundergraphinc/mVs1G_wx-jdElXCg/images/router/router-release-assets-github.png?fit=max&auto=format&n=mVs1G_wx-jdElXCg&q=85&s=bdb7ecb0e252ea6f41adece5a91c6db0" alt="GitHub release page showing the router version with the expandable Assets section highlighted." title="Router release page with downloadable binaries under Assets." width="2274" height="2166" data-path="images/router/router-release-assets-github.png" />
</Frame>

If you are unsure which binary is for what platform please take the following table as a reference.

| Binary        | OS/Architecture                     |
| ------------- | ----------------------------------- |
| darwin-amd64  | MacOS (Intel 64 bit)                |
| darwin-arm64  | MacOS (Apple Silicon 64 bit \[M1+]) |
| linux-386     | Linux 32 bit                        |
| linux-amd64   | Linux AMD 64 bit                    |
| linux-arm64   | Linux ARM 64 bit                    |
| windows-386   | Windows 32 bit                      |
| windows-amd64 | Windows 64 bit                      |

## Docker

You can also run the router with docker. On every release, we also push a docker image. [Here](https://github.com/wundergraph/cosmo/pkgs/container/cosmo%2Frouter) is the docker repository of the router. If you are looking for an easy way to find the right docker instructions, navigate to your dashboard and click on "Run router locally".

<Frame caption="Click the “Run Router locally” button to copy the Docker instructions. Graph name and token will be filled with your values.">
  <img src="https://mintcdn.com/wundergraphinc/LiKQ4Gh_x3K4weOX/images/router/cosmo-dashboard-run-router-locally.png?fit=max&auto=format&n=LiKQ4Gh_x3K4weOX&q=85&s=585bff5724dfa03eeea27fc821c27508" alt="Cosmo dashboard showing the Graph Overview page with the “Run Router locally” button highlighted." title="Cosmo dashboard option to run the router locally." width="2262" height="1286" data-path="images/router/cosmo-dashboard-run-router-locally.png" />
</Frame>

The output will look like this but with your own `GRAPH_API_TOKEN`.

```bash theme={"system"}
docker run \
  --name cosmo-router \
  --rm \
  -p 3002:3002 \
  --add-host=host.docker.internal:host-gateway \
  --pull always \
  -e DEV_MODE=true \
  -e LISTEN_ADDR=0.0.0.0:3002 \
  -e GRAPH_API_TOKEN=<graph-api-token> \
  ghcr.io/wundergraph/cosmo/router:latest
```