Skip to content

Latest commit

 

History

History
118 lines (82 loc) · 2.76 KB

README.md

File metadata and controls

118 lines (82 loc) · 2.76 KB

Ahmia - Tor Hidden Service Search

https://ahmia.fi/

https://ahmia.fi/

New repository!

https://github.com/ahmia/search

Compatibility

Ahmia requires Python 2.7+ and Django 1.6+

The crawler is called Onionbot and it requires Apache Solr for the data.

Installation

  • Currently, ahmia is listening Solr from http://127.0.0.1:33433/
  • HTTP server is required
  • Please see /apache2/ to setup to run with Apache HTTP server
  • Note the crontabs. The order of the task is important
  • See crontabs file. It is strongly recommended to put crontask to another server than the web-server itself
Install depencies:
$ apt-get install libxml2-dev libxslt-dev python-dev
$ apt-get install libpq-dev
$ apt-get install python-socksipy python-psycopg2 libapache2-mod-wsgi
$ apt-get install libffi-dev
$ pip install -r requirements.txt
Furthermore, you will need to set the rights to the tools:
$ chmod -R ugo+rx /usr/local/lib/ahmia/tools/
And to Apache:
$ chown -R www-data:www-data /usr/local/lib/ahmia/
$ chmod -R u=rwX,g=rX,o=rX /usr/local/lib/ahmia/
Move the Apache settings and adjust WSGI processes=X threads=Y

Upper limit to memory that Apache needs is XY8MB. For instance, 4168MB = 513MB.

cp apache2/sites-available/django-ahmia /etc/apache2/sites-available/django-ahmia
/etc/init.d/apache2 restart
And after creating the SQLite database:
$ chown www-data:www-data /usr/local/lib/ahmia
$ chown www-data:www-data /usr/local/lib/ahmia/ahmia_db
Not required, but recommended for better system performance:
  • Install haveged - A simple entropy daemon
  • Edit the process and threads parameters of the WSGIDaemonProcess in apache2/sites-available/django-ahmia
  • Use PostgreSQL
  • Install PgBouncer: a lightweight connection pooler for PostgreSQL

Features

  • Search engine for Tor hidden services.
  • Privacy: ahmia saves no IP logs.
  • Filtering child abuse.
  • Popularity tracking from Tor2web nodes, public WWW backlinks and the number of clicks in the search results.
  • Hidden service online tracker.

Demo

You can try the demo by cloning this repository and running the test server with provided data:

$ python manage.py syncdb
$ python manage.py loaddata ahmia/fixtures/initial_data.json
$ python manage.py runserver

Then open your browser to http://localhost:8000

Tests

Unittests:

$ python manage.py test ahmia/tests/

For developers

Please, at least, validate your Python code with:

$ pylint --rcfile=pylint.rc ./ahmia/python_code_file.py

and fix the major problems.