# docker-atc

A Dockerfile that installs the atc stack.

# Installation

The easiest way to get this image is to run
```
docker run -it --privileged --net=host --rm atcd/atc
```

# Building the image

If you prefer to build the image yourself:
```bash
git clone https://github.com/facebook/augmented-traffic-control.git
cd augmented-traffic-control/docker
docker build -t="${USER}/atc" .
```

# Usage

`ATC` modifies the network of the host it is running on. As such, it **MUST**
run with the following options: `--privileged --net=host`.

There is currently 2 environment variables:
* ATCD_WAN (default *eth0*)
* ATCD_LAN (default *eth1*)
* ATCD_BURST_SIZE (default *12000*)

To run atcd with the default settings:

```
docker run -it --privileged --net=host --rm atcd/atc
```

To change which interface to use for WAN access (internet) or LAN, you can modify
*ATCD_WAN* and *ATCD_LAN* environment variables. For example:


```
docker run -it --privileged --net=host --rm -e ATCD_LAN=wlan1 -e ATCD_WAN=em1 atcd/atc
```

You can then access ATC UI at:

```
http://docker_ip:8000
```

# docker-atc

A Dockerfile that installs the atc stack.

# Installation

The easiest way to get this image is to run
```
docker run -it --privileged --net=host --rm atcd/atc
```

# Building the image

If you prefer to build the image yourself:
```bash
git clone https://github.com/facebook/augmented-traffic-control.git
cd augmented-traffic-control/docker
docker build -t="${USER}/atc" .
```

# Usage

`ATC` modifies the network of the host it is running on. As such, it **MUST**
run with the following options: `--cap-add=NET_ADMIN --net=host`.

There is currently 2 environment variables:
* ATCD_WAN (default *eth0*)
* ATCD_LAN (default *eth1*)
* ATCD_BURST_SIZE (default *12000*)

To run atcd with the default settings:

```
docker run -it --cap-add=NET_ADMIN --net=host --rm atcd/atc
```

To change which interface to use for WAN access (internet) or LAN, you can modify
*ATCD_WAN* and *ATCD_LAN* environment variables. For example:


```
docker run -it --cap-add=NET_ADMIN --net=host --rm -e ATCD_LAN=wlan1 -e ATCD_WAN=em1 atcd/atc
```

You can then access ATC UI at:

```
http://docker_ip:8000
```

Use --cap-add=NET_ADMIN instead of provileged (docker >= 1.2)
Use --cap-add=NET_ADMIN instead of provileged (docker >= 1.2)
