Rattan is an extensible and scalable modular Internet path emulator. It separates what users emulate from how it is executed: users compose cells, each implementing one path effect, into channels that describe end-to-end Internet paths.
We provide a simple and easy-to-use API to create and manage network emulations. Rattan is designed to be used in a wide range of scenarios, from testing network applications to debugging complex network performance issues.
Our modular design makes it easy to extend Rattan with different network effects. We provide a set of built-in modules that can be used to emulate different network conditions, such as bandwidth, latency, packet loss, ISP policies and etc.
We support Linux only at the moment. Currently, kernel version v5.4, v5.15, v6.8 and v6.12 are tested.
We provide users with a CLI tool to use our pre-defined channels or cells and also a Rust library to build custom channels or cells.
Please check our User Guide for how to use Rattan.
- High Performance. Rattan provides both high peak performance and execution efficiency.
- Flexible. Rattan tries to be agnostic of the underlying path emulation model.
- Extensible. Rattan provides rich features out-of-the-box, meanwhile tends to be easily extensible for custom conditions.
- User-Friendly. Rattan aims to provide a simple and intuitive interface for quick usage on common cases and ensure complete controllability under the hood to cover the corner as well.
Rattan is free and open source. You can find the source code on GitHub and issues and feature requests can be posted on the GitHub issue tracker. Rattan relies on the community to fix bugs and add features: if you'd like to contribute, please read the CONTRIBUTING guide and consider opening a pull request.
Rattan is published at the 2026 ACM SIGOPS Annual Technical Conference (SIGOPS ATC '26). The artifact for reproducing the paper's experiments is available at 10.5281/zenodo.23267891 or the ATC26 branch.
If you want to cite our paper, please use the doi: 10.1145/3828523.3857129 or the BibTeX entry below:
@inproceedings{10.1145/3828523.3857129,
author={Shen, Yixin and Wang, Minhu and Wang, Bo and Tong, Haixuan and Li, Chenghao and Xie, Yutong and Gao, Yixuan and Xu, Mingwei and Wu, Jianping},
title={Rattan: An Extensible and Scalable Modular Internet Path Emulator},
year={2026},
isbn={9798400728181},
publisher={Association for Computing Machinery},
address={New York, NY, USA},
url={https://doi.org/10.1145/3828523.3857129},
doi={10.1145/3828523.3857129},
booktitle={Proceedings of the 2026 ACM SIGOPS Annual Technical Conference},
pages={129--144},
numpages={16},
keywords={Network emulation, Internet paths, modularity, reproducibility, transport evaluation},
location={Hong Kong, China},
series={SIGOPS ATC '26}
}