TorBrowserHackingTheNextGeneration - Revision history

David: /* Get the goodz on your local machine */ updated path instructions for rsync

2021-05-25T20:41:04Z

Get the goodz on your local machine: updated path instructions for rsync

← Older revision		Revision as of 20:41, 25 May 2021
Line 168:		Line 168:
	== Get the goodz on your local machine ==		== Get the goodz on your local machine ==

	Last, use rsync or whatever to get tbb-to-copy-over onto your local machine		Last, use rsync or whatever to get tbb-to-copy-over onto your local machine (below replace '${path-to-the-parent-of-tor-browser-dir}'
			with the path to the parent of the tor-browser directory on your server).

	rsync -avz --progress name-of-the-tor-build-server-you-set-up:tbb-to-copy-over .		rsync -avz --progress name-of-the-tor-build-server-you-set-up:${path-to-the-parent-of-tor-browser-dir}/tbb-to-copy-over .

2021-05-25T20:06:10Z

Generating configure, compiling and packaging: added/updated times

← Older revision		Revision as of 20:06, 25 May 2021
Line 127:		Line 127:
	== Generating configure, compiling and packaging ==		== Generating configure, compiling and packaging ==

	* [~30 min] generate configuration		* [~1 min] generate configuration
	./mach configure \		./mach configure \
	--with-tor-browser-version=tbb-nightly \		--with-tor-browser-version=tbb-nightly \
Line 134:		Line 134:
	--enable-bundled-fonts		--enable-bundled-fonts

	* Build		* [~80 min] Build
	./mach build		./mach build

	* Package		* [<1 min] Package
	./mach build stage-package		./mach build stage-package


	== Getting an existing TBB to serve as a base ==		== Getting an existing TBB to serve as a base ==

2021-05-25T18:29:22Z

Getting the code: fixed version to checkout to make things easier

← Older revision		Revision as of 18:29, 25 May 2021
Line 28:		Line 28:
	cd tor-browser		cd tor-browser

	* Checkout a branch. Do <pre>git branch -a</pre> to see the branches. For example, in May 2021, you could checkout the branch associated with the most recent ~~build (tagged as tor-browser-88.0.1-10.5-1-build1)~~ with		* Checkout a branch. Do <pre>git branch -a</pre> to see the branches. For example, in May 2021, you could checkout the branch associated with the most recent release with
	git checkout remotes/origin/tor-browser-88.0.1-10.5-1		git checkout remotes/origin/tor-browser-78.10.0esr-10.0-1

	== Satisfying dependencies prior to build ==		== Satisfying dependencies prior to build ==

2021-05-25T08:46:01Z

Getting an existing TBB to serve as a base: added change of directory back to tor-browser

← Older revision		Revision as of 08:46, 25 May 2021
Line 157:		Line 157:

	* Copy custom stuff onto this base		* Copy custom stuff onto this base
			cd ../tor-browser
	cp -a obj-/dist/firefox/ $INSTDIR/Browser/		cp -a obj-/dist/firefox/ $INSTDIR/Browser/

2021-05-25T08:44:34Z

Getting an existing TBB to serve as a base: fixed browser version in download, added explicit steps for signature verification in case people forget

← Older revision		Revision as of 08:44, 25 May 2021
Line 147:		Line 147:

	* get the TBB; expand it		* get the TBB; expand it
	wget https://www.torproject.org/dist/torbrowser/10.~~0a6~~/tor-browser-linux64-10.~~0a6_en~~-US.tar.xz		wget https://www.torproject.org/dist/torbrowser/10.5a15/tor-browser-linux64-10.5a15_en-US.tar.xz
			wget https://www.torproject.org/dist/torbrowser/10.5a15/tor-browser-linux64-10.5a15_en-US.tar.xz.asc # detached sig
			gpg --recv-key 0xEF6E286DDA85EA2A4BA7DE684E2C6E8793298290 # Tor Devs' signing key
			gpg --verify tor-browser-linux64-10.5a15_en-US.tar.xz.asc
	tar xvf tor-browser-linux64-10.0a6_en-US.tar.xz		tar xvf tor-browser-linux64-10.0a6_en-US.tar.xz

2021-05-25T02:44:08Z

Background: added emphasis to memory reqs., warning about piping downloaded scripts directly to the shell

← Older revision		Revision as of 02:44, 25 May 2021
Line 18:		Line 18:
	== Background ==		== Background ==

	Running Debian 10 (buster) on a VPS (I used DigitalOcean for this one). The available memory is important: 16 GB is necessary to build. Below I sometimes do things "in a hurry" by piping curl into a shell, which is Not Good Practice. You should download those scripts, look at them (or ask someone else to look at them, or both), and when satisfied, run them.		Running Debian 10 (buster) on a VPS (I used DigitalOcean for this one). The available memory is important: '''16 GB is necessary to build'''. The Mozilla instructions for Firefox claim 8GB, but this will result in an out of memory error from llvm.

			Below I sometimes do things "in a hurry" by piping curl into a shell, which is Not Good Practice. You should download those scripts, look at them (or ask someone else to look at them, or both), and when satisfied, run them. ''Note that it is sometimes possible to detect, from the server side, when someone is piping to the shell, which makes it even more dangerous. At least just download the scripts before running them, even if you don't review them.''

	== Getting the code ==		== Getting the code ==

2021-05-25T01:28:41Z

Clone torbutton, and move it into place: fixed destination for torbutton

← Older revision		Revision as of 01:28, 25 May 2021
Line 79:		Line 79:

	git clone https://git.torproject.org/torbutton		git clone https://git.torproject.org/torbutton
			cp -r torbutton tor-browser/toolkit/torproject/
	cp -r torbutton tor-browser/~~browser~~/~~extensions~~/

	== Satisfying Mach ==		== Satisfying Mach ==

2021-05-25T01:25:00Z

Satisfying dependencies prior to build: added zip from mach configure step

← Older revision		Revision as of 01:25, 25 May 2021
Line 62:		Line 62:
	apt-transport-https \		apt-transport-https \
	wget \		wget \
	software-properties-common		software-properties-common \
			zip

	== Clone tor-launcher and copy it into place ==		== Clone tor-launcher and copy it into place ==

2021-05-25T01:22:24Z

Satisfying dependencies prior to build: added libpulse from mach configure step

2021-05-25T00:47:04Z

Make your modifications

← Older revision		Revision as of 00:47, 25 May 2021
Line 120:		Line 120:
	== Make your modifications ==		== Make your modifications ==

	* [∞] ~~Hack~~ away!		* [∞] Return to the tor-browser directory, and hack away!

	== Generating configure, compiling and packaging ==		== Generating configure, compiling and packaging ==