01 Installing Hashview

Before you begin

We only support Ubuntu 14.04 and 16.04. Hashview has been installed successfully on many different distros. If you are installing on an untested/unsupported distro, please see: Installing Hashview on alternate distros.

---

1. Download and install hashcat-4.x

https://hashcat.net/hashcat/

IMPORTANT: Confirm hashcat is working via command line before continuing

2. Install mysql & Redis

sudo apt-get update
sudo apt-get install git mysql-server libmysqlclient-dev redis-server openssl
[optional, but recommended]
sudo mysql_secure_installation

3. Make sure Redis server is NOT running (Hashview will control this service)

sudo systemctl stop redis-server
sudo systemctl disable redis-server

4. Optimize the database

(on ubuntu 16.10 & 16.04 /etc/mysql/mysql.conf.d/mysqld.cnf)

sudo vim /etc/mysql/my.cnf

Add the following line under the [mysqld] section:

innodb_flush_log_at_trx_commit  = 0
innodb_file_format = Barracuda
innodb_large_prefix = 1
innodb_file_per_table=true

restart mysqld

sudo service mysql restart

5. Install RVM (recommended)

https://rvm.io/rvm/install

Setup Hashview

6. Download Hashview

git clone https://github.com/hashview/hashview
cd hashview

7. Install gems (from hashview directory)

Install ruby 2.4.4 via RVM (if using RVM (recommended))

rvm install ruby-2.4.4
rvm use 2.4.4

Install dependencies

gem install bundler
bundle install

8. Setup database connectivity

cp config/database.yml.example config/database.yml
vim config/database.yml

9. Create database

RACK_ENV=production TZ="$(timedatectl | awk '/Time zone:/{print $3}')" bundle exec rake db:setup

10. Setup hashcat binary settings

Edit the 'hc_binary_path' variable in config/agent_config.json to the full path of the hashcat64.bin. Example of a config/agent_config.json file:

{
  "ip": "127.0.0.1",
  "port": "4567",
  "uuid": "0e566bcb-bb12-448f-a073-76e5b46c9cec",
  "hc_binary_path": "/home/meatball/hashcat-current/hashcat64.bin"
}

Running Hashview

See Running Hashview Wiki page.