October 2021 - tor-commits - lists.torproject.org

[community/master] relay/setup (Debian-likes): fix how markdown is used to call commands
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit bf1d6aa1fb0d7b28724da09ee190e271ca30f921 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 13:03:25 2021 +0000 relay/setup (Debian-likes): fix how markdown is used to call commands --- content/relay/setup/guard/debianubuntu/contents.lr | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/content/relay/setup/guard/debianubuntu/contents.lr b/content/relay/setup/guard/debianubuntu/contents.lr index c72554b..b81978f 100644 --- a/content/relay/setup/guard/debianubuntu/contents.lr +++ b/content/relay/setup/guard/debianubuntu/contents.lr @@ -17,13 +17,16 @@ Enable the Tor Project's package repository by following the instructions **[her # 3. Install `tor` -Install the `tor` package: +Ensure you update the packages database before installing the package, than call `apt` to install it: -`apt update && apt install tor` +``` +apt update +apt install tor +``` # 4. Configure `/etc/tor/torrc` -Put the configuration file `/etc/tor/torrc` in place: +This is a very simple version of the `torrc` configuration file in order to run a Middle/Guard relay on the Tor network: ``` #change the nickname "myNiceRelay" to a name that you like @@ -38,9 +41,11 @@ ContactInfo tor-operator@your-emailaddress-domain # 5. Restart the Service -Restart the tor daemon so your configuration changes take effect: +Restart the `tor` daemon, so your configuration changes take effect: -`systemctl restart tor@default` +``` +systemctl restart tor@default +``` # 6. Final Notes

1 0

[community/master] relay/setup (Debian-likes): revert markdown used to call commands
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit a7d7c8864fedc66d33349c3e5c4ef97b0dbdbe09 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 13:10:30 2021 +0000 relay/setup (Debian-likes): revert markdown used to call commands --- content/relay/setup/guard/debianubuntu/contents.lr | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/content/relay/setup/guard/debianubuntu/contents.lr b/content/relay/setup/guard/debianubuntu/contents.lr index 27431ee..1936917 100644 --- a/content/relay/setup/guard/debianubuntu/contents.lr +++ b/content/relay/setup/guard/debianubuntu/contents.lr @@ -19,10 +19,9 @@ Enable the Tor Project's package repository by following the instructions **[her Ensure you update the packages database before installing the package, than call `apt` to install it: -``` -apt update -apt install tor -``` +`apt update` + +`apt install tor` # 4. Configure `/etc/tor/torrc` @@ -40,9 +39,7 @@ SocksPort 0 Restart the `tor` daemon, so your configuration changes take effect: -``` -systemctl restart tor@default -``` +`systemctl restart tor@default` # 6. Final Notes

1 0

[community/master] relay/setup (Debian-likes): fix minor typos/pontuations, and empty spaces
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit c73e35793c32370c7ca6117254b88db90d8d63eb Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 12:57:54 2021 +0000 relay/setup (Debian-likes): fix minor typos/pontuations, and empty spaces --- content/relay/setup/guard/debianubuntu/contents.lr | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/relay/setup/guard/debianubuntu/contents.lr b/content/relay/setup/guard/debianubuntu/contents.lr index 884e4f9..c72554b 100644 --- a/content/relay/setup/guard/debianubuntu/contents.lr +++ b/content/relay/setup/guard/debianubuntu/contents.lr @@ -13,15 +13,15 @@ Follow the instructions to enable [automatic software updates](updates) for your # 2. Configure Tor Package Repository -Enable the Torproject package repository by following the instructions **[here](https://support.torproject.org/apt/tor-deb-repo/)**. +Enable the Tor Project's package repository by following the instructions **[here](https://support.torproject.org/apt/tor-deb-repo/)**. -# 3. Package Installation +# 3. Install `tor` Install the `tor` package: `apt update && apt install tor` -# 4. Configuration File +# 4. Configure `/etc/tor/torrc` Put the configuration file `/etc/tor/torrc` in place: @@ -42,7 +42,7 @@ Restart the tor daemon so your configuration changes take effect: `systemctl restart tor@default` -# 6. Final notes +# 6. Final Notes If you are having trouble setting up your relay, have a look at our [help section](/relay/getting-help/). If your relay is now running, check out the [post-install](/relay/setup/post-install/) notes.

1 0

[community/master] relay/setup (Debian-likes): offers the simplest "torrc" possible --- while here, remove the ControlSocket option as it is already set to zero by default
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit 98bac1226986fa3d30ab939f7100b940e33e13d5 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 13:05:10 2021 +0000 relay/setup (Debian-likes): offers the simplest "torrc" possible --- while here, remove the ControlSocket option as it is already set to zero by default --- content/relay/setup/guard/debianubuntu/contents.lr | 13 +++++-------- 1 file changed, 5 insertions(+), 8 deletions(-) diff --git a/content/relay/setup/guard/debianubuntu/contents.lr b/content/relay/setup/guard/debianubuntu/contents.lr index b81978f..27431ee 100644 --- a/content/relay/setup/guard/debianubuntu/contents.lr +++ b/content/relay/setup/guard/debianubuntu/contents.lr @@ -29,14 +29,11 @@ apt install tor This is a very simple version of the `torrc` configuration file in order to run a Middle/Guard relay on the Tor network: ``` -#change the nickname "myNiceRelay" to a name that you like -Nickname myNiceRelay -ORPort 443 -ExitRelay 0 -SocksPort 0 -ControlSocket 0 -# Change the email address below and be aware that it will be published -ContactInfo tor-operator@your-emailaddress-domain +Nickname myNiceRelay # Change "myNiceRelay" to something you like +ContactInfo your@e-mail # Write your e-mail and be aware it will be published +ORPort 443 # You might use a different port, should you want to +ExitRelay 0 +SocksPort 0 ``` # 5. Restart the Service

1 0

[community/master] relay/setup (CentOS-likes): promote full page update, to follow Debian-like changes
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit db26be9c90ff2f313b118aa46528861d81479cd7 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 13:32:31 2021 +0000 relay/setup (CentOS-likes): promote full page update, to follow Debian-like changes --- content/relay/setup/guard/centosrhel/contents.lr | 57 +++++++++++++----------- 1 file changed, 32 insertions(+), 25 deletions(-) diff --git a/content/relay/setup/guard/centosrhel/contents.lr b/content/relay/setup/guard/centosrhel/contents.lr index e5e7afd..54b7d29 100644 --- a/content/relay/setup/guard/centosrhel/contents.lr +++ b/content/relay/setup/guard/centosrhel/contents.lr @@ -10,13 +10,21 @@ body: One of the most important things to keeps your relay secure is to install security updates timely and ideally automatically so you can not forget about it. Follow the instructions to enable [automatic software updates](updates) for your operating system. -# 2. Enable the EPEL repository +# 2. Install `epel-release` -To install `tor` package on CentOS/RHEL, you need to install the [EPEL](https://fedoraproject.org/wiki/EPEL) repository first: +To install `tor` on CentOS/RHEL, you need to enable the use of the [EPEL](https://fedoraproject.org/wiki/EPEL) Repository first. To do so, you must install the `epel-release` package: `yum install epel-release` -# 3. Add the following to /etc/yum.repos.d/tor.repo and then install the tor package. +Recent versions of CentOS/RHEL are using `dnf` instead of `yum`, so the command to install the package would be: + +`dnf install epel-release` + +If you are on a recent version that uses `dnf`, please keep using it for the following steps where `yum` is called on this setup guide. + +# 3. Enable Tor Project's Repository + +Enabling the Tor Project's Repository for CentOS/RHEL consists basically on setting up `/etc/yum.repos.d/Tor.repo` with the following content: ``` [tor] @@ -28,40 +36,39 @@ gpgkey=https://rpm.torproject.org/centos/public_gpg.key cost=100 ``` +More information about it can be found [here](https://support.torproject.org/rpm/). + +# 4. Install `tor` + +Once you are set with EPEL and the Tor repositories, you are now able to install the package: + `yum install tor` -When you install the first package from the EPEL repository you will be asked about verifying the EPEL GPG signing key. -Please ensure the key matches with the one available on the [Fedora Project website](https://getfedora.org/keys/). +Please note that when you are installing the first package from the EPEL repository you will be asked about verifying the EPEL's GPG signing key. Please ensure the key matches with the one available on the [Fedora Project website](https://getfedora.org/keys/). -# 4. Put the tor configuration file `/etc/tor/torrc` in place +# 5. Configure `/etc/tor/torrc` ``` -#change the nickname "myNiceRelay" to a name that you like -Nickname myNiceRelay -ORPort 9001 -SocksPort 0 -ExitRelay 0 -# Change the email address below and be aware that it will be published -ContactInfo tor-operator@your-emailaddress-domain +Nickname myNiceRelay # Change "myNiceRelay" to something you like +ContactInfo your@e-mail # Write your e-mail and be aware it will be published +ORPort 443 # You might use a different port, should you want to +ExitRelay 0 +SocksPort 0 ``` -# 5. Enable and start your Tor relay +# 6. Enable and Start `tor` -CentOS 7 / RHEL 7: +Recent versions os CentOS/RHEL which ship with systemd: -``` -systemctl enable tor -systemctl start tor -``` +`systemctl enable --now tor` -CentOS 6 / RHEL 6: +Should you use an older release like CentOS/RHEL 6, that will be: -``` -service tor enable -service tor start -``` +`service tor enable` + +`service tor start` -# 6. Final notes +# 7. Final Notes If you are having trouble setting up your relay, have a look at our [help section](/relay/getting-help/). If your relay is now running, check out the [post-install](/relay/setup/post-install/) notes.

1 0

[community/master] relay/setup (CentOS-likes): add a note about "torrc" configurations
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit d0408f6496bae9097d8a734d56b315d2f837ebf0 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 13:33:44 2021 +0000 relay/setup (CentOS-likes): add a note about "torrc" configurations --- content/relay/setup/guard/centosrhel/contents.lr | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/relay/setup/guard/centosrhel/contents.lr b/content/relay/setup/guard/centosrhel/contents.lr index 54b7d29..70e1cdb 100644 --- a/content/relay/setup/guard/centosrhel/contents.lr +++ b/content/relay/setup/guard/centosrhel/contents.lr @@ -48,6 +48,8 @@ Please note that when you are installing the first package from the EPEL reposit # 5. Configure `/etc/tor/torrc` +This is a very simple version of the `torrc` configuration file in order to run a Middle/Guard relay on the Tor network: + ``` Nickname myNiceRelay # Change "myNiceRelay" to something you like ContactInfo your@e-mail # Write your e-mail and be aware it will be published

1 0

[community/master] relay/setup (CentOS/RHEL): minor fixes on Markdown for shell console
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit 91a6ee5f3e5a871786d4d8ca352088d9db7b21a3 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 19:34:14 2021 +0000 relay/setup (CentOS/RHEL): minor fixes on Markdown for shell console --- content/relay/setup/guard/centosrhel/contents.lr | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/content/relay/setup/guard/centosrhel/contents.lr b/content/relay/setup/guard/centosrhel/contents.lr index 81f1d30..52697dc 100644 --- a/content/relay/setup/guard/centosrhel/contents.lr +++ b/content/relay/setup/guard/centosrhel/contents.lr @@ -14,11 +14,15 @@ One of the most important things to keeps your relay secure is to install securi To install `tor` on CentOS/RHEL, you need to enable the use of the [EPEL](https://fedoraproject.org/wiki/EPEL) Repository first. To do so, you must install the `epel-release` package: -`yum install epel-release` +``` +# yum install epel-release +``` Recent versions of CentOS/RHEL are using `dnf` instead of `yum`, so the command to install the package would be: -`dnf install epel-release` +``` +# dnf install epel-release +``` If you are on a recent version that uses `dnf`, please keep using it for the following steps where `yum` is called on this setup guide. @@ -42,7 +46,9 @@ More information about it can be found [here](https://support.torproject.org/rpm Once you are set with EPEL and the Tor repositories, you are now able to install the package: -`yum install tor` +``` +# yum install tor +``` Please note that when you are installing the first package from the EPEL repository you will be asked about verifying the EPEL's GPG signing key. Please ensure the key matches with the one available on the [Fedora Project website](https://getfedora.org/keys/). This will also happens when installing packages from Tor's repository for the first time - again you must ensure the key matches. @@ -62,19 +68,21 @@ SocksPort 0 Recent versions os CentOS/RHEL which ship with systemd: -`systemctl enable --now tor` +``` +# systemctl enable --now tor +``` Should you use an older release like CentOS/RHEL 6, that will be: -`service tor enable` - -`service tor start` +``` +# service tor enable +# service tor start +``` # 7. Final Notes If you are having trouble setting up your relay, have a look at our [help section](/relay/getting-help/). If your relay is now running, check out the [post-install](/relay/setup/post-install/) notes. - --- html: two-columns-page.html ---

1 0

[community/master] relay/setup (Fedora): promote full page update, to follow previous changes
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit e96b9cb7e89ffd7eb2e0c76b5cc651d4f8ce515e Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 13:47:21 2021 +0000 relay/setup (Fedora): promote full page update, to follow previous changes --- content/relay/setup/guard/fedora/contents.lr | 35 +++++++++++++++------------- 1 file changed, 19 insertions(+), 16 deletions(-) diff --git a/content/relay/setup/guard/fedora/contents.lr b/content/relay/setup/guard/fedora/contents.lr index 997ed43..caec0f2 100644 --- a/content/relay/setup/guard/fedora/contents.lr +++ b/content/relay/setup/guard/fedora/contents.lr @@ -10,7 +10,9 @@ body: One of the most important things to keeps your relay secure is to install security updates timely and ideally automatically so you can not forget about it. Follow the instructions to enable [automatic software updates](updates) for your operating system. -# 2. Add the following to `/etc/yum.repos.d/tor.repo` and then install the tor package. +# 2. Enable Tor Project's Repository + +Enabling the Tor Project's Repository for Fedora consists basically on setting up `/etc/yum.repos.d/Tor.repo` with the following content: ``` [tor] @@ -22,30 +24,31 @@ gpgkey=https://rpm.torproject.org/fedora/public_gpg.key cost=100 ``` -`sudo dnf install tor` +More information about it can be found [here](https://support.torproject.org/rpm/). +# 3. Install `tor` -# 3. Configuration File +Once you are set with EPEL and the Tor repositories, you are now able to install the package: -Put the configuration file `/etc/tor/torrc` in place: +`dnf install tor` -``` -#change the nickname "myNiceRelay" to a name that you like -Nickname myNiceRelay -ORPort 9001 -ExitRelay 0 -# Change the email address below and be aware that it will be published -ContactInfo tor-operator@your-emailaddress-domain -``` +# 4. Configure `/etc/tor/torrc` -# 4. Start the tor daemon and make sure it starts at boot +This is a very simple version of the `torrc` configuration file in order to run a Middle/Guard relay on the Tor network: ``` -systemctl enable tor -systemctl start tor +Nickname myNiceRelay # Change "myNiceRelay" to something you like +ContactInfo your@e-mail # Write your e-mail and be aware it will be published +ORPort 443 # You might use a different port, should you want to +ExitRelay 0 +SocksPort 0 ``` -# 5. Final notes +# 5. Enable and Start `tor` + +`systemctl enable --now tor` + +# 6. Final Notes If you are having trouble setting up your relay, have a look at our [help section](/relay/getting-help/). If your relay is now running, check out the [post-install](/relay/setup/post-install/) notes.

1 0

[community/master] relay/setup (CentOS-likes): add note about the first time using the Tor repo
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit d29d38d755fd39559c140414a6241aa41efcd2ca Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 13:43:58 2021 +0000 relay/setup (CentOS-likes): add note about the first time using the Tor repo --- content/relay/setup/guard/centosrhel/contents.lr | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/relay/setup/guard/centosrhel/contents.lr b/content/relay/setup/guard/centosrhel/contents.lr index 70e1cdb..81f1d30 100644 --- a/content/relay/setup/guard/centosrhel/contents.lr +++ b/content/relay/setup/guard/centosrhel/contents.lr @@ -44,7 +44,7 @@ Once you are set with EPEL and the Tor repositories, you are now able to install `yum install tor` -Please note that when you are installing the first package from the EPEL repository you will be asked about verifying the EPEL's GPG signing key. Please ensure the key matches with the one available on the [Fedora Project website](https://getfedora.org/keys/). +Please note that when you are installing the first package from the EPEL repository you will be asked about verifying the EPEL's GPG signing key. Please ensure the key matches with the one available on the [Fedora Project website](https://getfedora.org/keys/). This will also happens when installing packages from Tor's repository for the first time - again you must ensure the key matches. # 5. Configure `/etc/tor/torrc`

1 0

[community/master] relay/setup (Fedora): minor fixes on Markdown for shell console
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit 8192d06ce4fe1450697bef5f38d865604e0c1290 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 19:35:50 2021 +0000 relay/setup (Fedora): minor fixes on Markdown for shell console --- content/relay/setup/guard/fedora/contents.lr | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/content/relay/setup/guard/fedora/contents.lr b/content/relay/setup/guard/fedora/contents.lr index caec0f2..d392889 100644 --- a/content/relay/setup/guard/fedora/contents.lr +++ b/content/relay/setup/guard/fedora/contents.lr @@ -30,7 +30,9 @@ More information about it can be found [here](https://support.torproject.org/rpm Once you are set with EPEL and the Tor repositories, you are now able to install the package: -`dnf install tor` +``` +# dnf install tor +``` # 4. Configure `/etc/tor/torrc` @@ -46,7 +48,9 @@ SocksPort 0 # 5. Enable and Start `tor` -`systemctl enable --now tor` +``` +# systemctl enable --now tor +``` # 6. Final Notes

1 0