BAR installation notes

These are the installation notes for BAR software. If you don't know what is it about, check the page here first. The code is released under the modified BSD licence and lies here.

Please, note that the software described here is still in Alpha state of development. You should not use it for real anonymity over TCP/IP.

In our guidelines we assume the following setup:

BAR server:83.212.169.68
Hidden service label:9240aaebd1451db5a6284ebce0bdfec4
Hidden service shared key:1d8be2a6b0d3b886e549efab44985700

Run a BAR client

  1. Clone the repository.

    git clone https://github.com/sophron/BAR.git

  2. Change directory to BAR.

    cd BAR

  3. Install BAR and dependencies.

    sudo python setup.py install

  4. Add the hidden service you wish to contact:

    python bin/bar contacts add --name a-service-name --label 9240aaebd1451db5a6284ebce0bdfec4 --sharedkey 1d8be2a6b0d3b886e549efab44985700

  5. Login to BAR server:

    python bin/bar login --name a-service-name --role hidden-client --server 83.212.169.68

  6. Configure your browser to use BAR. For instance, in Firefox, go to Edit -> Preferences -> Advanced -> Settings -> Manual proxy configuration. You want to enable HTTP proxy and make it connect localhost on port 4333.

  7. Use the browser to connect to the hidden service, for example type http://hiddenservice.bar/ and press Enter.

Run a BAR hidden service

  1. Clone the repository.

    git clone https://github.com/sophron/BAR.git

  2. Change directory to BAR.

    cd BAR

  3. Install BAR and dependencies.

    sudo python setup.py install

  4. Add the hidden client you wish to contact you:

    python bin/bar contacts add --name my-service --label 9240aaebd1451db5a6284ebce0bdfec4 --sharedkey 1d8be2a6b0d3b886e549efab44985700

  5. Make your service available only via localhost. For example, in Apache HTTP server, your vhost should look like this:

    <VirtualHost 127.0.0.1:80>
        ServerName hiddenservice.bar
        DocumentRoot /var/www/hidden-service-bar
    </VirtualHost>

  6. Set the DNS record locally. For instance, add the following entry to /etc/hosts.

    127.0.0.1 hiddenservice.bar

  7. Login to BAR server:

    python bin/bar login --name my-service --role hidden-service --server 83.212.169.68

Run a BAR server

  1. Clone the repository.

    git clone https://github.com/sophron/BAR.git

  2. Change directory to BAR.

    cd BAR

  3. Install BAR and dependencies.

    sudo python setup.py install

  4. Bind BAR server on port 231.

    sudo python bin/bar server start