GoNetSim

Go Network Simulator. A spiritual, unofficial successor to the inetsim project, providing a suite of tools for simulating common internet services in a controlled environment.

Quick start

gonetsim runs the main services (DNS + HTTP + HTTPS).

gonetsim

Alternatively, you can specify a single service to run

gonetsim dns
gonetsim http
gonetsim https

Configuration

GoNetSim uses a TOML configuration file for most configuration, rather than forcing the memorisation of many flags.

On first run, if no config file is found, GoNetSim generates a default commented config file in $XDG_CONFIG_HOME/gonetsim/config.toml and uses it.

Default search locations:

• /etc/gonetsim/gonetsim.toml
• $XDG_CONFIG_HOME/gonetsim/config.toml (usually ~/.config/gonetsim/config.toml)
• ./gonetsim.toml

To use a specific config file:

gonetsim --config /path/to/gonetsim.toml

Contributing

Praetor follows most standard conventions for contributing, and accepts any contributions from documentation improvements, bug triage / fixes, small features or any updates for issues in the backlog. For more information on contributing please see CONTRIBUTING.md.

Codespaces

Praetor has full support for Github Codespaces. These are recommended for small changes or devices with no access to a development environment. You can use the buttons below to open the repository in a web-based editor and get started.

Dev Containers

We also have full support for Dev Containers. These provide a reproducible development environment that automatically isolates the project and installs the officially supported toolchain.

Clicking the below button will open up VS Code on your local machine, clone this repository and open it automatically inside a development container.

Local Development

For local development, please refer to CONTRIBUTING.md. Again, we follow most conventions so local development involves the standard flow of fork-PR-merge.

This project is licensed under the Apache 2.0 License. Please see LICENSE for more info.

Copyright (c) 2026 Lachlan Harris. All Rights Reserved.