Hostsharing Wiki - Letzte Änderungen [de]

Jetty Installieren

Peh00 — Wed, 28 Oct 2026 19:25:00 GMT

Initiale Version

Neue Seite

Jetty installieren

== Allgemein ==

[https://jetty.org/ Eclipse Jetty] ist ein Webserver (HTTP-Server), der in der Programmiersprache Java entwickelt ist. Er dient in erster Linie dazu, dynamische Web-Anwendungen zu betreiben, die ebenfalls in Java programmiert sind. Basis-Technologien sind [http://de.wikipedia.org/wiki/Servlet Java-Servlets] und [http://de.wikipedia.org/wiki/JSP Java Server Pages (JSP)].

Jetty ist eine Alternative zu Apache Tomcat.

== Spezielle Installation bei Hostsharing ==

In jedem dynamischen Webhosting-Paket der Hostsharing eG können einer (oder mehrere) Jetty-Webserver betrieben werden.

Die hier beschriebene Installation benötigt bei Hostsharing die Paket-Option "RAM". Benötigt werden min. 512 MB. Im Managed Webspace ist diese Option kostenpflichtig: https://www.hostsharing.net/angebote/managed-webspace/ gebucht werden muss der RAM auch bei einem Managed-Server.

Diese Anleitung dokumentiert die Installation des Eclispe Jetty Servers als Service-User in einem WEB-Paket bei Hostsharing. Mit der Einrichtung der Option "eigener Serverdienst" werden für die Paket-IP-Adresse einer oder mehrere IP-Ports reserviert. An diese Ports wird der eigene Serverdienst (also der Tomcat-Server) am Localhost-Interface gebunden.

Bei der Anmeldung (bei service(at)hostsharing.net bitte angeben:

# den Service User, mit dessen Rechten der Jetty-Dienst laufen soll (also zum Beispiel "xyz00-jetty")
# wieviele IP-Ports reserviert werden sollen (in der folgenden Anleitung wird ein Port am Localhost-Interface genutzt): '34567' für einen HTTP/1.1-Listener

== Installation ==

Auf der Hostsharing-Plattform ist Java 17 in Form des OpenJDK 17 aus der Debian-Distribution vorinstalliert. Java 17 ist als Laufzeitumgebung für den aktuellen Jetty 12.x ausreichend.

Wir laden Jetty als '.tar.gz'-Datei von [https://jetty.org/download.html jetty.org/download.html]. Aktuell ist 'jetty-home-12.1.14.tar.gz':

<syntaxhighlight lang="bash">
wget https://repo1.maven.org/maven2/org/eclipse/jetty/jetty-home/12.1.14/jetty-home-12.1.14.tar.gz
</syntaxhighlight>

Mit 'tar' wird das Archiv als Verzeichnis 'jetty-home-12.1.4' entpackt:

<syntaxhighlight lang="bash">
tar xzf jetty-home-12.1.14.tar.gz
</syntaxhighlight>

Für unsere eigene Konfiguration kommt ein Verzeichnis 'jetty-base' neben das entpackte Archiv:

<syntaxhighlight lang="bash">
mkdir ~/jetty-base
cd ~/jetty-base
export JETTY_BASE=$HOME/jetty-base
export JETTY_HOME=$HOME/jetty-home-12.1.4
</syntaxhighlight>

Initial konfigurieren wir (hier im Beispiel) den Jetty für den Java Enterprise Standard 'JEE 8'. Das war die letzte Version vor der Umbenennung vom 'javax' in den 'jakarta'-Namensraum. Jetty unterstützt zur Zeit die JEE-Standards bis 'JEE 11'.

Wir initialisieren unsere Konfiguration in 'jetty-base' mit:

<syntaxhighlight lang="bash">
cd $JETTY_BASE
java -jar $JETTY_HOME/start.jar --add-modules=server,http,ee8-deploy,ee8-jsp
</syntaxhighlight>

Die Start-Konfiguration wird in '$JETTY_BASE/start.d' angelegt. Wir passen von Hand den HTTP-Listener in der Datei 'http.ini' im Verzeichnis 'start,d' an:

<syntaxhighlight lang="ini">
jetty.http.host=127.0.0.1
jetty.http.port=34567
</syntaxhighlight>

Angepasst werden muss:
* der IP-Port (im Beispiel 34567 am Localhost-Interface)

== Deployment einer Anwendung ==

In der Beispiel-Konfiguration wurde das Verzeichnis ''~/jetty-base/webapps/'' für die Anwendungen konfiguriert. Wir legen dieses Verzeichnis an und kopieren eine minimale Anwendung hinein:

<syntaxhighlight lang="bash">
mkdir -p $HOME/jetty-base/webapps/hello/WEB-INF/
</syntaxhighlight>

Dort legen wir die Datei $HOME/jetty-base/webapps/hello/WEB-INF/web.xml mit folgendem Inhalt an:

<syntaxhighlight lang="xml" line>
<?xml version="1.0" encoding="UTF-8"?>
<web-app
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID" version="3.0">
</web-app>
</syntaxhighlight>

Dazu eine einfache JSP-Datei $HOME/jetty-base/webapps/hello/index.jsp:

<syntaxhighlight lang="html" line>
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html lang="de-de">
<body>
<h1>Hallo Welt</h1>
<p>Java Version: <%= System.getProperty("java.version") %></p>
</body>
</html>
</syntaxhighlight>

Nun können wir die HTTP-Requests, die an eine Domain im Paket gesendet werden, an den Jetty weiterleiten.
Das funktioniert über eine ''.htaccess''-Datei, zum Beispiel im Verzeichnis ''~/doms/hs-example.de/htdocs-ssl'':

<syntaxhighlight lang="apache" line>
DirectoryIndex disabled
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule ^(.*) http://127.0.0.1:34567/$1 [proxy,last]
</syntaxhighlight>

Achtung der IP-Port 34567 muss hier wieder angepasst werden!

Dadurch ist die Mini-Anwendung unter der URL "https://hs-example.de/hello/" erreichbar.

== Start des Jetty ==

Damit Jetty bei einem Reboot der Hostsharing-Server automatisch gestartet wird, konfigurieren wir den Prozessmonitor ''systemd'' entsprechend.

Wir legen ein Verzeichnis für die Konfiguration des ''systemd'' an und legen eine Unit-Konfiguration für einen Service dort ab:

<syntaxhighlight lang="bash">
mkdir -p ~/.config/systemd/user
</syntaxhighlight>

Die Unit-Datei ''~/.config/systemd/user/jetty.service''

<syntaxhighlight lang="ini" line>
[Unit]
Description=Jetty

[Service]
Type=simple
WorkingDirectory=%h/jetty-base
Environment="JETTY_BASE=%h/jetty-base"
Environment="JETTY_HOME=%h/jetty-home-12.1.14"
ExecStart=/usr/bin/java -jar %h/jetty-home-12.1.14/start.jar
Restart=always
PrivateTmp=true
MemoryAccounting=true
CPUAccounting=true
MemoryHigh=768M
MemoryMax=1024M

[Install]
WantedBy=default.target
</syntaxhighlight>

== Links ==

*[https://jetty.org/ Eclipse Jetty]

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]
[[Kategorie:Java]]
[[Kategorie:Eigene Daemons]]

Gancio

Peh — Tue, 27 Oct 2026 19:03:58 GMT

Gancio als Dienst einrichten

← Nächstältere Version		Version vom 27. Oktober 2026, 19:03 Uhr
Zeile 147:		Zeile 147:
	MemoryAccounting=true		MemoryAccounting=true
	CPUAccounting=true		CPUAccounting=true
	MemoryHigh=~~768K~~		MemoryHigh=768M
	MemoryMax=~~1024K~~		MemoryMax=1024M

	[Install]		[Install]
	WantedBy=default		WantedBy=default.target
	</syntaxhighlight>		</syntaxhighlight>

Discourse installieren

Tim00 — Thu, 22 Oct 2026 04:33:46 GMT

Am Beispiel von 2026.1.7 auf 2026.7.2

← Nächstältere Version		Version vom 22. Oktober 2026, 04:33 Uhr
Zeile 423:		Zeile 423:
	# RAILS_ENV=production bundle exec rake db:migrate		# RAILS_ENV=production bundle exec rake db:migrate
	# RAILS_ENV=production bundle exec rake assets:precompile		# RAILS_ENV=production bundle exec rake assets:precompile
	# Services neu starten		# Services neu starten: ~/bin/restart.sh
	~~<syntaxhighlight lang=shell>~~
	~~systemctl --user~~ restart ~~discourse~~
	~~systemctl --user restart sidekiq~~
	~~systemctl --user restart redis~~
	~~</syntaxhighlight>~~
	* Zuletzt: Read-Only Modus wieder deaktivieren		* Zuletzt: Read-Only Modus wieder deaktivieren

LeafWiki installieren

Peh00 — Fri, 16 Oct 2026 13:14:31 GMT

← Nächstältere Version		Version vom 16. Oktober 2026, 13:14 Uhr
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1:		Zeile 1:

	LeafWiki ist eine moderne Wiki-Software, die in der Programmiersprache "Go" entwickelt wird. LeafWiki ist ein ~~jungen~~ Projekt. Die Version v0.1.0 im im Mai 2025 erschienen. Aktuell ist heute, am 15. Oktober 2026, die Version v0.14.1. Etwa monatlich erscheinen neue Versionen.		LeafWiki ist eine moderne Wiki-Software, die in der Programmiersprache "Go" entwickelt wird. LeafWiki ist ein junges Projekt. Die Version v0.1.0 ist im Mai 2025 erschienen. Aktuell ist heute, am 15. Oktober 2026, die Version v0.14.1. Etwa monatlich erscheinen neue Versionen.

	LeafWiki verwendet Markdown als Wiki-Markup. Die Markdown-Dateien werden auf der Festplatte gespeichert. Eine Datenbank wird nicht benötigt. ~~Eine~~ Metadaten werden jedoch mit Hilfe von SQLite gespeichert.		LeafWiki verwendet Markdown als Wiki-Markup. Die Markdown-Dateien werden auf der Festplatte gespeichert. Eine Datenbank wird nicht benötigt. Einige Metadaten werden jedoch mit Hilfe von SQLite gespeichert.

	== Technische Details ==		== Technische Details ==

	Die LeafWiki-Software steht als Binärprogramm ~~ohen~~ weitere Abhängigkeiten zur Verfügung. Das macht die Installation sehr einfach.		Die LeafWiki-Software steht als Binärprogramm ohne weitere Abhängigkeiten zur Verfügung. Das macht die Installation sehr einfach.

	== Installation ==		== Installation ==
Zeile 71:		Zeile 71:

	Als letzte Aktion richten wir den leafwiki-Prozess als Service ein. Dazu legen wir die Unit-Definition in der Datei '~/.config/systemd/user/leafwiki.service' an:		Als letzte Aktion richten wir den leafwiki-Prozess als Service ein. Dazu legen wir die Unit-Definition in der Datei '~/.config/systemd/user/leafwiki.service' an:


	[Unit]		[Unit]
Zeile 86:		Zeile 85:
	WantedBy=default.target		WantedBy=default.target

			Den Dienst starten und aktivieren mit:

			systemctl --user daemon-reload
			systemctl --user start leafwiki.service
			systemctl --user enable leafwiki.service

			Viel Spaß mit Leafwiki!

	== Links ==		== Links ==

LeafWiki installieren

Peh00 — Thu, 15 Oct 2026 18:15:17 GMT

erste version

Neue Seite

LeafWiki ist eine moderne Wiki-Software, die in der Programmiersprache "Go" entwickelt wird. LeafWiki ist ein jungen Projekt. Die Version v0.1.0 im im Mai 2025 erschienen. Aktuell ist heute, am 15. Oktober 2026, die Version v0.14.1. Etwa monatlich erscheinen neue Versionen.

LeafWiki verwendet Markdown als Wiki-Markup. Die Markdown-Dateien werden auf der Festplatte gespeichert. Eine Datenbank wird nicht benötigt. Eine Metadaten werden jedoch mit Hilfe von SQLite gespeichert.

== Technische Details ==

Die LeafWiki-Software steht als Binärprogramm ohen weitere Abhängigkeiten zur Verfügung. Das macht die Installation sehr einfach.

== Installation ==

Folgende Schritte sind sinnvoll:

# Einen Domain-Admin-Account in HSAdmin einrichten. Ich verwende 'xyz00-leafwiki' als Beispiel.
# Eine (Sub-)Domain bei diesem Account aufschalten. Beispiel: 'wiki.hs-example.de'
# Das Binärprogramm von Github-Releases herunterladen und in 'leafwiki' umgenennen.
# Eine Environment-Datei mit den Einstellungen für Leafwiki anlegen.
# In der '.htaccess'-Datei der Domain einen Proxy konfigurieren.
# Einen Service für Systemd im Userspace einrichten.

== HSAdmin ==

Über die HSAdmin-Oberfläche wird ein User mit Shell '/bin/bash' angelegt. Im zweiten Schritt wird die gewünschte Domain bei diesem User aufgeschaltet.

== Download ==

Die aktuellen Version finden sich beim Github-Projekt:
https://github.com/perber/leafwiki/releases

Wir benötigen das Binary für Linux mit AMD64-Prozessor, aktuell also 'leafwiki-v0.14.1-linux-amd64'.

Ich nenne das Binary in 'leafwiki' um und lege es im Verzeichnis '~/bin' ab. Das Execute-Recht muss gesetzt werden, z.B.:

chmod u+x ~/leafwiki

== Einstellungen ==

Für die Einstellungen des Leafwiki-Dienstes lege ich eine Datei '~/etc/leafwiki.env' an. Ein Beispielinhalt:

LEAFWIKI_HOST=127.0.0.1
LEAFWIKI_PORT=34567
LEAFWIKI_DATA_DIR="/home/storage/xyz00/users/leafwiki/data"
LEAFWIKI_ADMIN_PASSWORD="change_me_soon"
LEAFWIKI_JWT_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
LEAFWIKI_ENABLE_REVISION=true
LEAFWIKI_LOG_LEVEL=warn
LEAFWIKI_DEFAULT_LANGUAGE=de
LEAFWIKI_SMTP_HOST=127.0.0.1
LEAFWIKI_SMTP_PORT=4025
LEAFWIKI_SMTP_FROM=webmaster@hs-example.de
LEAFWIKI_SMTP_SECURITY=none
LEAFWIKI_PUBLIC_URL=https://wiki.hs-example.de

Ein zufälliges JWT_SECRET lässt sich zum Beipiel wie folgt erzeugen:

LC_ALL=C tr -dc 'A-Za-z0-9' < /dev/urandom | head -c 64; echo

Für die Konfiguration des Apache-Webserver als Proxy wird die Datei '~/doms/wiki.hs-example.com/htdocs-ssl/.htaccess' wie folgt geändert:

DirectoryIndex disabled
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RequestHeader set X-Forwarded-Proto "https"
RewriteRule ^(.*) http://127.0.0.1:34567/$1 [proxy,last]

Einzige Anpassung ist hier der Port '34567'. Der konfigurierte Wert muss auf dem Server frei sein und in beiden Konfigurationsdateien übereinstimmen.

== Systemd Service Konfiguration ==

Als letzte Aktion richten wir den leafwiki-Prozess als Service ein. Dazu legen wir die Unit-Definition in der Datei '~/.config/systemd/user/leafwiki.service' an:

[Unit]
Description=Leafwiki

[Service]
Type=simple
Restart=on-abort
WorkingDirectory=%h
EnvironmentFile=%h/etc/leafwiki.env
ExecStart=%h/bin/leafwiki

[Install]
WantedBy=default.target

== Links ==
*[https://leafwiki.com/ Webseite des LeafWiki Projekt]

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]
[[Kategorie:Wiki]]

Discourse installieren

Tim00 — Thu, 15 Oct 2026 05:26:53 GMT

Am Beispiel von 2026.1.7 auf 2026.7.2

← Nächstältere Version		Version vom 15. Oktober 2026, 05:26 Uhr
Zeile 389:		Zeile 389:
	==== Am Beispiel von 2026.1.7 auf 2026.7.2 ====		==== Am Beispiel von 2026.1.7 auf 2026.7.2 ====

	# Im Web-Backend unter Administration->Backups-> Read-Only ~~Mouds~~ setzen (oder Web Server so konfigurieren, dass keine Zugriffe mehr stattfinden können)		# Im Web-Backend unter Administration->Backups-> Read-Only Modus setzen (oder Web Server so konfigurieren, dass keine Zugriffe mehr stattfinden können)
	# Backup		# Backup
	# Die lokalen Änderungen sichern:		# Die lokalen Änderungen sichern:
Zeile 400:		Zeile 400:
	# patch -p1 < diff-2026.1.7.txt		# patch -p1 < diff-2026.1.7.txt
	# git commit -a -m "spezifische Änderungen für diese Instanz" --no-verify		# git commit -a -m "spezifische Änderungen für diese Instanz" --no-verify
	# Schauen, ob discourse eine neue Ruby-Version nutzt (z.B. in https://github.com/discourse/discourse_docker/blob/main/image/base/Dockerfile bzw. https://github.com/discourse/discourse/blob/v2026.1.7/Gemfile)		# Schauen, ob discourse eine neue Ruby-Version nutzt (z.B. in https://github.com/discourse/discourse_docker/blob/main/image/base/Dockerfile bzw. https://github.com/discourse/discourse/blob/v2026.7.2/Gemfile)
	# Ist dies der Fall, dann:		# Ist dies der Fall, dann:
	# rbenv install 3.4.10		# rbenv install 3.4.10