> For the complete documentation index, see [llms.txt](https://tornadocash-docs.gitbook.io/tornado.cash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tornadocash-docs.gitbook.io/tornado.cash/general/minified-ui-hosted-locally.md).

# Minified UI hosted locally

Tornado Cash protocol can be launched locally on your computer through a minified User Interface version made available by the core developers team.

{% embed url="<https://github.com/tornadocash/ui-minified>" %}

### Step #1: Clone the Github repository on your computer <a href="#step-1-clone-the-github-repository-on-your-computer" id="step-1-clone-the-github-repository-on-your-computer"></a>

By opening your Command Line Interface, you can run the following commands to, first, clone the repository, then go inside the newly copied folder:

```
git clone https://github.com/tornadocash/ui-minified.git
cd ui-minified
```

### Step #2: Serve the Folder with Your Favorite HTTP Server <a href="#step-2-serve-the-folder-with-your-favorite-http-server" id="step-2-serve-the-folder-with-your-favorite-http-server"></a>

```
python -m SimpleHTTPServer 8080
```

You can obviously use any other http web server, such as[ npmjs.com/package/http-server](https://www.npmjs.com/package/http-server).

### Step #3: Run the UI on Localhost on your Favorite Web Browser <a href="#step-3-run-the-ui-on-localhost-on-your-favorite-web-browser" id="step-3-run-the-ui-on-localhost-on-your-favorite-web-browser"></a>

To finish, you just need to run <http://localhost:8080> on your Web Browser & let the magic happens 🪄

## Running a TOR service <a href="#running-a-tor-service" id="running-a-tor-service"></a>

If you wish to serve tornado cash UI on an .onion domain, there is an easy way to do it using docker-compose.

* You need to paste the following into `docker-compose.yml`

```
version: '2'
​
services:
  tornado_ui:
    image: tornadocash/ui
    restart: always
    container_name: tornado_ui
  watchtower:
    image: v2tec/watchtower
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    command: --interval 60 tornado_ui
  tor:
    image: strm/tor
    restart: always
    depends_on: [ tornado_ui ]
    environment:
      LISTEN_PORT: 80
      REDIRECT: tornado_ui:80
      # Generate a new key with
      # docker run --rm --entrypoint shallot strm/tor-hiddenservice-nginx ^torn
      PRIVATE_KEY: |
        -----BEGIN RSA PRIVATE KEY-----
        ...
        -----END RSA PRIVATE KEY-----
```

* Then, just run the following command:`docker-compose up -d`

Enjoy your Tornado Cash UI 🌪

*This tutorial is inspired from the*[ *README.md document*](https://github.com/tornadocash/ui-minified/blob/gh-pages/README.md) *present in the Github repository.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tornadocash-docs.gitbook.io/tornado.cash/general/minified-ui-hosted-locally.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
