- tor-commits - lists.torproject.org

[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

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

25 Oct '21

commit 6738a608b285ce8bc23ca4527aba0fb88a8c3c16 Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 19:37:18 2021 +0000 relay/setup (Debian/Ubuntu): minor fixes on Markdown for shell console --- content/relay/setup/guard/debianubuntu/contents.lr | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/content/relay/setup/guard/debianubuntu/contents.lr b/content/relay/setup/guard/debianubuntu/contents.lr index 1936917..c1d7c35 100644 --- a/content/relay/setup/guard/debianubuntu/contents.lr +++ b/content/relay/setup/guard/debianubuntu/contents.lr @@ -19,9 +19,10 @@ 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` @@ -39,7 +40,9 @@ 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] Merge branch 'consistency-linux'
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit 1110fb1b741b6662b16bb9ead63970da95f50e91 Merge: 195b50b 1d4afa9 Author: gus <gus(a)torproject.org> Date: Mon Oct 25 18:38:46 2021 -0300 Merge branch 'consistency-linux' content/relay/setup/guard/centos-rhel/contents.lr | 95 ++++++++++++++++++++++ .../updates/contents.lr | 0 content/relay/setup/guard/centosrhel/contents.lr | 78 ------------------ .../relay/setup/guard/debian-ubuntu/contents.lr | 62 ++++++++++++++ .../updates/contents.lr | 0 content/relay/setup/guard/debianubuntu/contents.lr | 60 -------------- content/relay/setup/guard/fedora/contents.lr | 35 ++++---- 7 files changed, 178 insertions(+), 152 deletions(-)

1 0

[community/master] relay/setup (Linux-distros): give all setup guides consistent words to configure de Tor Project repo
by gus＠torproject.org 25 Oct '21

25 Oct '21

commit 3cbe7f7b4a5d71809477bb3067d67909a8477e1f Author: Vinícius Zavam <egypcio(a)googlemail.com> Date: Sun Oct 24 19:44:41 2021 +0000 relay/setup (Linux-distros): give all setup guides consistent words to configure de Tor Project repo --- content/relay/setup/guard/centosrhel/contents.lr | 4 ++-- content/relay/setup/guard/debianubuntu/contents.lr | 4 ++-- content/relay/setup/guard/fedora/contents.lr | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/relay/setup/guard/centosrhel/contents.lr b/content/relay/setup/guard/centosrhel/contents.lr index 52697dc..0d8372b 100644 --- a/content/relay/setup/guard/centosrhel/contents.lr +++ b/content/relay/setup/guard/centosrhel/contents.lr @@ -26,9 +26,9 @@ Recent versions of CentOS/RHEL are using `dnf` instead of `yum`, so the command 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 +# 3. Configure 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: +Configuring the Tor Project's Repository for CentOS/RHEL consists basically on setting up `/etc/yum.repos.d/Tor.repo` with the following content: ``` [tor] diff --git a/content/relay/setup/guard/debianubuntu/contents.lr b/content/relay/setup/guard/debianubuntu/contents.lr index c1d7c35..a93ba19 100644 --- a/content/relay/setup/guard/debianubuntu/contents.lr +++ b/content/relay/setup/guard/debianubuntu/contents.lr @@ -11,9 +11,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. Configure Tor Package Repository +# 2. Configure Tor Project's Repository -Enable the Tor Project's package repository by following the instructions **[here](https://support.torproject.org/apt/tor-deb-repo/)**. +Configuring the Tor Project's package repository for Debian/Ubuntu is documented **[here](https://support.torproject.org/apt/tor-deb-repo/)**. Please follow those instructions before proceeding. # 3. Install `tor` diff --git a/content/relay/setup/guard/fedora/contents.lr b/content/relay/setup/guard/fedora/contents.lr index d392889..a3fb9cd 100644 --- a/content/relay/setup/guard/fedora/contents.lr +++ b/content/relay/setup/guard/fedora/contents.lr @@ -10,9 +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. Enable Tor Project's Repository +# 2. Configure 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: +Configuring the Tor Project's Repository for Fedora consists basically on setting up `/etc/yum.repos.d/Tor.repo` with the following content: ``` [tor]

1 0