EHWiki - User contributions [en]

Installing H@H on Debian or Ubuntu

2020-04-10T20:22:15Z

Bipface: systemctl enable hath

==Prerequisites==

* Basic familiarity with Linux.

* A server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. Check for firewall rules by running <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now enable and start the service:
<pre># systemctl enable hath
# systemctl start hath</pre>

==Listening on Port 443==

H@H will work on most port numbers, however making it accessible on port 443 is recommended as more users will be able to connect to it. On Linux, ports numbers below 1024 are considered ''privileged''. Additional steps are required in order for H@H to utilise ports in the privileged range.

There are multiple options for achieving this. The most common approaches are as follows.

Before proceeding, stop the H@H service (<code># systemctl stop hath</code>) and configure your client to use port 443 on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

===Option 1: Using POSIX Capabilities===

The easiest solution is to enable the corresponding ''capability'' on the Java binary.

Firstly ensure the <code>setcap</code> utility is installed, by running:
<pre># apt install libcap2-bin</pre>

Next, [[#Defining the H@H Service|edit the H@H unit file]] again, and add the following line in the <code>[Service]</code> section:
<pre>ExecStartPre=+/bin/sh -c 'setcap "cap_net_bind_service=+ep" "$(readlink -f /usr/bin/java)"'</pre>
This will ensure that the Java binary can bind to privileged ports before launching the H@H client.

Now start the service again:
<pre># systemctl start hath</pre>

Note that this approach may not be suitable if your system is using Java for other purposes as well. ''Capabilities'' have been known to cause adverse effects in some cases, so be sure to test any other Java applications present on your system.

===Option 2: Using Network Address Translation (NAT)===

Alteratively, ''network address translation'' can redirect traffic from your internet-facing port 443 to your H@H client listening on a non-privileged port.

Start by [[#Defining the H@H Service|editing the H@H unit file]] again, and replacing the <code>ExecStart</code> line with:
<pre>ExecStart=/usr/bin/java -jar HentaiAtHome.jar --port=1024</pre>
Where <code>1024</code> is a port of your choice in the range 1024–65535.

If your system is behind a router/firewall, you most likely have a port-forwarding rule configured already to make your server accessible from the internet. You'll need to modify this rule to direct traffic from external port 443 to the port selected in the previous step (on your server's local IP address).

Another way to perform port redirection is to apply the following ''iptables'' rule on the server itself:
<pre># iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 1024</pre>
Where <code>eth0</code> is the name of your network interface and <code>1024</code> is your selected port.

Which approach you choose depends on the nature of your network, the features provided by your router, etc.

Once the NAT rule is in place, start the service again:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

Installing H@H on Debian or Ubuntu

2020-03-21T12:22:25Z

Bipface: make clear the mutually-exclusive options for port 443

==Prerequisites==

* Basic familiarity with Linux.

* A server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. Check for firewall rules by running <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Listening on Port 443==

H@H will work on most port numbers, however making it accessible on port 443 is recommended as more users will be able to connect to it. On Linux, ports numbers below 1024 are considered ''privileged''. Additional steps are required in order for H@H to utilise ports in the privileged range.

There are multiple options for achieving this. The most common approaches are as follows.

Before proceeding, stop the H@H service (<code># systemctl stop hath</code>) and configure your client to use port 443 on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

===Option 1: Using POSIX Capabilities===

The easiest solution is to enable the corresponding ''capability'' on the Java binary.

Firstly ensure the <code>setcap</code> utility is installed, by running:
<pre># apt install libcap2-bin</pre>

Next, [[#Defining the H@H Service|edit the H@H unit file]] again, and add the following line in the <code>[Service]</code> section:
<pre>ExecStartPre=+/bin/sh -c 'setcap "cap_net_bind_service=+ep" "$(readlink -f /usr/bin/java)"'</pre>
This will ensure that the Java binary can bind to privileged ports before launching the H@H client.

Now start the service again:
<pre># systemctl start hath</pre>

Note that this approach may not be suitable if your system is using Java for other purposes as well. ''Capabilities'' have been known to cause adverse effects in some cases, so be sure to test any other Java applications present on your system.

===Option 2: Using Network Address Translation (NAT)===

Alteratively, ''network address translation'' can redirect traffic from your internet-facing port 443 to your H@H client listening on a non-privileged port.

Start by [[#Defining the H@H Service|editing the H@H unit file]] again, and replacing the <code>ExecStart</code> line with:
<pre>ExecStart=/usr/bin/java -jar HentaiAtHome.jar --port=1024</pre>
Where <code>1024</code> is a port of your choice in the range 1024–65535.

If your system is behind a router/firewall, you most likely have a port-forwarding rule configured already to make your server accessible from the internet. You'll need to modify this rule to direct traffic from external port 443 to the port selected in the previous step (on your server's local IP address).

Another way to perform port redirection is to apply the following ''iptables'' rule on the server itself:
<pre># iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 1024</pre>
Where <code>eth0</code> is the name of your network interface and <code>1024</code> is your selected port.

Which approach you choose depends on the nature of your network, the features provided by your router, etc.

Once the NAT rule is in place, start the service again:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

Installing H@H on Debian or Ubuntu

2020-03-21T12:20:26Z

Bipface: add section 'Listening on Port 443'

==Prerequisites==

* Basic familiarity with Linux.

* A server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. Check for firewall rules by running <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Listening on Port 443==

H@H will work on most port numbers, however making it accessible on port 443 is recommended as more users will be able to connect to it. On Linux, ports numbers below 1024 are considered ''privileged''. Additional steps are required in order for H@H to utilise ports in the privileged range.

There are multiple options for achieving this. The most common approaches are as follows.

Before proceeding, stop the H@H service (<code># systemctl stop hath</code>) and configure your client to use port 443 on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

===Using POSIX Capabilities===

The easiest solution is to enable the corresponding ''capability'' on the Java binary.

Firstly ensure the <code>setcap</code> utility is installed, by running:
<pre># apt install libcap2-bin</pre>

Next, [[#Defining the H@H Service|edit the H@H unit file]] again, and add the following line in the <code>[Service]</code> section:
<pre>ExecStartPre=+/bin/sh -c 'setcap "cap_net_bind_service=+ep" "$(readlink -f /usr/bin/java)"'</pre>
This will ensure that the Java binary can bind to privileged ports before launching the H@H client.

Now start the service again:
<pre># systemctl start hath</pre>

Note that this approach may not be suitable if your system is using Java for other purposes as well. ''Capabilities'' have been known to cause adverse effects in some cases, so be sure to test any other Java applications present on your system.

===Using Network Address Translation (NAT)===

Alteratively, ''network address translation'' can redirect traffic from your internet-facing port 443 to your H@H client listening on a non-privileged port.

Start by [[#Defining the H@H Service|editing the H@H unit file]] again, and replacing the <code>ExecStart</code> line with:
<pre>ExecStart=/usr/bin/java -jar HentaiAtHome.jar --port=1024</pre>
Where <code>1024</code> is a port of your choice in the range 1024–65535.

If your system is behind a router/firewall, you most likely have a port-forwarding rule configured already to make your server accessible from the internet. You'll need to modify this rule to direct traffic from external port 443 to the port selected in the previous step (on your server's local IP address).

Another way to perform port redirection is to apply the following ''iptables'' rule on the server itself:
<pre># iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 1024</pre>
Where <code>eth0</code> is the name of your network interface and <code>1024</code> is your selected port.

Which approach you choose depends on the nature of your network, the features provided by your router, etc.

Once the NAT rule is in place, start the service again:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface/Installing H@H on Debian or Ubuntu

2020-03-21T12:16:59Z

Bipface:

==Prerequisites==

* Basic familiarity with Linux.

* A server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. Check for firewall rules by running <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Listening on Port 443==

H@H will work on most port numbers, however making it accessible on port 443 is recommended as more users will be able to connect to it. On Linux, ports numbers below 1024 are considered ''privileged''. Additional steps are required in order for H@H to utilise ports in the privileged range.

There are multiple options for achieving this. The most common approaches are as follows.

Before proceeding, stop the H@H service (<code># systemctl stop hath</code>) and configure your client to use port 443 on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

===Using POSIX Capabilities===

The easiest solution is to enable the corresponding ''capability'' on the Java binary.

Firstly ensure the <code>setcap</code> utility is installed, by running:
<pre># apt install libcap2-bin</pre>

Next, [[#Defining the H@H Service|edit the H@H unit file]] again, and add the following line in the <code>[Service]</code> section:
<pre>ExecStartPre=+/bin/sh -c 'setcap "cap_net_bind_service=+ep" "$(readlink -f /usr/bin/java)"'</pre>
This will ensure that the Java binary can bind to privileged ports before launching the H@H client.

Now start the service again:
<pre># systemctl start hath</pre>

Note that this approach may not be suitable if your system is using Java for other purposes as well. ''Capabilities'' have been known to cause adverse effects in some cases, so be sure to test any other Java applications present on your system.

===Using Network Address Translation (NAT)===

Alteratively, ''network address translation'' can redirect traffic from your internet-facing port 443 to your H@H client listening on a non-privileged port.

Start by [[#Defining the H@H Service|editing the H@H unit file]] again, and replacing the <code>ExecStart</code> line with:
<pre>ExecStart=/usr/bin/java -jar HentaiAtHome.jar --port=1024</pre>
Where <code>1024</code> is a port of your choice in the range 1024–65535.

If your system is behind a router/firewall, you most likely have a port-forwarding rule configured already to make your server accessible from the internet. You'll need to modify this rule to direct traffic from external port 443 to the port selected in the previous step (on your server's IP address).

Another way to perform port redirection is to apply the following ''iptables'' rule on the server itself:
<pre># iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 1024</pre>
Where <code>eth0</code> is the name of your network interface and <code>1024</code> is your selected port.

Which approach you choose depends on the nature of your network, the features provided by your router, etc.

Once the NAT rule is in place, start the service again:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface/Installing H@H on Debian or Ubuntu

2020-03-21T12:13:26Z

Bipface:

==Prerequisites==

* Basic familiarity with Linux.

* A server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. Check for firewall rules by running <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Listening on Port 443==

H@H will work on most port numbers, however making it accessible on port 443 is recommended as more users will be able to connect to it. On Linux, ports numbers below 1024 are considered ''privileged''. Additional steps are required in order for H@H to utilise ports in the privileged range.

There are multiple options for achieving this. The most common approaches are as follows.

Before proceeding, stop the H@H service (<code># systemctl stop hath</code>) and configure your client to use port 443 on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

===Using POSIX Capabilities===

The easiest solution is to enable the corresponding ''capability'' on the Java binary.

Firstly ensure the <code>setcap</code> utility is installed, by running:
<pre># apt install libcap2-bin</pre>

Next, [[#Defining the H@H Service|edit the H@H unit file]] again, and add the following line in the <code>[Service]</code> section:
<pre>ExecStartPre=+/bin/sh -c 'setcap "cap_net_bind_service=+ep" "$(readlink -f /usr/bin/java)"'</pre>
This will ensure that the Java binary can bind to privileged ports before launching the H@H client.

Now start the service again:
<pre># systemctl start hath</pre>

Note that this approach may not be suitable if your system is using Java for other purposes as well. Using <code>setcap</code> has been known to cause adverse effects in some cases, so be sure to test any other Java applications present on your system.

===Using Network Address Translation (NAT)===

An alterative approach is using ''network address translation '' to redirect traffic from your internet-facing port 443 to your H@H client listening on a non-privileged port.

Start by [[#Defining the H@H Service|editing the H@H unit file]] again, and replacing the <code>ExecStart</code> line with:
<pre>ExecStart=/usr/bin/java -jar HentaiAtHome.jar --port=1024</pre>
Where <code>1024</code> is a port of your choice in the range 1024–65535.

If your system is behind a router/firewall, you most likely have a port-forwarding rule configured already to make your server accessible from the internet. You'll need to modify this rule to direct traffic from external port 443 to the port selected in the previous step (on your server's IP address).

Another way to perform port redirection is to apply the following ''iptables'' rule on the server itself:
<pre># iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 1024</pre>
Where <code>eth0</code> is the name of your network interface and <code>1024</code> is your selected port.

Which approach you choose depends on the nature of your network, the features provided by your router, etc.

Once the NAT rule is in place, start the service again:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface/Installing H@H on Debian or Ubuntu

2020-03-21T11:37:13Z

Bipface:

==Prerequisites==

* Basic familiarity with Linux.

* A server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. Check for firewall rules by running <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Using Port 443==

H@H will work on most port numbers, however making it accessible on port 443 is recommended as more users will be able to connect to it. On Linux, ports numbers below 1024 are considered ''privileged''. Additional steps are required in order for H@H to utilise ports in the privileged range.

There are multiple options for achieving this. The most common approaches are as follows.

Before proceeding, stop the H@H service (<code># systemctl stop hath</code>) and configure your client to use port 443 on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

===POSIX Capabilities===

The easiest solution is to enable the corresponding ''capability'' on the Java binary.

Firstly ensure the <code>setcap</code> utility is installed, by running:
<pre># apt install libcap2-bin</pre>

Next, [[#Defining the H@H Service|edit the H@H unit file]] again, and add the following line in the <code>[Service]</code> section:
<pre>ExecStartPre=+/bin/sh -c 'setcap "cap_net_bind_service=+ep" "$(readlink -f /usr/bin/java)"'<pre>
This will ensure that the Java binary can bind to privileged ports before launching the H@H client.

Now start the service again:
<pre># systemctl start hath</pre>

Note that this approach may not be suitable if your system is using Java for other purposes as well. Using <code>setcap</code> has been known to cause adverse effects in some cases, so be sure to test any other Java applications present on your system.

===Port Forwarding===

An alterative approach is using port forwarding to redirect traffic from your internet-facing port 443 to your H@H client listening on a non-privileged port.

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

Installing H@H on Debian or Ubuntu

2020-03-21T10:11:11Z

Bipface: /* Prerequisites */

Installing H@H on Debian

2020-03-17T01:11:02Z

Bipface: redirect to consolidated guide

#REDIRECT [[Installing_H@H_on_Debian_or_Ubuntu]]

==Requirements==
* Being able to use Google.

* Basic Linux knowledge.

* A running Debian GNU/Linux server.

* A Java 8 Runtime Environment or above (H@H 1.6.0)

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

===A couple things to be aware of before starting===

* Linux IS case sensitive on file names. Therefore, it is best to use lower case names everywhere to make it easier for yourself.

* Commands you should type are given in Green;
* Output from the command prompt is given in Red;
* Text in commands that you'll probably need to change is given in Blue.
* Commands starting with '''$''' are to be run as current user, those starting with '''#''' - as root (using su/sudo).
* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the ntp package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

* This manual is based on a virtual server (VPS/VDS). The use of a physical server, home PC or any program other than VMware to virtualize your server may require doing some things differently.

==Installing Java - Using packages==

[[File:Point.png]] '''Don't use Debian 8's repository for H@H 1.6.0 and above.''' The JRE provided in the packages for Debian 8 is Java 7, and H@H 1.6.0 needs Java 8 or above.
If you are running Debian 8, install Java by using a downloaded archive, like described in the next section.

To run the H@H server you will have to have Java installed on the server.
The best and easiest method is to use the Debian packages.

To do so, connect to your server, and run the following commands either as root, or by prefixing them by sudo (if you have the sudo package installed):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># apt-get update
# apt-get install default-jre</pre>

And that's it, you're already done. Simple isn't it?

==Installing Java - Using a downloaded archive==
If you can't (or don't want to) use the method that uses the Debian packages, you can download and install your package on the Oracle website.
Select your Java package on [https://www.oracle.com/technetwork/java/javase/downloads/index.html official download page], accept license and copy download link depending on your OS (32-bit/64-bit).

For our case JDK isn't needed. If you need some monitoring tools (and know how to use them) - pick Server JRE. Otherwise, your choice is JRE.

Download the JRE can be with the following command:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget --no-cookies --header "Cookie: oraclelicense=accept-securebackup-cookie" "https://download.oracle.com/otn-pub/java/jdk/7u80-b15/jdk-7u80-linux-x64.tar.gz"</pre>

Create directory for JVM in /opt:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># mkdir /opt/java-oracle</pre>

Unpack the downloaded archive in /opt:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># tar -zxf jre-7u67-linux-x64.tar.gz -C /opt/java-oracle</pre>

Set our JVM to be used as the default Java on the system:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ Java_Home=/opt/java-oracle/jre1.7.0_67
# update-alternatives --install /usr/bin/java java ${Java_Home%*/}/bin/java 20000
# update-alternatives --install /usr/bin/javac javac ${Java_Home%*/}/bin/javac 20000
# update-alternatives --install /usr/bin/javaws javaws ${Java_Home%*/}/bin/javaws 20000</pre>

Verify (or set) JVM to be used as a default Java on the system:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># update-alternatives --config java
There is only one alternative in link group java (providing /usr/bin/java): /opt/java-oracle/jre1.7.0_67/bin/java
Nothing to configure.</pre>

Verify Java version:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ java -version
java version "1.7.0_67"
Java(TM) SE Runtime Environment (build 1.7.0_67-b01)
Java HotSpot(TM) 64-Bit Server VM (build 24.65-b04, mixed mode)</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Controlling H@H with the screen utility==

To make it very short and simple, the screen utility is a package available in many Linux distributions, that allows one to run commands in a dedicated environement. It is very useful when it comes to run a H@H client, as you can simply start your H@H client in a "screen" and leave it there to work, allowing you to perform other actions, like closing your SSH connection.

===Installing the screen utility===

First, download and install the package from the depository:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ apt-get install screen</pre>
And that's all.

===Using the screen utility to control your H@H client===

First connect to your server using a SSH connection, as the user 'hath'. Then start the screen utility by entering the following command:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ screen -r</pre>

You are now "inside" the screen utility, which looks and acts just like the command line. You can control the utility itself with the following key combinations:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">'''Ctrl+A, then C''' - Create a new screen window
'''Ctrl+A, then N''' - Switch to next screen window
'''Ctrl+A, then P''' - Switch to previous screen window
'''Ctrl+A, then K''' - Kill the current screen window
'''Ctrl+A, then D''' - Detach from the screen utility (quit without closing)
</pre>

To start your H@H client, follow these steps:
#Create a new window (Ctrl+A, then N)
#Start your H@H client in the window's command line
#Detach from the screen utility (Ctrl+A, then D)
#You can now close your SSH connection, the H@H client will keep running.

[[File:Point.png]] '''Always detach from the screen utility before closing your SSH connection.''' Otherwise, the screen utility and its windows will be killed, which means your H@H client will be shut down improperly.

You can control how your client is performing later on, by connecting to your server and perform the following actions:
#Start the scren utility (screen -r)
#Browse through your windows with Ctrl+A, then P (previous) or N (next) until you see your H@H client's command line
#Again, use Ctrl+A then D to detach once you're done
#You can close the SSH connection

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

Installing H@H on Ubuntu

2020-03-17T01:09:00Z

Bipface: redirect to consolidated guide

#REDIRECT [[Installing_H@H_on_Debian_or_Ubuntu]]

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)

==Requirements==
*Being able to search Google.

*Basic Linux knowledge is recommended.

*A running Linux server (I used version 12.04) (for setting one up refer to: https://www.howtoforge.com/perfect-server-ubuntu-12.04-lts-apache2-bind-dovecot-ispconfig-3 page 1 and 2)

*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.

*You have an “active” H@H client (https://e-hentai.org/hentaiathome.php) if not you will have to request this first.

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

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo nano /etc/network/interfaces</pre>
The file that is opened should look something like this:

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">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</pre>

Below where it says “# The primary network interface”

Type in this information:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">auto eth0
iface eth0 inet static
address 192.168.0.100
netmask 255.255.255.0
gateway 192.168.0.1
dns-nameservers 192.168.0.1</pre>

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.

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo /etc/init.d/networking restart</pre>

You can check and see if your IP has changed by typing:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">ifconfig</pre>

You should see something like this:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">eth0 Link encap:Ethernet HWaddr 00:00:00:00:00:00
inet addr:192.168.0.100 Bcast:192.168.0.255 Mask:255.255.255.0
inet6 addr: ffff::fff:ffff:ffff:ffff/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
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)</pre>

The second line is what is important.

You can test and see if the network is working by pinging an internet server:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">ping google.com</pre>
If this returns an error try pinging:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">ping 8.8.8.8</pre>
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.
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo apt-get update
sudo apt-get upgrade</pre>

==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:

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo apt-get update</pre>

Then, check if Java has already been installed:

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">java -version</pre>

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

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo apt-get install default-jre</pre>

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

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">java -version</pre>

If properly installed, the expected output is:

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">
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)
</pre>

===Oracle Java 6 Installation===
(old source: http://www.devsniper.com/ubuntu-12-04-install-sun-jdk-6-7/ 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 https://www.oracle.com/technetwork/java/javase/downloads/index.html)

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">wget --no-cookies --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F" "https://download.oracle.com/otn-pub/java/jdk/6u32-b05/jdk-6u32-linux-x64.bin"</pre>

Extract the (bin) file:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">./jdk-6u32-linux-x64.bin</pre>

If you type «ls» you should now see 2 files:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">jdk1.6.0_32 jdk-6u32-linux-x64.bin</pre>

Now move the extracted file:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo mv jdk1.6.0_32 /usr/lib/jvm/</pre>

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

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">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</pre>

Now tell the server that this java installation is the default one (as 3 separate commands):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo update-alternatives --config javac
sudo update-alternatives --config java
sudo update-alternatives --config javaws</pre>

To verify the installation is complete type:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">java -version</pre>

You should see this message:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">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)</pre>

===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
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">su -</pre>

Download and exract files
(Official download is here https://www.oracle.com/technetwork/java/javase/downloads/index.html)
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">wget --no-cookies --header "Cookie: gpw_e24=http%3A%2F%2Fwww.oracle.com%2F" "https://download.oracle.com/otn-pub/java/jdk/7u9-b05/jdk-7u9-linux-x64.tar.gz"
tar xvfo jdk-7u9-linux-x64.tar.gz</pre>

Move java files into their place
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">mkdir /usr/lib/jvm
mv jdk1.7.0_09 /usr/lib/jvm/jdk1.7.0_09</pre>

Set alternatives links
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">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</pre>

Config alternatives links
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">update-alternatives --config java
update-alternatives --config javac
update-alternatives --config javaws</pre>

Verify java version
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">java -version</pre>

(Expected output)
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">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)</pre>

==Installing H@H==
Download H@H (check the newest version in [https://e-hentai.org/hentaiathome.php here])

To download H@H first make a new directory for where you want to run the files from:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo mkdir /home/”username”/hath

cd /home/”username”/hath</pre>
This creates a folder called “hath” in your home directory and moves you to it. Now download the H@H program by typing:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo wget hentaiathome.net/get/HentaiAtHome_1.2.1.zip</pre>
This might take time depending on your network speed.

When finished downloading you will have to install “unzip” to unzip the file. Type:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo apt-get install unzip</pre>

Now unzip the file by typing:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo unzip HentaiAtHome_1.2.1.zip</pre>
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:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">java -jar HentaiAtHome.jar</pre>
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:
https://e-hentai.org/hentaiathome.php

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
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo java -jar /home/"username"/hath/HentaiAtHome.jar</pre>

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:

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">nohup java -jar /home/"username"/hath/HentaiAtHome.jar &</pre>

or

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">nohup java -jar HentaiAtHome.jar &</pre> 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):

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">ps aux | grep -i hentai</pre>

Result similar to the following will be returned:

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">
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
</pre>

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

<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">sudo kill xxxx</pre>

==Troubleshooting==
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):
https://askubuntu.com/questions/37753/how-can-i-get-apt-to-use-a-mirror-close-to-me-or-choose-a-faster-mirror

As always check the [[Technical_Issues#H.40H | H@H technical issues]] first!

For problems after starting the H@H program that are not explained in the FAQ make a forum post [https://forums.e-hentai.org/index.php?showforum=7 here].

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


==See also==
*[[Hentai@Home]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

Installing H@H on Debian or Ubuntu

2020-03-17T00:37:36Z

Bipface: create page

User:Bipface/Installing H@H on Debian or Ubuntu

2020-03-05T12:13:15Z

Bipface: /* Prerequisites */

User:Bipface/Installing H@H on Debian or Ubuntu

2020-03-05T12:11:28Z

Bipface: /* Prerequisites */

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root. Check for firewall rules by running <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface/Installing H@H on Debian or Ubuntu

2020-03-05T12:10:43Z

Bipface: /* Prerequisites */

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root. Check for firewall rules with <code># iptables --list-rules</code>.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T13:24:30Z

Bipface: Blanked the page

User:Bipface/Installing H@H on Debian or Ubuntu

2020-03-04T13:23:40Z

Bipface: Created page with "==Prerequisites== * Basic familiarity with Linux. * A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or ne..."

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T13:18:19Z

Bipface: /* Testing and Monitoring */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T13:16:14Z

Bipface: /* Overview */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd ''unit file'') to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T13:15:06Z

Bipface: /* Take Note */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package, which keeps the server's date and time in sync. It is normally installed by default.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T13:13:37Z

Bipface: /* Take Note */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates might cause it to fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T13:12:21Z

Bipface: /* Optional Tools */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code># apt install</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T13:11:00Z

Bipface:

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Testing and Monitoring==

You can see the current status of your H@H service by running:
<pre># systemctl status hath</pre>
The output should indicate whether the service is active, and shows the last few lines of console output from the H@H process itself.

You can also read the two log files <code>log_out</code> and <code>log_err</code>, which are found in <code>/home/hath/log/</code>.

One way to confirm that the client is listening for connections is to open <code>https://ADDRESS:PORT/robots.txt</code> in a web browser, where <code>PORT</code> is the port number configured for the client and <code>ADDRESS</code> is the internet-facing IP address of your server. If the connection is established the browser will most likely present a HTTPS certificate error – bypass the error and a text file should be served to you.

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T12:30:09Z

Bipface: /* Defining the H@H Service */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Use the following command to create a new ''unit file'' defining the service:
<pre># systemctl edit hath.service --full --force</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>
(The line <code>SuccessExitStatus=143</code> is needed because the Java process may return a non-zero exit code even after a graceful shutdown).

Now start the service:
<pre># systemctl start hath</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T12:19:33Z

Bipface: /* Optional Tools */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Using your preferred text editor (such as <code>nano</code>), create a new ''unit file'' to define the service:
<pre># nano /etc/systemd/system/hath.service</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Ensure the new service is loaded by running:
<pre># systemctl daemon-reload</pre>

Now start the service:
<pre># systemctl start hath</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T12:17:41Z

Bipface: /* Prerequisites */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Using your preferred text editor (such as <code>nano</code>), create a new ''unit file'' to define the service:
<pre># nano /etc/systemd/system/hath.service</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Ensure the new service is loaded by running:
<pre># systemctl daemon-reload</pre>

Now start the service:
<pre># systemctl start hath</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T12:17:16Z

Bipface: /* Defining the H@H Service */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Using your preferred text editor (such as <code>nano</code>), create a new ''unit file'' to define the service:
<pre># nano /etc/systemd/system/hath.service</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Ensure the new service is loaded by running:
<pre># systemctl daemon-reload</pre>

Now start the service:
<pre># systemctl start hath</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:51:15Z

Bipface:

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

Using your preferred text editor (such as <code>nano</code>), create a new ''unit file'' to define the service:
<pre># nano /etc/systemd/system/hath.service</pre>

Insert the following text and save the file:
<pre>[Unit]
Description=Hentai@Home
After=local-fs.target remote-fs.target network.target

[Service]
Type=simple
User=hath
WorkingDirectory=/home/hath
SuccessExitStatus=143
ExecStart=/usr/bin/java -jar HentaiAtHome.jar
Restart=on-failure

[Install]
WantedBy=multi-user.target</pre>

Now start the service:
<pre>systemctl start hath</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:38:21Z

Bipface: /* Preparing the H@H Client */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

Launch the client by running:
<pre>$ java -jar HentaiAtHome.jar</pre>
You should be prompted to enter your ''Client ID'' and ''Client Key'', which can be found on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

Once the client has successfully authenticated with the server, press <code>ctrl+C</code> to quit the client, then proceed to the next section.

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:28:39Z

Bipface: /* Preparing the H@H Client */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software: (Replace <code>VERSION</code> with the version number of the latest release, which you can find on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page)
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:28:03Z

Bipface: /* Preparing the H@H Client */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

It is recommended to create a dedicated service account to run the H@H client. This is achieved with the command:
<pre># adduser hath</pre>

Login as the newly created user, then download and extract the H@H client software:
<pre># login hath
$ wget 'https://repo.e-hentai.org/hath/HentaiAtHome_VERSION.zip'
$ unzip HentaiAtHome_VERSION.zip</pre>
Replace <code>VERSION</code> with the version number of the latest release, which you can find on the [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] page.

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:24:07Z

Bipface: /* Prerequisites */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

(todo)

wget

unzip

enter keys

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:23:39Z

Bipface: /* Prerequisites */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which the client can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

(todo)

wget

unzip

enter keys

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:23:11Z

Bipface: /* Prerequisites */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* One or more 'active' [https://e-hentai.org/hentaiathome.php Hentai@Home Clients] on your account.

* An open port through which H@H can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

(todo)

wget

unzip

enter keys

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:06:00Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An 'active' H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

(todo)

wget

unzip

enter keys

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-04T11:05:36Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An 'active' H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

(todo)

wget

unzip

enter keys

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-03T11:16:03Z

Bipface:

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An 'active' H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H Client==

(todo)

wget

unzip

enter keys

==Defining the H@H Service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and Monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-03T11:15:12Z

Bipface: /* Prerequisites */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An 'active' H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet, as explained in the [[Hentai@Home#Minimum Requirements|minimum requirements]] section. In particular, you may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional Tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take Note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H software==

(todo)

wget

unzip

enter keys

==Defining the H@H service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-03T11:08:08Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>
If you're planning to use H@H in GUI mode at any point, you should instead install the package <code>default-jre</code> (without the ''-headless'' suffix). Otherwise, the headless package will suffice.

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H software==

(todo)

wget

unzip

enter keys

==Defining the H@H service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-03T11:01:08Z

Bipface: /* Optional tools */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', standard command-line tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H software==

(todo)

wget

unzip

enter keys

==Defining the H@H service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:43:36Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', interactive tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

Once complete, run <code>$ java -version</code> again to verify the result.

==Preparing the H@H software==

(todo)

wget

unzip

enter keys

==Defining the H@H service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:38:27Z

Bipface:

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', interactive tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

Once complete, run <code>$ java -version</code> again to verify.

==Preparing the H@H software==

(todo)

wget

unzip

enter keys

==Defining the H@H service==

(todo)

# nano /etc/systemd/system/hath.service

adduser

systemctl start hath

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
(todo)

https://<ip>:<port>/robots.txt

systemctl status hath

==See also==
*[[Hentai@Home]]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:27:02Z

Bipface: /* Optional tools */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

On some distributions, such as ''Minimal Ubuntu'', interactive tools might not be present by default. Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

Once complete, run <code>$ java -version</code> again to verify.

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
https://<ip>:<port>/robots.txt
systemctl status hath

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:20:41Z

Bipface: /* Optional tools */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

Once complete, run <code>$ java -version</code> again to verify.

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
https://<ip>:<port>/robots.txt
systemctl status hath

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:17:44Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>, to download the H@H software.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has a suitable Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Examine the default JRE package by running:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: '''openjdk-8'''-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

Once complete, run <code>$ java -version</code> again to verify.

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
https://<ip>:<port>/robots.txt
systemctl status hath

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:13:02Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>, to download the H@H software.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has an appropriate Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Next, run:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: openjdk-8-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites|Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
https://<ip>:<port>/robots.txt
systemctl status hath

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:11:14Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>, to download the H@H software.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has an appropriate Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Next, run:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: openjdk-8-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequisites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
https://<ip>:<port>/robots.txt
systemctl status hath

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T13:09:28Z

Bipface: /* Installing Java */

(draft)

==Prerequisites==

* Basic familiarity with Linux.

* A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer. To use earlier versions you will need to determine how to install a '''Java 8''' runtime, which may not be a straightforward process and is beyond the scope of this guide.

* Root access to your server (i.e. <code>su</code>/<code>sudo</code>).

* PuTTY or any other SSH program to connect to your server. This allows for copying/pasting of commands.

* An “active” H@H client (https://e-hentai.org/hentaiathome.php).

* An open port through which H@H can accept connections from the internet. You may need to choose a port number greater than 1023 to avoid having to run the H@H client as root.

* This guide assumes a server-style environment, typical of VPS/cloud-hosted systems. Installation on desktop or IoT systems, for example, may require doing some things differently.

===Optional tools===

To perform the installation, you may also require the following:

* A command-line HTTP client such as <code>wget</code> or <code>curl</code>, to download the H@H software.

* A zip-file extractor such as <code>unzip</code>.

* A text editor such as <code>nano</code> or <code>vi</code>.

Use <code>apt</code> to install these packages as needed.

===Take note===

* Linux is case-sensitive with file names. Therefore, it is best to use lowercase names everywhere to make it easier for yourself.

* Commands starting with '''$''' are to be run as current user, those starting with '''#''' as root.

* Before installing packages, refresh the package manager by running <code># apt update</code>.

* H@H 1.6.0 and above uses SSL certificates. For them to work properly, you need the '''ntp''' package (it syncs the server's date and time). It is normally installed by default, but package updates may make it fail.

==Overview==

At a glance, the steps to install H@H are as follows, with further details in the subsequent sections:

* Install a Java version 8 (or newer) runtime environment.

* Obtain and configure the latest H@H client software.

* Define a service (systemd 'unit' file) to run it.

==Installing Java==

Start by checking whether a Java runtime is already available by running:
<pre>$ java -version</pre>
A result such as <code>openjdk version "1.8.0_242"</code>, where the version number is 1.8 or greater, indicates that your server has an appropriate Java runtime and you can skip to the next section.

If you see a result such as <code>java: command not found</code>, no Java runtime is installed yet.

Next, run:
<pre># apt show default-jre-headless</pre>
You should expect to find a line in the output such as <code>Depends: openjdk-8-jre-headless, java-common</code>. If '''openjdk-7''' or lower is listed instead, your OS version may be too old to install a Java 8 runtime by conventional means — refer to the [[#Prerequesites]] section.

Install the JRE by running:
<pre># apt install default-jre-headless</pre>

==Installing H@H==

For more security let's create new user for H@H:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># adduser hath</pre>

Now login as the new user and create a directory for H@H client:
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"># login hath
$ mkdir hath</pre>

Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</pre>

Unzip the downloaded archive (install unzip if you haven't yet):
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ unzip HentaiAtHome_1.4.2.zip -d hath/</pre>

Well done, let's launch it!
<pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}">$ cd hath
$ java -jar HentaiAtHome.jar</pre>

You will be prompted for your client ID and Password which you can find on [https://e-hentai.org/hentaiathome.php your H@H page]

You will need to configure your client settings on the above page before you get your 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.

==Testing and monitoring==
https://<ip>:<port>/robots.txt
systemctl status hath

==See also==
*[[Hentai@Home]]
*[[Installing H@H on Ubuntu]]
*[https://forums.e-hentai.org/index.php?showtopic=19795&st=0&p=797807&#entry797807 Advanced Linux Installation]

[[Category:E-Hentai Galleries]]

User:Bipface

2020-03-02T12:47:16Z

Bipface: /* Take note */

User:Bipface

2020-03-02T12:45:40Z

Bipface: /* Take note */

User:Bipface

2020-03-02T12:41:43Z

Bipface: /* Installing Java */

User:Bipface

2020-03-02T12:37:38Z

Bipface: /* Installing Java */