Installing H@H on Ubuntu

From EHWiki
Jump to navigationJump to search

This page will tell you how to set up a Hentai@Home client using a Linux Ubuntu Server

Before you start reading at all, to use this guide you should be “above average” interested in computers, having a little more than “standard” equipment is recommended! (Meaning this guide is for advanced users)


  • Being able to search Google.
  • Basic Linux knowledge is recommended.
  • It is recommended to use PuTTY or any other SSH program to connect to your server, this allows the copying/pasting of commands to the server.

A couple things to be aware of before starting:

  • Linux IS case sensitive on file names. Therefore, best thing is to create everything with lower case names to make it easier for yourself.
  • Commands you should type is given in Green, output from the command prompt is given in Red. Text in commands that is marked in Blue is part of a command that typically you would have to change.
  • This manual was developed based on a virtual server. The use of a physical server or another program than VMware to virtualize your server may require doing some things differently.

Configuring the Network

First thing you would want to do with your server is setting a static IP address. Use this command

sudo nano /etc/network/interfaces

The file that is opened should look something like this:

This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).
# The loopback network interface
auto lo
iface lo inet loopback
# The primary network interface
auto eth0
iface eth0 inet dhcp

Below where it says “# The primary network interface”

Type in this information:

auto eth0
iface eth0 inet static

Change the IP addresses with what is relevant for your network.

When you have made the changes to the file press “ctrl+o” and press enter to save changes. Then press “ctrl+x” to exit the text editor.

When you have exited the file, type this command to restart the network interface and activate the new configuration.

sudo /etc/init.d/networking restart

You can check and see if your IP has changed by typing:


You should see something like this:

eth0      Link encap:Ethernet  HWaddr 00:00:00:00:00:00
inet addr:  Bcast:  Mask:
inet6 addr: ffff::fff:ffff:ffff:ffff/64 Scope:Link
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:0 (0.0 MB)  TX bytes:0 (0.0 GB)

The second line is what is important.

You can test and see if the network is working by pinging an internet server:


If this returns an error try pinging:


If this last one works and not the first, there is a problem with your DNS settings (refer to “dns-nameservers” that was typed in when you configured the network, this setting is typically the same as you gateway).

If none of them work there is no connection to internet. If this is the case you can try pinging your inside router(gateway) to check if you have network connection at all, if not check the IP you set for your server, make sure it's not in use by another computer and make sure you server is physically connected to the network.

That’s it for setting up the network.

P.S: Important thing to do when you have confirmed network connection on your server, run these commands to update you server with latest security patches.

sudo apt-get update
sudo apt-get upgrade

Installing Java (Pick 6 or 7)

apt-get OpenJDK Installation

OpenJDK is a free and open source implementation of Sun's Java SE Platform. It is also the default Java software package included in Ubuntu Package archive.

It allows you to install Java through the usual apt-get command, and is the easiest way to install Java on your Ubuntu machine. This will install OpenJDK 6 on Ubuntu 12.04 and earlier and OpenJDK 7 on 12.10+.

Despite earlier reports, the latest H@H client works perfectly with OpenJDK.

First, update the package index:

sudo apt-get update

Then, check if Java has already been installed:

java -version

If it returns "The program java can be found in the following packages", Java hasn't been installed yet, so execute the following command:

sudo apt-get install default-jre

This will install the Java Runtime Environment (JRE). Finally, check if Java has been installed correctly:

java -version

If properly installed, the expected output is:

java version "1.7.0_65"
OpenJDK Runtime Environment (IcedTea 2.5.3) (7u71-2.5.3-0ubuntu0.14.04.1)
OpenJDK 64-Bit Server VM (build 24.65-b04, mixed mode)

Oracle Java 6 Installation

(old source: rewritten by Melkeku and Fyxie)

To run the H@H server you will have to have java installed on the server.

As far as I was told on the forums and as I installed you have to use Sun's(/Oracle's) Java. It will not work with other versions.

First download the JDK can be with the following command. (Official download is here

wget --no-cookies --header "Cookie:" ""

Extract the (bin) file:


If you type «ls» you should now see 2 files:

jdk1.6.0_32  jdk-6u32-linux-x64.bin

Now move the extracted file:

sudo mv jdk1.6.0_32 /usr/lib/jvm/

Now type in these commands to “install” Java (as 3 separate commands)

sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/jdk1.6.0_32/bin/javac 1
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk1.6.0_32/bin/java 1
sudo update-alternatives --install /usr/bin/javaws javaws /usr/lib/jvm/jdk1.6.0_32/bin/javaws 1

Now tell the server that this java installation is the default one (as 3 separate commands):

sudo update-alternatives --config javac
sudo update-alternatives --config java
sudo update-alternatives --config javaws

To verify the installation is complete type:

java -version

You should see this message:

java version "1.6.0_32"
Java(TM) SE Runtime Environment (build 1.6.0_32-b05)
Java HotSpot(TM) 64-Bit Server VM (build 20.7-b02, mixed mode)

Oracle Java 7 Installation

Note that 7 is said to have issues with the graphical client. 7 Should be fine for a headless machine.

Become root

su -

Download and exract files (Official download is here

wget --no-cookies --header "Cookie:" ""
tar xvfo jdk-7u9-linux-x64.tar.gz

Move java files into their place

mkdir /usr/lib/jvm
mv jdk1.7.0_09 /usr/lib/jvm/jdk1.7.0_09

Set alternatives links

update-alternatives --install "/usr/bin/java" "java" "/usr/lib/jvm/jdk1.7.0_09/bin/java" 1
update-alternatives --install "/usr/bin/javac" "javac" "/usr/lib/jvm/jdk1.7.0_09/bin/javac" 1
update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/lib/jvm/jdk1.7.0_09/bin/javaws" 1

Config alternatives links

update-alternatives --config java
update-alternatives --config javac
update-alternatives --config javaws

Verify java version

java -version

(Expected output)

java version "1.7.0_09"
Java(TM) SE Runtime Environment (build 1.7.0_09-b05)
Java HotSpot(TM) 64-Bit Server VM (build 23.5-b02, mixed mode)

Installing H@H

Download H@H (check the newest version in here)

To download H@H first make a new directory for where you want to run the files from:

sudo mkdir /home/”username”/hath

cd /home/”username”/hath

This creates a folder called “hath” in your home directory and moves you to it. Now download the H@H program by typing:

sudo wget

This might take time depending on your network speed.

When finished downloading you will have to install “unzip” to unzip the file. Type:

sudo apt-get install unzip

Now unzip the file by typing:

sudo unzip

If you type «ls» you should see all the files extracted from the zip file.

Now, if everything went as planned before you can type:

java -jar HentaiAtHome.jar

And the server should start up.

You will be prompted for your client ID and Password which you can find on your H@H page:

You will need to configure the server settings on the above page before you get you client password. If you have not applied to run a H@H client yet you will have to do so first.

To stop the server, press "Ctrl+C" and wait for a couple seconds.

If you restart the server or for some reason are not in the folder where the H@H program is located you can also start it by typing

sudo java -jar /home/"username"/hath/HentaiAtHome.jar

If you want to start the server in the background so that you can access the console or close the console without closing the server together, use "nohup" and append a "&" at the end of the command:

nohup java -jar /home/"username"/hath/HentaiAtHome.jar &


nohup java -jar HentaiAtHome.jar &

when you are inside the directory where H@H client is located.

If you want to close the background process, use the following command to identify the process ID (PID):

ps aux | grep -i hentai

Result similar to the following will be returned:

user@host:~# ps aux | grep -i hentai
user      xxxx  0.4  7.0 1366476 71976 ?       Sl   Jan15  39:09 java -jar HentaiAtHome.jar
user      yyyy  0.0  0.0  11744   932 pts/2    S+   16:35   0:00 grep --color=auto -i hentai

where xxxx is the PID of the HentaiAtHome.jar. Execute the following command to kill the process:

sudo kill xxxx


If you are having trouble when downloading updates or when installing the unzip program, if the command prompt is stuck saying ”[waiting for headers]” please refer to this page (it's a common/known problem):

As always check the H@H technical issues first!

For problems after starting the H@H program that are not explained in the FAQ make a forum post here.

For problems related to putty, Ubuntu or Java please use a search engine.

See also