Updating Tor Browser binaries
We aim to update the Tor Browser binaries distributed by GetTor as soon as a new version is available. This can be done by running a series of scripts to upload the new versions to each of our providers and update the database of links to these uploads that are distributed by our responders.
- Log into the GetTor machine
- Change to the GetTor user by running
sudo -u gettor -s
- Upload the new binaries to Google Docs and Internet Archive by running
./scripts/update_files
from the main gettor directory - Upload the new binaries to Github and Gitlab by running
GITHUB_AUTH=$github_token GITLAB_AUTH=$gitlab_token ./scripts/update_git
where the provided tokens are authentication token generated for the github and gitlab user accounts, respectively, that host our GetTor repositories. - Update the links in the gettor database by running
./scripts/export_stats
Starting and Restarting gettor
- Log into GetTor's machine
- Change to the GetTor user by running
sudo -u gettor -s
- Run
/home/gettor/gettor/bin/gettor_service [start|restart]
Troubleshooting issues
GetTor logs
All logs are located in the log directory on the GetTor host: /srv/gettor.torproject.org/home/gettor/log
Refreshing the rclone OAuth token
If in step (3) you receive error messages of the form: oauth2: cannot fetch token: 401 Unauthorized
, you will need to refresh the OAuth token used by rclone
to update the Google Docs distributor. To do so, run rclone config
and answer the prompts as follows:
n) New remote
d) Delete remote
r) Rename remote
c) Copy remote
s) Set configuration password
q) Quit config
e/n/d/r/c/s/q> e
Choose a number from below, or type in an existing value
1 > gdrive
remote> 1
answer n) No
to all edit questions until you get to the prompt
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
You will then be prompted to refresh the token:
y) Yes
n) No
y/n> y
Use auto config?
* Say Y if not sure
* Say N if you are working on a remote or headless machine or Y didn't work
y) Yes
n) No
y/n> n
Follow the instructions and enter the verification code to refresh the token.