|
|
| (25 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| (draft)
| |
|
| |
|
| ==Prerequisites==
| |
|
| |
| * Basic familiarity with Linux.
| |
|
| |
| * A Linux server running '''Debian version 9''' (''Stretch'') or newer, or '''Ubuntu version 16''' (''Xenial Xerus'') or newer.<br>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.<br>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|}}}"><FONT COLOR="1FD30D"># adduser <FONT COLOR="35A4D6">hath</FONT></FONT></pre>
| |
|
| |
| Now login as the new user and create a directory for H@H client:
| |
| <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><FONT COLOR="1FD30D"># login <FONT COLOR="35A4D6">hath</FONT>
| |
| $ mkdir <FONT COLOR="35A4D6">hath</FONT></FONT></pre>
| |
|
| |
| Download H@H (check for the latest version [https://e-hentai.org/hentaiathome.php here]):
| |
| <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><FONT COLOR="1FD30D">$ wget https://repo.e-hentai.org/hath/HentaiAtHome_1.4.2.zip</FONT></pre>
| |
|
| |
| Unzip the downloaded archive (install unzip if you haven't yet):
| |
| <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><FONT COLOR="1FD30D">$ unzip HentaiAtHome_1.4.2.zip -d <FONT COLOR="35A4D6">hath/</FONT></FONT></pre>
| |
|
| |
| Well done, let's launch it!
| |
| <pre<includeonly></includeonly> style="overflow: auto;{{{style|}}}"><FONT COLOR="1FD30D">$ cd <FONT COLOR="35A4D6">hath</FONT>
| |
| $ java -jar HentaiAtHome.jar</FONT></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]]
| |
