discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
mysteriumnetwork/node · source
Snapshot 0 · 2026-11-04T12:47:24Z · Go · GPL-3.0
Content fingerprint
f7c993b26a2c155d573550a2b86cc2eaa60708b6d18170a4110a7328383bb048GitHub description at capture
Mysterium Network Node - official implementation of distributed VPN network (dVPN) protocol
README at capture
# Mysterium Node - decentralized VPN built on blockchain [](https://goreportcard.com/report/github.com/mysteriumnetwork/node) [](https://gitlab.com/mysteriumnetwork/node/pipelines) [](https://codecov.io/gh/mysteriumnetwork/node) [](http://godoc.org/github.com/mysteriumnetwork/node) Cross-platform software to run a node in Mysterium Network. It contains Mysterium server (node), client API (tequila API) and client-cli (console client) for Mysterium Network. Currently node supports WireGuard as its underlying VPN transport. ## Getting Started - [Homepage](https://mysterium.network) - [Whitepaper](https://mysterium.network/whitepaper.pdf) - [Latest release](https://github.com/mysteriumnetwork/node/releases/latest) - [Snapshot builds](https://github.com/mysteriumnetwork/node-builds/releases) - bleeding edge, use at your own risk - [Documentation](https://docs.mysterium.network/) - [Help Center](https://help.mystnodes.com/) - [Installation guide](https://help.mystnodes.com/en/?q=installation) ## Installation options ### Debian / Ubuntu / Raspbian Install latest stable release: ```bash sudo -E bash -c "$(curl -s https://raw.githubusercontent.com/mysteriumnetwork/node/master/install.sh)" ``` Or install latest snapshot (development build): ```bash SNAPSHOT=true sudo -E bash -c "$(curl -s https://raw.githubusercontent.com/mysteriumnetwork/node/master/install.sh)" ``` Service logs: ```bash sudo journalctl -u mysterium-node.service ``` Service status: ```bash sudo systemctl status mysterium-node.service ``` Installation script tested on these OSes so far: _Raspbian 10_, _Debian 9_, _Debian 10_, _Ubuntu 18.04_ and _Ubuntu 20.04_. ### Docker Our docker images can be found in [Docker hub](https://hub.docker.com/r/mysteriumnetwork/myst). To run a node in a docker container you will need [docker](https://www.docker.com/). On Linux, to manage docker as a non-root user (execute commands without `sudo`), follow [postinstall guide](https://help.mystnodes.com/en/articles/3777670-running-a-node-as-docker-image-on-linux-host/). You should be able to run a node on any OS that supports docker. We have tested it on these OSes so far: - Debian 9 - Debian 10 - Ubuntu 18.04 - Ubuntu 20.04 - Ubuntu 22.04 - Yocto Linux (BalenaOS) Run node: ```bash docker run \ --cap-add NET_ADMIN \ --net host \ --name myst -d \ mysteriumnetwork/myst service --agreed-terms-and-conditions ``` Access service logs: ```bash docker logs -f myst ``` ### Debian package automatic updates New `myst` DEB installations include `myst-updater.timer`. The timer checks the stable Mysterium Launchpad PPA every 6–12 hours and installs a newer authenticated package when one is available. The updater rejects downgrades, held packages, unexpected repositories, architectures, package paths, and artifact hashes. After installation it verifies both the installed package version and the running node's `/healthcheck` version. Check the updater manually without installing anything: ```bash sudo /usr/lib/mysterium-node/myst-updater --check-only ``` Inspect its schedule and logs: ```bash systemctl list-timers myst-updater.timer journalctl -u myst-updater.service ``` Automatic updates can be disabled by setting `MYST_UPDATER_ENABLED=false` in `/etc/default/myst-updater`. APT continues to perform the repository signature and package-index hash verification; the updater never enables insecure or unauthenticated repository modes. ### Further information More installation options are described in the [installation guides](https://help.mystnodes.com/en/?q=installation). For possible issues while running a node refer to our [Troubleshooting guides](https://help.mystnodes.com/en/collections/1992526-troubleshooting-mystnodes-help-center). ## Built With * [go](https://golang.org/) - The Go Programming Language * [gitlab](https://docs.gitlab.com/ce/ci/) - GitLab CI/CD * [docker](https://www.docker.com/what-docker) - Containerize applications * [openvpn](https://openvpn.net) - Solid VPN solution * [wireguard](https://www.wireguard.com/) - Extremely simple yet fast and modern VPN * [geth](https://geth.ethereum.org/) - Official Go implementation of the Ethereum protocol ## Contributing For a detailed guide, please visit our [developer docs](https://docs.mysterium.network/for-developers/node-development). ## Core contributors * **Valdas Petrulis** - *Lead developer, go evangelist, node bootstrapper* - [Waldz](https://github.com/Waldz) * **Tadas Valiukas** - *Senior developer, experienced bug maker* - [tadovas](https://github.com/tadovas) * **Donatas Kučinskas** - *Senior developer, clean code savvy* - [donce](https://github.com/donce) * **Antanas Masevičius** - *Network engineer / developer, net guru* - [zolia](https://github.com/zolia) * **Ignas Bernotas** - *Senior developer, open source enthusiast* - [ignasbernotas](https://github.com/ignasbernotas) * **Dmitry Shihovtsev** - *Senior developer, devops ninja* - [soffokl](https://github.com/soffokl) * **Viktoras Kuznecovas** - *Senior developer, supersonic typing specialist* [vkuznecovas](https://github.com/vkuznecovas) * **Tadas Krivickas** - *Senior fullstack engineer, CI boss, refactoring fairy* [tadaskay](https://github.com/tadaskay) * **Jaro Šatkevič** - *Senior developer, micro-payments researcher, crypto maniac* [chompomonim](https://github.com/chompomonim) * **Andzej Maciusovič** - *Senior developer, disciplined world changer* [anjmao](https://github.com/anjmao) * **Mantas Domaševičius** - *Senior fullstack engineer, always ready for pair programming* [mdomasevicius](https://github.com/mdomasevicius) * **Tomas Mikalauskas** - *Backend developer, golang lover, payment guru* [tomasmik](https://github.com/tomasmik) * **Vlad Iarmak** - *Protocol architect, networking guru, inexhaustible RFC writer* [Snawoot](https://github.com/Snawoot) See also full list of [contributors](https://github.com/mysteriumnetwork/node/contributors) who participated in this project. ## License This project is licensed under the terms of the GNU General Public License v3.0 (see [details](./LICENSE)).