... | ... | @@ -4,8 +4,59 @@ GetTor was created as a program for serving Tor and related files over SMTP, thu |
|
|
Tor Browser packages live at the following repositories:
|
|
|
- https://github.com/TheTorProject/gettorbrowser
|
|
|
- https://gitlab.com/thetorproject/gettorbrowser
|
|
|
- Google drive: https://drive.google.com/open?id=13CADQTsCwrGsIID09YQbNz2DfRMUoxUU
|
|
|
- Internet Archive: https://archive.org/details/@gettor
|
|
|
|
|
|
Both repositories are sync via gitlab-CI pipeline. The configuration file lives at:
|
|
|
- https://gitlab.com/thetorproject/gettorbrowser/blob/master/.gitlab-ci.yml
|
|
|
## Installing GetTor
|
|
|
|
|
|
To install gettor locally please install the following packages (on debian):
|
|
|
|
|
|
python3-coverage
|
|
|
python3-dkim
|
|
|
python3-dns
|
|
|
python3-internetarchive
|
|
|
python3-openssl
|
|
|
python3-pytest
|
|
|
python3-requests-oauthlib
|
|
|
python3-service-identity
|
|
|
python3-twisted
|
|
|
sqlite3
|
|
|
|
|
|
The following packages are needed to run a gettor instance:
|
|
|
|
|
|
internetarchive
|
|
|
jq
|
|
|
rclone
|
|
|
|
|
|
Specifically:
|
|
|
internetarchive is needed to send Tor Browser files via command line to the internet archive.
|
|
|
jq is a json parser that is used to find out about the new tor browser releases.
|
|
|
Both internetarchive and jq are used in: scripts/update_files
|
|
|
|
|
|
The following packages are instead needed to deploy gettor via ansible:
|
|
|
|
|
|
ansible
|
|
|
ansible-lint
|
|
|
|
|
|
Gettor ansible playbooks live at: https://gitweb.torproject.org/admin/services/gettor.git/
|
|
|
|
|
|
Finally the following package is used store Tor Browser files via git and support large files:
|
|
|
git-lfs
|
|
|
|
|
|
## Running gettor
|
|
|
|
|
|
Once gettor is installed you can run it with:
|
|
|
|
|
|
```
|
|
|
$ ./bin/gettor_service start
|
|
|
```
|
|
|
|
|
|
## Running tests
|
|
|
|
|
|
GetTor includes PyTest unit tests. To run the tests, first install some dependencies:
|
|
|
|
|
|
|
|
|
```
|
|
|
$ pytest-3 tests/
|
|
|
```
|
|
|
|
|
|
The build runs every night at 4 A.M. |
|
|
\ No newline at end of file |