How to use the ToRat Docker Image

TL;DR

git clone https://github.com/lu4p/ToRat.git
cd ./ToRat
sudo docker build . -t torat
sudo docker run -it -v "$(pwd)"/dist:/dist_ext torat

Prerequisites

1. Install Docker on Linux
   • ubuntu https://docs.docker.com/install/linux/docker-ce/ubuntu/
   • debian https://docs.docker.com/install/linux/docker-ce/debian/
   • fedora https://docs.docker.com/install/linux/docker-ce/fedora/
   • centos https://docs.docker.com/install/linux/docker-ce/centos/
   • arch sudo pacman -s docker

Install

1. Clone this repo via git

git clone https://github.com/lu4p/ToRat.git

2. Change Directory to ToRat

cd ./ToRat

3. Build the ToRat Docker Container

• you need to build a part of the container yourself to get a own onion address and certificate all prerequisites are met by the prebuilt torat-pre image in other to make quick build times possible

sudo docker build . -t torat

4. Run the container

• will drop directly into the ToRat Server shell
• the -v flag copies the compiled binaries to the host file system
• to connect a machine to the server shell just run one of the client binaries on another system

sudo docker run -it -v "$(pwd)"/dist:/dist_ext torat

5. In another shell run the client.

sudo chown $USER dist/ -R
cd dist/dist/client/
./client_linux

6. See the client connect

In your Server shell you should now see something like [+] New Client H9H2FHFuvUs9Jz8U connected! You can now select this client by running select in the Server Shell which will give you a nice interactive chooser for the client you want to connect to. After you choose a client you drop in an interactive shell on the client system.

Notes

Contents of ToRat/dist after docker run

$ find ./dist
./dist/
./dist/dist
./dist/dist/client
./dist/dist/client/client_linux                   # linux client binary
./dist/dist/client/client_windows.exe             # windows client binary
./dist/dist/server
./dist/dist/server/key.pem                              # tls private-key
./dist/dist/server/banner.txt                           # banner
./dist/dist/server/cert.pem                             # tls cert
./dist/dist/server/ToRat_server                         # linux server binary