Skip to content

Commit 07045c0

Browse files
committed
updated readme file
1 parent d466c89 commit 07045c0

File tree

4 files changed

+49
-1
lines changed

4 files changed

+49
-1
lines changed

README.md

+48
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Tor Browser - Docker Project #
2+
3+
The purpose of this project is to provide an ephemeral image for anonymous web browsing.
4+
5+
the docker image ( paulczar/torbrowser ) contains [https://www.torproject.org/projects/torbrowser.html.en](Tor Browser Bundle) which is a bundled version of firefox that connects through and uses the Tor network for anonymous web browsing. It is accessed via some SSH forwarding magic.
6+
7+
# Build from Dockerfile #
8+
9+
```
10+
git clone https://github.com/paulczar/docker-torbrowser.git
11+
cd docker-torbrowser
12+
docker build .
13+
```
14+
15+
# Launching the tor-browser application #
16+
17+
## Start / Stop Scripts ##
18+
19+
*Use the Start/Stop scripts provided in this repository*
20+
21+
`./start`
22+
23+
`./stop`
24+
25+
Start will launch the browser and provide you with the user/pass combo and the ssh command to set up the X11 forwarding.
26+
27+
Stop will kill and remove the docker container.
28+
29+
30+
## By hand ##
31+
32+
```
33+
ID=$(docker run -d paulczar/torbrowser)
34+
PORT=$(docker port $ID 22)
35+
docker logs $ID 2> /dev/null | head -1
36+
ssh -oStrictHostKeyChecking=no -oCheckHostIP=no -YC -c blowfish docker@localhost -p $PORT ./tor-browser
37+
```
38+
39+
Remember to kill / rm the docker when you're finished with it.
40+
41+
```
42+
docker kill $ID
43+
docker rm $ID
44+
```
45+
46+
# ToDo
47+
48+
* Encrypt the folder that the tor browser is installed to

README.me

Whitespace-only changes.

start

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
#!/bin/bash
22

3-
ID=$(docker run -d 354a5efeec39)
3+
ID=$(docker run -d paulczar/torbrowser)
44
PORT=$(docker port $ID 22)
55

66
echo $ID > ~/.tor-browser.pid

stop

100644100755
File mode changed.

0 commit comments

Comments
 (0)