tor relay #4

Supports: focal bionic xenial trusty


Tor is free software and an open network that helps you defend against traffic analysis, a form of network surveillance that threatens personal freedom and privacy, confidential business activities and relationships, and state security.

This charm deploys a configurable Tor relay. By default, this charm relays traffic internally for the Tor network but does not permit outbound traffic.


tor-relay deploys a Tor relay. It does not publish hidden services.

tor-relay has a few configurable options for specifying ports, relay nickname, and the exit policy. See config.yaml for details.


This charm was built from tor-layers.


Use at your own risk.


Copyright 2015, 2016 Casey Marshall.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


(string) Bandwidth accounting max limit per window. Set to empty string for no limits.
30 GBytes
(string) Bandwidth accounting time window.
day 00:00
(string) Bandwidth allowed burst rate, per second. Set to empty string for no limit.
700 KBytes
(string) Bandwidth rate limit, per second. Set to empty string for no limit.
350 KBytes
(string) Space separated list of extra deb packages to install.
(string) List of signing keys for install_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad.
(string) List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:<user>/<ppa-name> for adding Personal Package Archives, or a distribution component to enable.
(string) The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold".
(string) Tor relay exit policy.
reject *:*
(string) Tor relay nickname.
(int) Tor relay port.
(int) SOCKS5 proxy port.