Hostsharing Wiki - Benutzerbeiträge [de]

DKIM

2021-08-16T17:29:05Z

Has00: /* Domainoption DKIM setzen */ GUI Bezeichnung

= DomainKeys Identified Mail (DKIM) =

DKIM ist ein Verfahren, dass die Authentizität einer E-Mail sicherstellen kann. Dazu wird die E-Mail auf dem sendenden System mit einer elektronischen Signatur in den unsichtbaren Headerzeilen der E-Mail versehen. Es kommt ein asymmetrisches Schlüsselverfahren zum Einsatz. Der sendende Server verwendet seinen privaten Schlüssel, um die Signatur zu erstellen.

Der öffentliche Schlüssel wird im DNS der E-Mail-Domain veröffentlicht, so dass Empfänger die Authentizität der Signatur prüfen können.

{{Textkasten|gelb|Beta|Das Feature ist bei Hostsharing im Beta Test, bitte noch nicht für den produktiven Einsatz nutzen.}}

== DKIM bei Hostsharing ==

Die Nutzer der Hostsharing-Plattform können E-Mails, die sie über die Hostsharing-Server versenden, mit einer DKIM Signatur versehen lassen. Dazu sind zwei Einrichtungsschritte notwendig:

# Die Veröffentlichung des öffentlichen Domainkey im DNS der eigenen E-Mail-Domain.
# Das Setzen der Domain-Option "Domain Key – DKIM" mit Hilfe von HSAdmin.

== Domainkey im DNS ==

Zur Veröffentlichung des Domainkey muss das Zonefile der E-Mail-Domain erweitert werden. Dazu muss in einem individuell angepassten Zonefile die Zeile

{DKIM_RR}

ergänzt werden.

Diese Zeile ist in der Beta-Phase nicht Bestandteil des Default-Zonefile! Domain-Inhaber, die ihr Zonefile bisher nicht angepasst haben, müssen also ein minimales Zonefile der Form

{DEFAULT_ZONEFILE}
{DKIM_RR}

erstellen.

Nach einer erfolgreichen Veröffentlichung des Domainkey liefert der Befehl

$ dig -t TXT +short default._domainkey.hs-example.de

("hs-example.de" durch die eigene Domain ersetzen) einen Schlüssel in der Form:

v=DKIM1; h=sha256; k=rsa; s=email; " "p=MIIBIjAN [...]"

== Domainoption DKIM setzen ==

Über die Domainoption "Domain Key – DKIM" wird gesteuert, dass der SMTP-Server, auf dem der Webspace mit der Domain liegt, die ausgehenden E-Mail mit einer DKIM-Signatur ausstattet.

In der Beta-Phase ist das Setzen dieser Option nur über das Kommandozeilentool "hsscript" möglich. Mit "hsscript" müssen beim Update einer Domain jeweils alle Domainoptionen, die gesetzt sein sollen, angegeben werden!

Im Folgenden werden deshalb zunächst die Domainoptionen gelesen und anschließend mit der zusätzlichen Option "dkim" wieder geschrieben:

$ hsscript -u xyz00 -i
Password: *********
xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})
[
{
domainoptions:[
'htdocsfallback',
'indexes',
'autoconfig',
'greylisting',
'includes',
'letsencrypt',
'multiviews'
],
hive:'h97',
id:'22767',
name:'hs-example.de',
pac:'xyz00',
since:'12.02.21',
user:'xyz00-doms',
validsubdomainnames:'www'
}
]
xyz00@hsadmin> domain.update({where:{name:'hs-example.de'},set:{domainoptions:[ 'htdocsfallback', 'indexes', 'autoconfig', 'greylisting', 'includes', 'letsencrypt', 'multiviews', 'dkim' ]}})
[
{
domainoptions:[
'htdocsfallback',
'indexes',
'dkim',
'autoconfig',
'greylisting',
'includes',
'letsencrypt',
'multiviews'
],
hive:'h97',
id:'22767',
name:'hs-example.de',
pac:'xyz00',
since:'12.02.21',
user:'xyz00-doms',
validsubdomainnames:'www'
}
]
xyz00@hsadmin> exit

== Beta Test ==

Mitglieder, die mit "hsscript" und Zonefile umgehen können, sind herzlich eingeladen am Test teilzunehmen. Das Wiederentfernen der DKIM-Option kann jedoch zu Schwierigkeiten bei der Zustellung ausgehender Mails führen. Das Abstellen in folgender Reihenfolge wird funktionieren:

# Die Domainoption deaktivieren
# Abwarten bis alle mit der Option (und damit mit einer Signatur) versendeten E-Mail zugestellt sind
# Den Domainkey im DNS entfernen

== Links ==

* [https://de.wikipedia.org/wiki/DomainKeys DKIM Artikel der Wikipedia]
* [https://doc.hostsharing.net/referenz/zonefile/ Hostsharing-Dokumentation zur Anpassung des Zonefile]
* [https://doc.hostsharing.net/referenz/domain/domain-optionen.html Hostsharing-Dokumentation Domain-Optionen]

DKIM

2021-08-16T17:28:32Z

Has00: /* DKIM bei Hostsharing */ Bezeichnung vom GUI in HSADmin

= DomainKeys Identified Mail (DKIM) =

DKIM ist ein Verfahren, dass die Authentizität einer E-Mail sicherstellen kann. Dazu wird die E-Mail auf dem sendenden System mit einer elektronischen Signatur in den unsichtbaren Headerzeilen der E-Mail versehen. Es kommt ein asymmetrisches Schlüsselverfahren zum Einsatz. Der sendende Server verwendet seinen privaten Schlüssel, um die Signatur zu erstellen.

Der öffentliche Schlüssel wird im DNS der E-Mail-Domain veröffentlicht, so dass Empfänger die Authentizität der Signatur prüfen können.

{{Textkasten|gelb|Beta|Das Feature ist bei Hostsharing im Beta Test, bitte noch nicht für den produktiven Einsatz nutzen.}}

== DKIM bei Hostsharing ==

Die Nutzer der Hostsharing-Plattform können E-Mails, die sie über die Hostsharing-Server versenden, mit einer DKIM Signatur versehen lassen. Dazu sind zwei Einrichtungsschritte notwendig:

# Die Veröffentlichung des öffentlichen Domainkey im DNS der eigenen E-Mail-Domain.
# Das Setzen der Domain-Option "Domain Key – DKIM" mit Hilfe von HSAdmin.

== Domainkey im DNS ==

Zur Veröffentlichung des Domainkey muss das Zonefile der E-Mail-Domain erweitert werden. Dazu muss in einem individuell angepassten Zonefile die Zeile

{DKIM_RR}

ergänzt werden.

Diese Zeile ist in der Beta-Phase nicht Bestandteil des Default-Zonefile! Domain-Inhaber, die ihr Zonefile bisher nicht angepasst haben, müssen also ein minimales Zonefile der Form

{DEFAULT_ZONEFILE}
{DKIM_RR}

erstellen.

Nach einer erfolgreichen Veröffentlichung des Domainkey liefert der Befehl

$ dig -t TXT +short default._domainkey.hs-example.de

("hs-example.de" durch die eigene Domain ersetzen) einen Schlüssel in der Form:

v=DKIM1; h=sha256; k=rsa; s=email; " "p=MIIBIjAN [...]"

== Domainoption DKIM setzen ==

Über die Domainoption "DKIM" wird gesteuert, dass der SMTP-Server, auf dem der Webspace mit der Domain liegt, die ausgehenden E-Mail mit einer DKIM-Signatur ausstattet.

In der Beta-Phase ist das Setzen dieser Option nur über das Kommandozeilentool "hsscript" möglich. Mit "hsscript" müssen beim Update einer Domain jeweils alle Domainoptionen, die gesetzt sein sollen, angegeben werden!

Im Folgenden werden deshalb zunächst die Domainoptionen gelesen und anschließend mit der zusätzlichen Option "dkim" wieder geschrieben:

$ hsscript -u xyz00 -i
Password: *********
xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})
[
{
domainoptions:[
'htdocsfallback',
'indexes',
'autoconfig',
'greylisting',
'includes',
'letsencrypt',
'multiviews'
],
hive:'h97',
id:'22767',
name:'hs-example.de',
pac:'xyz00',
since:'12.02.21',
user:'xyz00-doms',
validsubdomainnames:'www'
}
]
xyz00@hsadmin> domain.update({where:{name:'hs-example.de'},set:{domainoptions:[ 'htdocsfallback', 'indexes', 'autoconfig', 'greylisting', 'includes', 'letsencrypt', 'multiviews', 'dkim' ]}})
[
{
domainoptions:[
'htdocsfallback',
'indexes',
'dkim',
'autoconfig',
'greylisting',
'includes',
'letsencrypt',
'multiviews'
],
hive:'h97',
id:'22767',
name:'hs-example.de',
pac:'xyz00',
since:'12.02.21',
user:'xyz00-doms',
validsubdomainnames:'www'
}
]
xyz00@hsadmin> exit

== Beta Test ==

Mitglieder, die mit "hsscript" und Zonefile umgehen können, sind herzlich eingeladen am Test teilzunehmen. Das Wiederentfernen der DKIM-Option kann jedoch zu Schwierigkeiten bei der Zustellung ausgehender Mails führen. Das Abstellen in folgender Reihenfolge wird funktionieren:

# Die Domainoption deaktivieren
# Abwarten bis alle mit der Option (und damit mit einer Signatur) versendeten E-Mail zugestellt sind
# Den Domainkey im DNS entfernen

== Links ==

* [https://de.wikipedia.org/wiki/DomainKeys DKIM Artikel der Wikipedia]
* [https://doc.hostsharing.net/referenz/zonefile/ Hostsharing-Dokumentation zur Anpassung des Zonefile]
* [https://doc.hostsharing.net/referenz/domain/domain-optionen.html Hostsharing-Dokumentation Domain-Optionen]

DKIM

2021-08-16T17:27:21Z

Has00: /* DomainKeys Identified Mail (DKIM) */ typo

= DomainKeys Identified Mail (DKIM) =

DKIM ist ein Verfahren, dass die Authentizität einer E-Mail sicherstellen kann. Dazu wird die E-Mail auf dem sendenden System mit einer elektronischen Signatur in den unsichtbaren Headerzeilen der E-Mail versehen. Es kommt ein asymmetrisches Schlüsselverfahren zum Einsatz. Der sendende Server verwendet seinen privaten Schlüssel, um die Signatur zu erstellen.

Der öffentliche Schlüssel wird im DNS der E-Mail-Domain veröffentlicht, so dass Empfänger die Authentizität der Signatur prüfen können.

{{Textkasten|gelb|Beta|Das Feature ist bei Hostsharing im Beta Test, bitte noch nicht für den produktiven Einsatz nutzen.}}

== DKIM bei Hostsharing ==

Die Nutzer der Hostsharing-Plattform können E-Mails, die sie über die Hostsharing-Server versenden, mit einer DKIM Signatur versehen lassen. Dazu sind zwei Einrichtungsschritte notwendig:

# Die Veröffentlichung des öffentlichen Domainkey im DNS der eigenen E-Mail-Domain.
# Das Setzen der Domain-Option "DKIM" mit Hilfe von HSAdmin.

== Domainkey im DNS ==

Zur Veröffentlichung des Domainkey muss das Zonefile der E-Mail-Domain erweitert werden. Dazu muss in einem individuell angepassten Zonefile die Zeile

{DKIM_RR}

ergänzt werden.

Diese Zeile ist in der Beta-Phase nicht Bestandteil des Default-Zonefile! Domain-Inhaber, die ihr Zonefile bisher nicht angepasst haben, müssen also ein minimales Zonefile der Form

{DEFAULT_ZONEFILE}
{DKIM_RR}

erstellen.

Nach einer erfolgreichen Veröffentlichung des Domainkey liefert der Befehl

$ dig -t TXT +short default._domainkey.hs-example.de

("hs-example.de" durch die eigene Domain ersetzen) einen Schlüssel in der Form:

v=DKIM1; h=sha256; k=rsa; s=email; " "p=MIIBIjAN [...]"

== Domainoption DKIM setzen ==

Über die Domainoption "DKIM" wird gesteuert, dass der SMTP-Server, auf dem der Webspace mit der Domain liegt, die ausgehenden E-Mail mit einer DKIM-Signatur ausstattet.

In der Beta-Phase ist das Setzen dieser Option nur über das Kommandozeilentool "hsscript" möglich. Mit "hsscript" müssen beim Update einer Domain jeweils alle Domainoptionen, die gesetzt sein sollen, angegeben werden!

Im Folgenden werden deshalb zunächst die Domainoptionen gelesen und anschließend mit der zusätzlichen Option "dkim" wieder geschrieben:

$ hsscript -u xyz00 -i
Password: *********
xyz00@hsadmin> domain.search({where:{name:'hs-example.de'}})
[
{
domainoptions:[
'htdocsfallback',
'indexes',
'autoconfig',
'greylisting',
'includes',
'letsencrypt',
'multiviews'
],
hive:'h97',
id:'22767',
name:'hs-example.de',
pac:'xyz00',
since:'12.02.21',
user:'xyz00-doms',
validsubdomainnames:'www'
}
]
xyz00@hsadmin> domain.update({where:{name:'hs-example.de'},set:{domainoptions:[ 'htdocsfallback', 'indexes', 'autoconfig', 'greylisting', 'includes', 'letsencrypt', 'multiviews', 'dkim' ]}})
[
{
domainoptions:[
'htdocsfallback',
'indexes',
'dkim',
'autoconfig',
'greylisting',
'includes',
'letsencrypt',
'multiviews'
],
hive:'h97',
id:'22767',
name:'hs-example.de',
pac:'xyz00',
since:'12.02.21',
user:'xyz00-doms',
validsubdomainnames:'www'
}
]
xyz00@hsadmin> exit

== Beta Test ==

Mitglieder, die mit "hsscript" und Zonefile umgehen können, sind herzlich eingeladen am Test teilzunehmen. Das Wiederentfernen der DKIM-Option kann jedoch zu Schwierigkeiten bei der Zustellung ausgehender Mails führen. Das Abstellen in folgender Reihenfolge wird funktionieren:

# Die Domainoption deaktivieren
# Abwarten bis alle mit der Option (und damit mit einer Signatur) versendeten E-Mail zugestellt sind
# Den Domainkey im DNS entfernen

== Links ==

* [https://de.wikipedia.org/wiki/DomainKeys DKIM Artikel der Wikipedia]
* [https://doc.hostsharing.net/referenz/zonefile/ Hostsharing-Dokumentation zur Anpassung des Zonefile]
* [https://doc.hostsharing.net/referenz/domain/domain-optionen.html Hostsharing-Dokumentation Domain-Optionen]

HDD Storage

2021-08-14T13:19:33Z

Has00: /* HDD Storage */ typos

= HDD Storage =

Hostsharing bietet ab 1. September 2021 Festplattenspeicher auf klassischen, magnetischen HDD für größere Datenvolumina an. Der zusätzliche Speicher steht im Managed Hosting als zweite Partition unter dem Mountpoint

/home/storage

zur Verfügung.

Wenn für ein Paket (Beispiel ''xyz00'') eine Storage-Quota gebucht ist, wird
unter diesem Mountpoint ein Verzeichnis ''/home/storage/xyz00'' angelegt. Darin werden auch Unterverzeichnisse für jeden User im Webspace ''xyz00'' angelegt, zum Beispiel
''/home/storage/xyz00/users/brunobeispiel''.

In diesen Verzeichnissen hat der jeweilige User die Berechtigung Dateien anzulegen, zu lesen und zu löschen. Weiterhin kann der Systemuser ''httpd'' auf die Dateien lesend zugreifen, so dass sich einzelne Verzeichnisse in das htdocs-Verzeichnis von Domains verlinken lassen. Auf diesem Weg können größere Dateien zum Download angeboten werden.

Nutzerinnen und Nutzer, die selbständig die Zugriffrechte im Unix-Dateisystem sinnvoll und sicher vergeben können, dürfen unter ''/home/storage/xyz00'' gern eigene Verzeichnisstrukturen organiseren. Der Paketadmin ''xyz00'' hat die notwendigen Rechte dazu.

== Dateizugriffsrechte ==

Die Rechteschleuse für den User ''httpd'' ist wie folgt realisiert:

drwxr-x--x 3 xyz00 httpd 19 Aug 13 14:47 /home/storage/xyz00/
drwxr-xr-x 10 xyz00 xyz00 106 Aug 13 14:47 /home/storage/xyz00/users
drwxr-x--- 2 xyz00-brunobeispiel httpd 6 Aug 13 14:47 /home/storage/xyz00/users/brunobeispiel

Passworte

2021-02-28T14:02:37Z

Has00: /* Weiterführende Links */ www.passwordstore.org und Links gefixt

Passworte sind von hoher Relevanz für die Sicherheit der eigenen Pakete und sollten daher gut gewählt werden.

== Pro Account ein eigenes Passwort ==

Erste Regel bei Passwörtern: jeder Account hat sein eigenes. Der Grund ist einfach: wird ein einzelner Account gehackt, sind nicht alle anderen gefährdet.

== Wahl eines sicheren Passwortes ==

Ein sichers Passwort besteht aus mindestens 8 Zeichen, möglichst einer Mischung aus Groß- und Kleinbuchstaben, Ziffern und Sonderzeichen und kann nicht in einem Wörterbuch gefunden werden. Es gibt übrigens spezielle Wörterbücher zum Passwortknacken und da sind auch Zeichenfolgen wie "sabine1982" enthalten.

Ein sehr sicheres Passwort ist zum Beispiel "KFxE75LOCUvlcnRMYmcs".

Nur wie kann man sich so etwas merken?

== Passwortverwaltung ==

Es gibt Programme zum Verwalten von Passwortdatenbanken für die verschiedenen Betriebssysteme, die eine Vielzahl von sicheren Passwörtern generieren und verschlüsselt speichern können. Damit wird das Verwalten leicht gemacht. Nur noch das Masterpasswort zum Öffnen der Datenbank muss gemerkt werden.

== Weiterführende Links ==

[https://www.bsi.bund.de/DE/Themen/Verbraucherinnen-und-Verbraucher/Informationen-und-Empfehlungen/Cyber-Sicherheitsempfehlungen/Accountschutz/Sichere-Passwoerter-erstellen/sichere-passwoerter-erstellen_node.html BSI Empfehlungen zur Erstellung sicherer Passwörter]

https://de.wikipedia.org/wiki/KeePass

[https://keepass.info/download.html Download KeePass]

[https://de.wikipedia.org/wiki/KeePass Was ist KeePass?]

[https://formulae.brew.sh/cask/keepassxc#default KeepassXC für Mac OS – via Homebrew]

[https://brew.sh/index_de Was ist "Homebrew"?]

[https://www.passwordstore.org Für die Kommandozeile: pass the standard unix password manager]
----
[[Kategorie:HSDoku]]
[[Kategorie:Glossar]]

Nextcloud

2021-02-10T18:38:38Z

Has00: /* Nextcloud konfigurieren */ Hinweis auf verstecktes Formular auf dem Startscreen

= Nextcloud =

[https://nextcloud.com/ Nextcloud] ist eine PHP-basierte Open Source Lösung für gängige Cloud-Anwendungen, u.a.:

* Filesharing unter Nutzern derselben Nextcloud, und mit der Öffentlichkeit
* Single-Sign-On Authentifizierung (SSO)
* Videokonferenzen (WebRTC)
* Online-Office Anwendung [https://www.collaboraoffice.com/ Collabora Online]

Beispiel-Funktionalität, die über Plugins, sogenannte [https://apps.nextcloud.com/ "Apps"], bereit gestellt werden kann:

* Kalender, Aufgabenverwaltung, Adressbuch
* Datei-Kollaboration (Kommentare zu Dateien, Verschlagwortung)
* Feedreader
* E-Mail-Programm
* Fotogalerie
* Musik- und Videowiedergabe

= Nextcloud installieren =

== Vorbereitungen ==

In ''hsadmin'', zum Beispiel mit ''hsscript'':

''hsadmin''-Shell starten mit:

hsscript -u xyz00 -i
Password: ********

Dann nacheinander anlegen:

* Linux User als Domain-Administrator
* Subdomain ''cloud.example.org''
* PostgreSQL-User
* PostgreSQL Datenbank

xyz00@hsadmin> user.add({set:{name:'xyz00-cloud',password:'geheim',shell:'/bin/bash',comment:'Nextcloud'}})
xyz00@hsadmin> domain.add({set:{name:'cloud.example.org',user:'xyz00-cloud'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_nextclusr',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_nextcloud',owner:'xyz00_nextclusr'}})

== Nextcloud installieren ==

Anmelden als Linux-User ''xyz00-cloud'':

ssh -l xyz00-cloud xyz00.hostsharing.net

''htdocs'' Verzeichnis vorbereiten

cd
mkdir nextcloud
cd doms/cloud.example.org
rm -rf subs/www subs-ssl/www htdocs-ssl
ln -s $HOME/nextcloud htdocs-ssl

Nextcloud herunterladen und entpacken.

cd
wget https://download.nextcloud.com/server/releases/nextcloud-20.0.4.zip
unzip nextcloud-20.0.4.zip
rm nextcloud-20.0.4.zip
mkdir data tmp
chmod 700 data tmp

== Nextcloud konfigurieren ==

Im Verzeichnis "$HOME/doms/cloud.example.org/fastcgi-ssl/" eine Datei "php.ini" anlegen mit folgendem Inhalt:

memory_limit=512M
session.save_path=/home/pacs/xyz00/users/cloud/tmp

Dann mit einem Editor diese Datei bearbeiten: In der erste Zeile den korrekten Pfad des vorher angelegten tmp-Verzeichnisses eintragen.

Im Browser auf die Seite
http://cloud.example.org gehen und den Anweisungen folgen.

Auf der ersten Seite sind anzugeben:

* Login und Passwort für den Administrator definieren
* PostgreSQL als Datenbanksystem
* PostgreSQL-User und Passwort aus dem ersten Schritt oben
* Name der PostgreSQL-Datenbank aus dem ersten Schritt
* "localhost" als Datenbankserver
* Das Verzeichnis "/home/pacs/xyz00/users/cloud/data/" als Daten-Verzeichnis

'''Achtung!''' Die Felder für die Datenbank sind auf dem Startscreen hinter einem unscheinbaren Link versteckt. Um man das Formular für die Datenbank-Daten zu gelangen, muss man auf den Link klicken. Anschließend kann man die gewünschte Datenbank auswählen und die entsprechenden Daten eintragen. '''Das sollte geschehen, bevor man die Installation abschließt!''' Tut man dies nicht, wird Nextcloud mit SQLite installiert. Eine Änderung der Datenbank soll zwar laut Dokumentation auch später noch möglich sein, ging aber bei einem Test schief.

== Nextcloud beschleunigen ==

Dieser Teil ist optional.

Wenn regelmäßig '''im Browser''' mit Nextcloud gearbeitet werden soll, ist Nextcloud im Browser oft sehr langsam. Um dies zu verbessern unterstützt Nextcloud die Anwendung von unterschiedlichen Cache-Verfahren (zum Beispiel Memcache, Redis).

Redis ist auf den Hostsharing-Servern vorinstalliert und wird von den Nextcloud-Entwicklern empfohlen. '''In Verbindung mit einem Managed Webspace''' muss Redis als eigener Server '''Daemon''' angemeldet werden und ist '''kostenpflichtig'''. Siehe zu Kosten im Webspace Konfigurator unter: https://www.hostsharing.net/angebote/managed-webspace/ – '''1 individueller Serverdienst''' (Daemons).

Mit dem Hostsharing-Service wird ein IP-Port für die Nutzung von Redis vereinbart.

Für den Redis-Dienst lege ich folgende Struktur an:

cd ~
mkdir -p ~/redis/etc
mkdir -p ~/redis/var

In ''~/redis/etc'' lege ich eine Konfigurationsdatei ''redis.conf'' für den Redis-Dienst ab:

daemonize yes
pidfile /home/pacs/xyz00/users/cloud/redis/var/redis-server.pid
requirepass mein-redis-passwort
port 32123
tcp-backlog 128
bind 127.0.0.1
timeout 300
loglevel notice
logfile /home/pacs/xyz00/users/cloud/redis/var/redis.log
databases 16
save 900 1
save 300 10
save 60 10000
slave-serve-stale-data yes
appendonly no
dbfilename dump.rdb
dir /home/pacs/xyz00/users/cloud/redis/var

Den Start und das Monitoring des Redis-Dienstes übernimmet ''monit''. Hier eine geeignete Datei ''~/.monitrc'':

set daemon 60
with start delay 120
set logfile /home/pacs/xyz00/users/cloud/monit/var/monit.log
set idfile /home/pacs/xyz00/users/cloud/monit/var/monit.id
set statefile /home/pacs/xyz00/users/cloud/monit/var/monit.state
set mailserver localhost
set mail-format { from: monit@cloud.example.com }
set alert webmaster@example.com
set httpd port 32123 address xyz00.hostsharing.net
allow nextcloud:mein-monit-passwort
check process redis with pidfile /home/pacs/xyz00/users/cloud/redis/var/redis-server.pid
start program "/usr/bin/redis-server /home/pacs/xyz00/users/cloud/redis/etc/redis.conf"
stop program "/bin/bash -c '/bin/kill $( cat /home/pacs/xyz00/users/cloud/redis/var/redis-server.pid )'"

Zugriffsrechte für die Datei ''~/.monitrc'' setzen:

cd ~
chmod 600 .monitrc

Verzeichnis für ''monit'' anlgegen:

cd ~
mkdir -p monit/var

In der Konfiguration der Nextcloud (in ''~/nextcloud/config/config.php'') wird der Redis-Cache wie folgt konfiguriert:

'memcache.local' => '\\OC\\Memcache\\Redis',
'memcache.distributed' => '\\OC\\Memcache\\Redis',
'memcache.locking' => '\\OC\\Memcache\\Redis',
'redis' =>
array (
'host' => '127.0.0.1',
'port' => 32123,
'password' => 'mein-redis-passwort',
'timeout' => 1.5,
),

Um es perfekt zu machen nutze ich ''logrotate'' um die Logdateien zu organisieren. Dazu die Konfiguration in ''~/.logrotate''

compress
/home/pacs/xyz00/users/cloud/redis/var/redis.log {
rotate 5
daily
missingok
}
/home/pacs/xyz00/users/cloud/monit/var/monit.log {
rotate 2
weekly
missingok
}

Eine Crontab sorgt für den Start von Monit und das tägliche Rotieren der Logdateien:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/cloud
PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
MAILTO=webmaster@example.com
@reboot /usr/bin/monit -c $HOME/.monitrc
1 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate
1,16,31,46 * * * * /usr/bin/php7.3 $HOME/nextcloud/cron.php

Die letzte Zeile der ''crontab'' enthält den Cronjob für die regelmäßigen Hintergrundprozesse der Nextcloud. Durch die Erledigung dieser Aufgaben mit Cron lässt sich die Nextcloud ebenfalls etwas beschleunigen.

== Nextcloud mit Online Office ==

In Nextcloud können Office-Dokumente (Textverarbeitung, Tabellen und Präsentationen) im Browser bearbeitet werden. Dazu steht bei Hostsharing die Collabora Developer Version zur Verfügung. Bestellung und Konfiguration sind hier im Wiki auf der Seite [[Collabora_Online]] beschrieben.

== Nextcloud mit Nextcloud Talk ==

Über die Nextcloud-App "Talk" können Videokonfererenzen mit Screensharing durchgeführt werden. Für die regelmäßige Nutzung kann es sinnvoll sein einen eigenen TURN Server zu betreiben. Siehe dazu [[Coturn_Installieren]]

= weiterführende Links =

* [https://ownyourbits.com/2019/06/29/understanding-and-improving-nextcloud-previews/ Optimierung des Caches für Previews]

= Updater über die Shell starten =

Wenn die NextCloud sich nicht über das Webfrontend updaten lässt, kann der Updater auch per Shell im directory /updater durch ausführen des updater.phar gestartet werden:

xyz00-cloud@h00:~/nextcloud/updater$ chmod u+x updater.phar
xyz00-cloud@h00:~/nextcloud/updater$ ./updater.phar

Für weitere Informationen kann auf die offizielle Doku ab Ziffer 2. zurückgegriffen werden.

* [https://docs.nextcloud.com/server/latest/admin_manual/maintenance/update.html#using-the-command-line-based-updater]

Wartungsmodus per Shell (über die config.php) ein- oder ausschalten:

Im nextcloud-Ordner die Datei config / config.php mit dem bevorzugten Shell-Editor (z. B. vim) öffnen.
Suche nach 'maintenance' => true,
Ändern von true in false
Speichern
Webseite neu laden

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

Diskussion:HedgeDoc installieren

2021-01-23T15:29:48Z

Has00:

Evtl. sollte man für den Datenbankbenutzer und die Datenbank zwei unterschiedliche Namen vorsehen. [[Benutzer:Has00|Has00]] ([[Benutzer Diskussion:Has00|Diskussion]]) 14:24, 23. Jan. 2021 (CET)

Ich habe mit dieser Anleitung versucht HedgeDoc zu installieren.

$ npm version
{ HedgeDoc: '1.7.2',
npm: '6.14.10',
ares: '1.15.0',
brotli: '1.0.7',
cldr: '35.1',
http_parser: '2.9.4',
icu: '64.2',
modules: '64',
napi: '7',
nghttp2: '1.41.0',
node: '10.23.1',
openssl: '1.1.1i',
tz: '2019c',
unicode: '12.1',
uv: '1.34.2',
v8: '6.8.275.32-node.59',
zlib: '1.2.11' }

npm start --production

lässt die Anwendung starten. Wegen SSL Zertifikatsproblem kann ich aber unter example.com:3000 nichts sehen.

Passenger angepasst wie in der Anleitung beschrieben.

Unter der richtigen URL kriege ich aber:

Internal Server Error

Ein Update auf NodeJS 14.15.4 bringt auch nichts anderes:

$ npm version
{
HedgeDoc: '1.7.2',
npm: '6.14.10',
ares: '1.16.1',
brotli: '1.0.9',
cldr: '37.0',
icu: '67.1',
llhttp: '2.1.3',
modules: '83',
napi: '7',
nghttp2: '1.41.0',
node: '14.15.4',
openssl: '1.1.1i',
tz: '2020a',
unicode: '13.0',
uv: '1.40.0',
v8: '8.4.371.19-node.17',
zlib: '1.2.11'
}

Diskussion:HedgeDoc installieren

2021-01-23T13:32:11Z

Has00:

Diskussion:HedgeDoc installieren

2021-01-23T13:24:46Z

Has00: Die Seite wurde neu angelegt: „Evtl. sollte man für den Datenbankbenutzer und die Datenbank zwei unterschiedliche Namen vorsehen. ~~~~“

Evtl. sollte man für den Datenbankbenutzer und die Datenbank zwei unterschiedliche Namen vorsehen. [[Benutzer:Has00|Has00]] ([[Benutzer Diskussion:Has00|Diskussion]]) 14:24, 23. Jan. 2021 (CET)

Coturn Installieren

2021-01-17T11:45:22Z

Has00: /* Spezielle Installation bei Hostsharing */ Link zu Features hs.net

Coturn STUN- und TURN-Server installieren

== Allgemein ==

[https://github.com/coturn/coturn Coturn] ist ein STUN- und TURN-Server, der die Steuerung von VoIP-, Video- und Audio-Verbindungen unterstützt.

== Spezielle Installation bei Hostsharing ==

In jedem dynamischen [https://www.hostsharing.net/features/coturn/ Webhosting-Paket der Hostsharing eG] kann ein Coturn-Server betrieben werden.

Dazu muss für jede Coturn-Instanz die Option "Betrieb eines eigenen Serverdienstes" gebucht werden. Im Bereich des Shared Hosting ist die Option kostenpflichtig.

Diese Anleitung dokumentiert die Installation des Coturn-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 Coturn-Server) auf der paketeigenen IP-Adresse gebunden.

Geben Sie bei der Bestellung der Option "Eigener Serverdienst" an:

# den Service User, mit dessen Rechten der Coturn-Dienst laufen soll (also zum Beispiel "xyz00-coturn")

== Installation ==

Coturn ist bereits vorinstalliert. Die STUN-Funktion wenigstens zwei IP-Adressen benötigt, darf als zweite IP-Adresse in diesem Szenario IP-Adresse des Hives bzw. der VM verwendet werden.

<pre>
listening-ip=<IP-Adresse-des-Pakets>
listening-ip=<IP-Adresse-des-Hives/der-VM>
relay-ip=<IP-Adresse-des-Pakets>
listening-port=<zugewiesener-Port>
fingerprint
lt-cred-mech
use-auth-secret
static-auth-secret=<shared-secret>
realm=<xyz00.hostsharing.net>
total-quota=100
bps-capacity=0
stale-nonce
no-loopback-peers
no-multicast-peers
log-file=<pfad>/turnserver.log
pidfile=<pfad>/turnserver.pid
userdb=<pfad>/turnserver.db
no-tls
</pre>

Start mit turnserver -c <pfad>/turnserver.conf

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

Gitea

2019-01-30T13:42:50Z

Has00: /* Start- und Stopp-Skripte einrichten */ Code-Auszeichnung

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel <code>xyz00-gitea</code>.

2. Anlegen einer Domain. In unserem Beispiel <code>gitea.hs-example.de</code>.

3. Anlegen eines Datenbank-Benutzers. Hier <code>xyz00_giteadbuser</code>.

4. Anlegen einer Datenbank. Hier <code>xyz00_giteadb</code>.

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl <code>hsscript</code>:

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',shell:'/bin/bash'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary (hier die 64-Bit-Version,
für die shared Server h01 bis h08 bitte die 32-Bit-Version gitea-1.7.0-linux-i386 herunterladen).

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis <code>doms/gitea.hs-example.de</code> und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei <code>htdocs-ssl/.htaccess</code> mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea <code>app.ini</code>.
Sie befindet sich in dem Verzeichnis <code>~/custom/conf</code>.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = geheim
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad <code>~/bin/gitea-start.sh</code> ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad <code>~/bin/gitea-stopp.sh</code> an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei <code>~/.monitrc</code> mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei <code>~/.logrotate</code>:

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T13:40:17Z

Has00: /* Konfiguration von Gitea */ Code-Auszeichnung

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel <code>xyz00-gitea</code>.

2. Anlegen einer Domain. In unserem Beispiel <code>gitea.hs-example.de</code>.

3. Anlegen eines Datenbank-Benutzers. Hier <code>xyz00_giteadbuser</code>.

4. Anlegen einer Datenbank. Hier <code>xyz00_giteadb</code>.

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl <code>hsscript</code>:

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',shell:'/bin/bash'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary (hier die 64-Bit-Version,
für die shared Server h01 bis h08 bitte die 32-Bit-Version gitea-1.7.0-linux-i386 herunterladen).

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis <code>doms/gitea.hs-example.de</code> und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei <code>htdocs-ssl/.htaccess</code> mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea <code>app.ini</code>.
Sie befindet sich in dem Verzeichnis <code>~/custom/conf</code>.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = geheim
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad ~/bin/gitea-start.sh ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad ~/bin/gitea-stopp.sh an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T13:39:16Z

Has00: /* Konfiguration der Domain */ Code-Auszeichnung

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel <code>xyz00-gitea</code>.

2. Anlegen einer Domain. In unserem Beispiel <code>gitea.hs-example.de</code>.

3. Anlegen eines Datenbank-Benutzers. Hier <code>xyz00_giteadbuser</code>.

4. Anlegen einer Datenbank. Hier <code>xyz00_giteadb</code>.

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl <code>hsscript</code>:

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',shell:'/bin/bash'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary (hier die 64-Bit-Version,
für die shared Server h01 bis h08 bitte die 32-Bit-Version gitea-1.7.0-linux-i386 herunterladen).

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis <code>doms/gitea.hs-example.de</code> und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei <code>htdocs-ssl/.htaccess</code> mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = geheim
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad ~/bin/gitea-start.sh ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad ~/bin/gitea-stopp.sh an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T13:37:42Z

Has00: /* Vorbereitung der Installation */ Code-Auszeichnung

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel <code>xyz00-gitea</code>.

2. Anlegen einer Domain. In unserem Beispiel <code>gitea.hs-example.de</code>.

3. Anlegen eines Datenbank-Benutzers. Hier <code>xyz00_giteadbuser</code>.

4. Anlegen einer Datenbank. Hier <code>xyz00_giteadb</code>.

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl <code>hsscript</code>:

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary (hier die 64-Bit-Version,
für die shared Server h01 bis h08 bitte die 32-Bit-Version gitea-1.7.0-linux-i386 herunterladen).

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = geheim
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad ~/bin/gitea-start.sh ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad ~/bin/gitea-stopp.sh an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T13:01:51Z

Has00: /* Konfiguration von Gitea */

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = geheim
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad ~/bin/gitea-start.sh ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad ~/bin/gitea-stopp.sh an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:45:44Z

Has00: /* Start- und Stopp-Skripte einrichten */

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = [Passwort des Datenbankbenutzers]
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad ~/bin/gitea-start.sh ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad ~/bin/gitea-stopp.sh an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:43:57Z

Has00: /* Konfiguration von Gitea */

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = [Passwort des Datenbankbenutzers]
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Der Git-Service ist dann im Browser unter der Adresse gitea.hs-example.de erreichbar.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad '~/bin/gitea-start.sh' ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad '~/bin/gitea-stopp.sh' an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:43:15Z

Has00: /* Konfiguration von Gitea */

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = [Passwort des Datenbankbenutzers]
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Und den Git-Service im Browser unter der Adresse gitea.hs-example.de öffnen.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad '~/bin/gitea-start.sh' ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad '~/bin/gitea-stopp.sh' an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:41:43Z

Has00: /* Konfiguration von Gitea */

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = ******
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Und den Git-Service im Browser unter der Adresse gitea.hs-example.de öffnen.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad '~/bin/gitea-start.sh' ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad '~/bin/gitea-stopp.sh' an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:41:15Z

Has00: /* Konfiguration von Gitea */

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Konfigurationsdatei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = giteahs
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Und den Git-Service im Browser unter der Adresse gitea.hs-example.de öffnen.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad '~/bin/gitea-start.sh' ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad '~/bin/gitea-stopp.sh' an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:40:36Z

Has00:

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

=== Konfiguration von Gitea ===

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

'''ACHTUNG''': Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Datei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = giteahs
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Und den Git-Service im Browser unter der Adresse gitea.hs-example.de öffnen.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad '~/bin/gitea-start.sh' ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad '~/bin/gitea-stopp.sh' an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:37:11Z

Has00: /* Vorbereitung der Installation */

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-User'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration von Gitea und der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

ACHTUNG: Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Datei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = giteahs
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Und den Git-Service im Browser unter der Adresse gitea.hs-example.de öffnen.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad '~/bin/gitea-start.sh' ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad '~/bin/gitea-stopp.sh' an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Gitea

2019-01-30T12:36:12Z

Has00: Erster Entwurf

== Gitea installieren ==

[https://gitea.io/en-us/ Gitea] ist ein einfacher, selbst gehosteter Git-Service wie GitHub oder GitLab. Die Software ist ein Fork von Gogs und ebenfalls in der Programmiersprache Go geschrieben. Gitea benötigt wenig Ressourcen. Um Gitea auf der Hostsharing Plattform nutzen zu können, benötigt man entweder einen Managed Server oder man muss für seinen Managed Webspace einen Daemon hinzubuchen.

Gitea unterstützt verschiedene Datenbanken. Wir gehen in dieser Anleitung davon aus, dass PostgreSQL benutzt wird.

=== Vorbereitung der Installation ===

Um Gitea auf der Managed Operation Platform von Hostsharing zu installieren, ist folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers. In unserem Beispiel xyz00-gitea.

2. Anlegen einer Domain. In unserem Beispiel gitea.hs-example.de

3. Anlegen eines Datenbank-Benutzers. Hier xyz00_giteadbuser.

4. Anlegen einer Datenbank. Hier xyz00_giteadb

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet die Kommandozeilenversion von HSAdmin mit dem Befehl ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-gitea',password:'geheim',comment:'Domain-Nutzer'}})
xyz00@hsadmin> domain.add({set:{name:'gitea.hs-example.de',user:'xyz00-gitea'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_giteadbuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_giteadb',owner:'xyz00_giteadbuser'}})

=== Installation von Gitea ===

Gitea wird als Binary zur Verfügung gestellt.
Wir installieren das Binary im Verzeichnis des Domain-Benutzers.
Wenn wir als Paketbenutzer eingeloggt sind, können wir den Benutzer folgendermaßen wechseln:

sudo -u xyz00-gitea -i

Nun laden wir das passende Binary herunter.
Auf der Website https://dl.gitea.io/gitea/ finden Sie das jeweils aktuelle Binary.

wget -O gitea https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64
chmod +x gitea

Wir laden die GPG-Signatur herunter und überprüfen sie:

wget https://dl.gitea.io/gitea/1.7.0/gitea-1.7.0-linux-amd64.asc
gpg --keyserver pgp.mit.edu --recv 7C9E68152594688862D62AF62D9AE806EC1592E2
gpg --verify gitea-1.7.0-linux-amd64.asc gitea-1.7.0-linux-amd64

Nun können wir Gitea testweise starten:

./gitea web

Der Webserver von Gitea startet auf dem Port 3000. Das werden wir später ändern.

Der Server kann mit Ctrl-C beendet werden.

=== Konfiguration von Gitea und der Domain ===

Zunächst wechseln wir in das Verzeichnis 'doms/gitea.hs-example.de' und löschen den Ordner für die Subdomain 'www':

rm -rf subs/www
rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein, falls dies nicht schon geschehen ist.

vi htdocs/.htaccess

Der Eintrag muss lauten:

Redirect permanent / https://gitea.hs-example.com/

Dann legen wir die Datei htdocs-ssl/.htaccess mit folgendem Inhalt an:

RewriteEngine on
RewriteBase /
RewriteRule ^(.*) http://localhost:31580/$1 [proxy,last]

Merken Sie sich die Portnummer 31580.
Sie wird später bei der Konfiguration von Gitea gebraucht.
Die Portnummer bekommen Sie vom Hostmaster, wenn Sie für Ihren Webspace einen Serverdienst (Daemon) buchen.
Wenn Sie einen Managed Server haben, können Sie selbst die Portnummer auswählen.

Damit ist die Konfiguration von Apache abgeschlossen.

Wir editieren nun die Konfigurationsdatei von Gitea 'app.ini'.
Sie befindet sich in dem Verzeichnis '~/custom/conf'.

ACHTUNG: Sie können die Konfiguration teilweise auch über das Webinterface durchführen. Starten Sie dazu Gitea, wie oben beschrieben, und versuchen Sie einen Benutzer zu registrieren. Daraufhin öffnet sich der Konfigurationsdialog. Sie müssen den Gitea-Benutzer, den Namen der Datenbank, den Datenbank-Benutzer und sein Passwort parat haben.

Die Datei beginnt mit allgemeinen Einträgen:

APP_NAME = Gitea: Git with a cup of tea
RUN_USER = xyz00-gitea
RUN_MODE = prod

Im Abschnitt [database] folgen die Angaben zur Datenbank:

[database]
DB_TYPE = postgres
HOST = 127.0.0.1:5432
NAME = xyz00_giteadb
USER = xyz00_giteadbuser
PASSWD = giteahs
SSL_MODE = disable
PATH = data/gitea.db

Es folgt der Pfad zu den Git-Repositorys und die Server-Konfiguration:

[repository]
ROOT = /home/pacs/xyz00/users/gitea/gitea-repositories

[server]
PROTOCOL = http
SSH_DOMAIN = gitea.hs-example.de
DOMAIN = gitea.hs-example.de
HTTP_ADDR = localhost
HTTP_PORT = 31580
ROOT_URL = https://gitea.hs-example.de/
DISABLE_SSH = false
SSH_PORT = 22
LFS_START_SERVER = true

Sie können nun Gitea starten:

./gitea web

Und den Git-Service im Browser unter der Adresse gitea.hs-example.de öffnen.

=== Start- und Stopp-Skripte einrichten ===

Zum Schluss müssen Sie noch Start- und Stoppskripte einrichten und Monit konfigurieren.

Das Startskript speichern Sie unter dem Pfad '~/bin/gitea-start.sh' ab.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME
exec $HOME/gitea web >$HOME/custom/logs/gitea.log 2>&1 &
echo $! > $PID

Das Stoppskript speichern Sie unter dem Pfad '~/bin/gitea-stopp.sh' an.
Es hat folgenden Inhalt:

#!/bin/bash
export HOME=/home/pacs/xyz00/users/gitea
export PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
export PID=$HOME/.gitea.pid
cd $HOME

if [ -f $PID ] ; then
kill $( cat $PID );
sleep 20 ;
kill -9 $( cat $PID ) >/dev/null 2>&1 ;
rm $PID ;
fi

Monit ist ein Programm zur Überwachung eines Servers oder eines Dienstes.
Das Programm erwartet im Verzeichnis des Domain-Benutzers die Datei '~/.monitrc' mit der entsprechenden Konfiguration.
Legen Sie die Datei mit folgendem Inhalt an:

set daemon 600
set logfile /home/pacs/xyz00/users/gitea/custom/logs/monit.log
set mailserver localhost
set alert webmaster@gitea.hs-example.de

check process gitead with pidfile /home/pacs/xyz00/users/gitea/.gitea.pid
start program "/home/pacs/xyz00/users/gitea/bin/gitea-start.sh"
stop program "/home/pacs/xyz00/users/gitea/bin/gitea-stop.sh"

Nun können Sie noch die Rotation der Logfiles konfigurieren.
Dies geschieht in der Datei '~/.logrotate':

/home/pacs/xyz00/users/gitea/custom/logs/gitea.log {
copytruncate
daily
rotate 7
compress
missingok
}
/home/pacs/xyz00/users/gitea/custom/logs/monit.log {
copytruncate
monthly
rotate 2
compress
missingok
}

Damit die Konfiguration für logrotate und monit auch nach einem Server-Neustart eingelesen werden, müssen Sie folgenden Eintrag in der crontab der Domain-Benutzers machen:

# m h dom mon dow command
HOME=/home/pacs/xyz00/users/gitea
PATH=$HOME/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games
PID=$HOME/.gitea.pid
@reboot /usr/bin/monit -c $HOME/.monitrc > /dev/null
51 1 * * * /usr/sbin/logrotate -s $HOME/.logrotate.state $HOME/.logrotate

Wichtig ist der @reboot-Eintrag, der automatisch nach einem Neustart des Hosts ausgeführt wird.
Die Uhrzeit für die Logrotation können Sie beliebig einstellen.

Abschließend können Sie Ihre Gitea-Instanz starten:

~/bin/gitea-start.sh

Green Web Foundation

2018-12-11T12:07:31Z

Has00: Einbindung des Badge beschrieben

Hostsharing ist Mitglied der Green Web Foundation und hat nachgewiesen, dass in den Rechenzentren der Genossenschaft Strom aus erneuerbaren Energiequellen genutzt wird.

Deshalb kann nicht nur Hostsharing sich mit dem Badge der Green Web Foundation schmücken.
Auch alle bei Hostsharing gehosteten Websites können das Signet einbinden.

== Benutzung der Website der Green Web Foundation ==

Die Green Web Foundation betreibt ein Register, in dem Websites aufgeführt werden, die mit grünem Strom betrieben werden. Auf der Website https://www.thegreenwebfoundation.org/ lässt sich der Status einer Website abfragen.

Gebt einfach in das Suchfeld die Adresse der Website ein.

Falls eure Website bei Hostsharing gehostet ist, erscheint ein grüner Smiley:

[[Datei:Green_Web_Foundation_Hostsharing.png]]

== Einbindung des Badge ==

Das Badge der Green Web Foundation könnt ihr auf zwei Arten in eure Website einbinden.

1. Ihr könnt entweder den angegebenen Link zur API an die Stelle setzen, an der der Badge auf euren Seiten erscheinen soll.

<img src="https://api.thegreenwebfoundation.org/greencheckimage/www.example.com" alt="This website is hosted Green - checked by thegreenwebfoundation.org">

Dann wird die Bilddatei mit dem Badge von der Website der Green Web Foundation aus eingebunden.
Die Folge ist, dass die Browser der Besucher eurer Website eine Anfrage an den Server der Foundation stellen, wodurch Daten übertragen werden.

2. Wenn ihr verhindern wollt, dass Daten an die Foundation fließen, speichert einfach die Bilddatei in eurer Website ab und bindet sie so in den Seitencode eurer Website ein. Ein solcher Link könnte so aussehen:

<a class="image" href="https://www.thegreenwebfoundation.org/green-web-check/?url=www.example.com"><img src="images/badge-greenwebfoundation.png"></a>

Datei:Green Web Foundation Hostsharing.png

2018-12-11T11:52:36Z

Has00: Anzeige auf der Website der Green Web Foundation

Anzeige auf der Website der Green Web Foundation

Green Web Foundation

2018-12-11T11:50:45Z

Has00:

Hostsharing ist Mitglied der Green Web Foundation und hat nachgewiesen, dass in den Rechenzentren der Genossenschaft Strom aus erneuerbaren Energiequellen genutzt wird.

Alle bei Hostsharing gehosteten Websites können deshalb ein Signet der Green Web Foundation einbinden.

== Benutzung der Website der Green Web Foundation ==

Auf der Website https://www.thegreenwebfoundation.org/ lässt sich der Status einer Website abfragen.

Gebt einfach in das Suchfeld die Adresse eurer Website ein. Falls eure Website bei Hostsharing gehostet ist, erscheint ein grüner Smiley wie zum Beispiel hier:

https://www.thegreenwebfoundation.org/green-web-check/?url=www.hostsharing.net

[[Datei:Green_Web_Foundation_Hostsharing.png]]

Green Web Foundation

2018-12-11T11:49:01Z

Has00: Die Seite wurde neu angelegt: „Hostsharing ist Mitglied der Green Web Foundation und hat nachgewiesen, dass in den Rechenzentren der Genossenschaft Strom aus erneuerbaren Energiequellen genu…“

Hauptseite

2018-12-11T11:42:50Z

Has00: /* Hostsharing Benefits */ Grüner Strom Green Web Foundation

{{HSDoku-Links}} __NOTOC__

== Willkommen im Hostsharing-Wiki! ==
... der '''inoffiziellen''' Dokumentation der Mitglieder von Hostsharing. Die wichtigsten Themen findest du in der Leiste oben. Alle Themen und Seiten des Wiki erreichst du am besten über die Kategorie [[:Kategorie:HSDoku|HSDoku]].

Die '''offizielle''' Kerndokumentation ist unter:
https://doc.hostsharing.net/users/

Allgemeine Fragen zum Umgang mit den HS Diensten und Angeboten beantwortet die HS Community in der [https://lists.hostsharing.net/mailman/listinfo/support Support Mailingliste] mit der Mailadresse [mailto:support@hostsharing.net support@hostsharing.net]. Fragen, die vertrauliche Themen behandeln (Domainnamen, Benutzernamen, Passwörter etc.) sollten direkt an den [[HS-Service]] gehen, der ansonsten kostenpflichtig ist. Ergänzende Hinweise finden sich in den [https://lists.hostsharing.net/archiv/global-announce/ Global Announces] der Hostmaster und des Vorstandes zu aktuellen Geschehnissen und technischen Änderungen bei Hostsharing.

Du kannst dich mit deinen HS Userdaten einloggen und mithelfen, die Dokumentation zu verbessern. In unserem [[Autorenportal]] findest du Hinweise dazu, wie du dich beteiligen kannst. Was hier ins Wiki gehört, und wie es gemacht wird, ist unter [[Hilfe:Hostsharing_Wiki_Konventionen|Konventionen]] erklärt.

Zum Testen und Rumspielen ist der [[Sandkasten]] da. Und nun viel Freude im Hostsharing Wiki :-)

== Hostsharing Benefits ==

Hostsharing.net ist die professionelle Alternative zur Administration eigener Root Server mit dem Bonus der Redundanz und des gemeinschaftlich organisierten Betriebes.

[[Green Web Foundation | Ökostrom: Hostsharing ist Mitglied der Green Web Foundation]]

[[10 Missverständnisse über dedizierte root-Server | Rootserver Missverständnisse]] 
[[Rootserver Checkliste]]

==Mastodon-Instanz für Mitglieder==
[[Einrichtung und Benutzung von Mastodon-Accounts auf https://hostsharing.coop]] 
[[Einrichtung des Crossposting Bots]] 

----
[[Kategorie:Hostsharing Wiki]]
[[Kategorie:HSDoku]]

Mastodon bei Hostsharing

2018-10-10T06:58:02Z

Has00: Kleiner SEO Einstieg

Diese Anleitung beschreibt, wie man Mastodon auf der Managed Hosting Plattform von Hostsharing installieren kann.

{{Textkasten|gelb|Für Managed Server|Ein funktionierender Mastodon-Server erfordert mehrere laufende Server-Dienste. Für den Betrieb ist ein Managed Server sinnvoll.}}

== Vorbereitungen ==

Mit Hilfe von HSAdmin wird angelegt:
# Ein User als Service-User mit ''/bin/bash'' als Shell, zum Beispiel Beispiel: ''xyz00-mastodon''
# Eine Domain mit ''xyz00-mastodon'' als Domain-Administrator, zum Beispiel ''beispiel.social''
# Einen Postgresql-User ''xyz00_mastuser'' mit Passwort ''meinPasswort''
# Eine Postgresql-Datenbank ''xyz00_mastdb'' mit Datenbank-Owner ''xyz00_mastuser''

Verwendete IP-Ports der Server-Dienste:
# Monit: localhost:32001
# Redis: localhost:32002
# Mastodon-Web: localhost:32003
# Mastodon-Streaming: localhost:32004

== Konfiguration des Redis Server ==

Anlegen einer Datei ''/home/pacs/xyz00/users/mastodon/redis/etc/redis.conf'' mit folgendem Inhalt:

daemonize yes
pidfile /home/pacs/xyz00/users/mastodon/redis/var/redis-server.pid
port 32002
tcp-backlog 128
bind 127.0.0.1
timeout 300
loglevel notice
logfile /home/pacs/xyz00/users/mastodon/redis/var/redis.log
databases 16
save 900 1
save 300 10
save 60 10000
slave-serve-stale-data yes
appendonly no
dbfilename dump.rdb
dir /home/pacs/xyz00/users/mastodon/redis/var

== Installation von NodeJS ==

Als User 'xyz00-mastodon'': Installation von ''nvm'' und ''nodejs'' (Version 8) nach der Anleitung [[NodeJS]]

Installation von ''yarn'' mit:

npm install -g yarn

== Installation von Ruby ==

Als User ''xyz00-mastodon'': Installation von Ruby mit ''rbenv'' mit folgenden Befehlen:

Zunächst ''rbenv'' and ''ruby-build'':

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
cd ~/.rbenv && src/configure && make -C src
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.profile
echo 'eval "$(rbenv init -)"' >> ~/.profile

starte neue Shell:

exec bash

Überprüfe rbenv-Installation

type rbenv

Installiere ruby-build als rbenv-Plugin

git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

Nun kann die benötigte Ruby-Version installiert werden:

rbenv install 2.5.1

== Installation der Mastodon Software ==

Weiterhin Als User ''xyz00-mastodon'':

cd ~
git clone https://github.com/tootsuite/mastodon.git live
cd ~/live

Die stabile Version auschecken:

git checkout $(git tag -l | grep -v 'rc[0-9]*$' | sort -V | tail -n 1)

Ruby Pakete installieren:

gem install bundler
bundle install -j$(getconf _NPROCESSORS_ONLN) --deployment --without development test

Node.js Pakete installieren:

yarn install --pure-lockfile

== Konfiguration der Mastodon Software ==

Anlegen einer Datei ''/home/pacs/xyz00/users/mastodon/mystodon/live/.env.production'' mit dem folgenden Inhalt:

REDIS_HOST=localhost
REDIS_PORT=32002
DB_HOST=localhost
DB_USER=xyz00_mastuser
DB_NAME=xyz00_mastdb
DB_PASS=meinPasswort
DB_PORT=5432
LOCAL_DOMAIN=beispiel.social
SECRET_KEY_BASE=12ab..
OTP_SECRET=34ef..
VAPID_PRIVATE_KEY=ABCD..
VAPID_PUBLIC_KEY=EFGH..
DEFAULT_LOCALE=de
SMTP_SERVER=localhost
SMTP_PORT=25
SMTP_FROM_ADDRESS=notifications@beispiel.social
SMTP_AUTH_METHOD=none
SMTP_OPENSSL_VERIFY_MODE=none
STREAMING_CLUSTER_NUM=1

Die Zufallswerte für die Variablen SECRET_KEY_BASE und OTP_SECRET erzeugt man durch zwei Aufrufe des Kommandos

RAILS_ENV=production bundle exec rake secret

Die Werte für VAPID_PRIVATE_KEY und VAPID_PUBLIC_KEY erzeugt das Kommando

RAILS_ENV=production bundle exec rake mastodon:webpush:generate_vapid_key

Initialisieren der Datenbank:

export SAFETY_ASSURED=1
RAILS_ENV=production bundle exec rails db:schema:load
RAILS_ENV=production bundle exec rails db:seed

== Starten der Dienste ==

Zum Start aller notwendigen Dienste wird in dieser Anleitung ''monit'' benutzt. Hier ein Beispiel für eine Datei ''.monitrc'' (überlange Zeilen werden hier im Wiki umgebrochen)

set daemon 60
with start delay 120
set logfile /home/pacs/xyz00/users/mastodon/monit/var/monit.log
set idfile /home/pacs/xyz00/users/mastodon/monit/var/monit.id
set statefile /home/pacs/xyz00/users/mastodon/monit/var/monit.state
set mailserver localhost
set mail-format { from: monit@beispiel.social }
set alert mastodon@beispiel.social
set httpd port 32001 address xyz00.hostsharing.net
allow mostodon:monitpassword
check process redis with pidfile /home/pacs/xyz00/users/mastodon/redis/var/redis-server.pid
start program "/usr/bin/redis-server /home/pacs/xyz00/users/mastodon/redis/etc/redis.conf"
stop program "/bin/bash -c '/bin/kill $( cat /home/pacs/xyz00/users/mastodon/redis/var/redis-server.pid )'"
check process mstdn_web with pidfile /home/pacs/xyz00/users/mastodon/mastodon/var/puma.pid
depends redis
start program "/bin/bash -c 'export HOME=/home/pacs/xyz00/users/mastodon && cd $HOME/mastodon/live && ( $HOME/.rbenv/shims/bundle exec puma -C config/puma.rb -e production -b tcp://127.0.0.1:32003 >$HOME/mastodon/var/puma.log 2>&1 & echo $! > $HOME/mastodon/var/puma.pid )'"
stop program "/bin/bash -c '/bin/kill $( cat /home/pacs/xyz00/users/mastodon/mastodon/var/puma.pid )'"
check process mstdn_sidekiq with pidfile /home/pacs/xyz00/users/mastodon/mastodon/var/sidekiq.pid
depends redis
start program "/bin/bash -c 'export RAILS_ENV=production && export DB_POOL=5 && export HOME=/home/pacs/xyz00/users/mastodon && cd $HOME/mastodon/live && ( $HOME/.rbenv/shims/bundle exec sidekiq -c 5 -q default -q mailers -q pull -q push >$HOME/mastodon/var/sidekiq.log 2>&1 & echo $! > $HOME/mastodon/var/sidekiq.pid )'"
stop program "/bin/bash -c '/bin/kill $( cat /home/pacs/xyz00/users/mastodon/mastodon/var/sidekiq.pid )'"
check process mstdn_streaming with pidfile /home/pacs/xyz00/users/mastodon/mastodon/var/streaming.pid
depends redis
start program "/bin/bash -c 'export HOME=/home/pacs/xyz00/users/mastodon && export NVM_DIR="$HOME/.nvm" && export NVM_BIN=/home/pacs/xyz00/users/mastodon/.nvm/versions/node/v8.12.0/bin && export NODE_ENV=production && export PORT=32004 && BIND=127.0.0.1 && cd $HOME/mastodon/live && ( $HOME/.nvm/versions/node/v8.12.0/bin/node streaming/index.js >$HOME/mastodon/var/streaming.log 2>&1 & echo $! > $HOME/mastodon/var/streaming.pid )'"
stop program "/bin/bash -c '/bin/kill $( cat /home/pacs/xyz00/users/mastodon/mastodon/var/streaming.pid )'"

== Einrichten des Apache VHost ==

cd ~/doms/beispiel.social
rm -rf htdocs-ssl subs/www subs-ssl/www
ln -s ~/live/public htdocs-ssl
touch htdocs-ssl/.htaccess

Dann die ''htdocs-ssl/.htaccess'' mit dem Editor der Wahl öffnen und
folgende Konfiguration einfügen:

DirectoryIndex disabled
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_URI} ^/api/v1/streaming [NC]
RewriteRule .* ws://localhost:32004%{REQUEST_URI} [proxy]
RequestHeader set X-Forwarded-Proto "https"
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* http://localhost:32003%{REQUEST_URI} [proxy]
RequestHeader set X-Forwarded-Proto "https"

== Cronjobs ==

''Cron'' wird für zwei Aufgaben genutzt:
* Start von monit nach einem Server Reboot
* Aufräumen von alten Resourcen

Einrichten der crontab mit ''cronttab -e''

HOME=/home/pacs/xyz00/users/mastodon
MAILTO=mastodon@beispiel.social
RAILS_ENV=production
NUM_DAYS=31

@reboot /usr/bin/monit -c $HOME/.monitrc
18 4 * * * cd $HOME/mastodon/live && $HOME/.rbenv/shims/bundle exec rake mastodon:media:remove_remote

== Volltextsuche ==

In der installierten Version gibt es noch keine Volltextsuche. Es kann lediglich nach Nutzerkennungen und Hastags gesucht werden. Für die Volltextsuche kann optional Elasticsearch installiert werden.
* https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Elasticsearch-guide.md

== Links ==

* https://github.com/tootsuite/documentation/blob/master/Running-Mastodon/Production-guide.md
* https://krinetzki.de/2017/04/installation-von-mastodon-auf-debian-8-jessie/

[[Kategorie:Installationsanleitungen]]

Domainregistrierung

2018-08-06T16:00:43Z

Has00: Reihenfolge: erst HSAdmin dann Domain-Bestellsystem per Headline hervorgehoben

{{HSDoku-DomainLinks}}
__NOTOC__

=== Erst eine neue Domain über HSAdmin einrichten, dann über das Domain-Bestellsystem registrieren oder von einem anderen Provider transferieren ===

Wird eine neue Domain registriert oder von einem anderen Provider zu Hostsharing transferiert, sollte im Normalfall die Domain bei Hostsharing über HSAdmin eingerichtet werden, bevor die Registrierung letztlich eingeleitet bzw. aktualisiert wird. Sonst kann es zu Problemen beim Konnektieren der Domain kommen.

= Einrichten der Domain auf den HS Servern =

{{Kerndoku|https://doc.hostsharing.net/users/administration/hsadmin/domain.html}}

Der Domainname muss im Punicode Format angelegt werden aus münster.de wird xn--mnster-3ya.de .

Bei diesem Vorgang werden die Verzeichnisse für die Domain im eigenen Paket angelegt und die Domain wird auf die Mail, Web- und Nameserver von HS [[Aufschaltung|aufgeschaltet]]. Letzteres (das Nameserver-Update) ist Voraussetzung für den nächsten Schritt.

= Domainregistrierung oder eingehender Transfer ([[KK]]) =

== Bei fremdem Provider registrierte Domain zum Transfer freischalten ==

Falls die Domain bisher bei einem anderen Provider gehostet ist, muss diesem die Transfer-Absicht mitgeteilt werden. Dafür gibt es bei den jeweiligen Providern etablierte Verfahren, die dort zu erfragen sind. Üblicherweise bekommt man dort einen AuthCode für die Domain mitgeteilt. Gibt es kein etabliertes Verfahren, so kann man wie folgt verfahren:

* Formlos per Brief/Fax den Transfer ankündigen und um Zustimmung bitten, z.B.:
<pre>
Hiermit kündige ich als Owner/Admin-C den Transfer (KK) der
Domain example.com zur Hostsharing eG, vertreten durch den Registrar
Internetwire, an. Ich bitte, dem folgenden Transferantrag zuzustimmen.
</pre>

* Nach Absendung der Transfer-Ankündigung 3-4 Tage warten, um dem alten Provider Zeit zu geben auf den Transferantrag zu reagieren.
* Wenn dem Transfer nicht stattgegeben wird, den Registrar der Domain herausfinden (z.B. über die Nameserver oder zuständige Registry) und bitten den Transfer zuzulassen.

== Neuregistrierung oder Transfer zu Hostsharing ([[KK]]) ==

Die Vorgehensweise ist unter https://doc.hostsharing.net/users/anleitung/domain.html beschrieben.

* Bei der allerersten Domainregistrierung im Domainbestellsystem müssen die Hostsharing Nameserver noch manuell eingegeben werden. Es sind dies:

dns1.hostsharing.net
dns2.hostsharing.net
dns3.hostsharing.net

= E-Mail-Adressen der neu eingerichteten Domain =

Ist die Domain bei Hostsharing aufgeschaltet, sind standardmäßig nur die E-Mail-Adressen webmaster@..., postmaster@... und abuse@... eingerichtet. Die Einrichtung weiterer E-Mail-Adressen ist unter [https://doc.hostsharing.net/users/anleitung/email.html] beschrieben.

[[Kategorie:HSDoku]]
[[Kategorie:Domains]]
[[Kategorie:Hsadmin]]

Observatory by Mozilla

2018-06-24T14:20:18Z

Has00: /* Meta-Tag Snippet für A+ Rating */

== Sicherheits-Scan mit Rating ==

[https://observatory.mozilla.org/ Das Observatory von Mozilla] scannt Websites und analysiert die Implementierung von wichtigen Sicherheits-Features. Auf der Ergebnisseite werden Webmaster darüber informiert, wie ihre Website abgeschnitten hat. Neben einem Rating von A bis F (analog der US-amerikanischen Schulnoten) erfährt man auf der Ergebnisseite, wie man die Sicherheit der eigenen Website verbessern kann.

Mozilla hat die Sicherheitshinweise in ausführlichen [https://infosec.mozilla.org/guidelines/web_security.html Guidelines] zusammengefasst.

== Snippet für A+ Rating ==

Die Header zur Verbesserung der Sicherheit können in der Apache-Konfiguration gesetzt werden. Zum Beispiel in der Datei [[.htaccess]]

Mit der folgenden Konfiguration erzielt die Homepage von Hostsharing beim Rating ein A+:

Header set Content-Security-Policy "default-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "DENY"
Header set X-XSS-Protection "1; mode=block"

== Meta-Tag Snippet für A+ Rating ==

Die Header können teilweise auch im HTML-Code der Website gesetzt werden.

Mit diesen Meta-Tags im Header erzielt man ebenfalls ein A+-Rating:

<meta http-equiv="Content-Security-Policy" content="default-src 'none'; object-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'">
<meta http-equiv="X-XSS-Protection" content="1; mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="X-Frame-Options" content="DENY">
<meta http-equiv="Referrer-Policy" content="no-referrer, strict-origin-when-cross-origin">

Observatory by Mozilla

2018-06-24T14:07:11Z

Has00: /* Snippet für A+ Rating */ .htaccess erwähnt

== Sicherheits-Scan mit Rating ==

[https://observatory.mozilla.org/ Das Observatory von Mozilla] scannt Websites und analysiert die Implementierung von wichtigen Sicherheits-Features. Auf der Ergebnisseite werden Webmaster darüber informiert, wie ihre Website abgeschnitten hat. Neben einem Rating von A bis F (analog der US-amerikanischen Schulnoten) erfährt man auf der Ergebnisseite, wie man die Sicherheit der eigenen Website verbessern kann.

Mozilla hat die Sicherheitshinweise in ausführlichen [https://infosec.mozilla.org/guidelines/web_security.html Guidelines] zusammengefasst.

== Snippet für A+ Rating ==

Die Header zur Verbesserung der Sicherheit können in der Apache-Konfiguration gesetzt werden. Zum Beispiel in der Datei [[.htaccess]]

Mit der folgenden Konfiguration erzielt die Homepage von Hostsharing beim Rating ein A+:

Header set Content-Security-Policy "default-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "DENY"
Header set X-XSS-Protection "1; mode=block"

== Meta-Tag Snippet für A+ Rating ==

Die Header können auch in HTML-Code der Website gesetzt werden.

Mit diesen Meta-Tags im Header erzielt man ebenfalls ein A+-Rating:

<meta http-equiv="Content-Security-Policy" content="default-src 'none'; object-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'">
<meta http-equiv="X-XSS-Protection" content="1; mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="X-Frame-Options" content="DENY">
<meta http-equiv="Referrer-Policy" content="no-referrer, strict-origin-when-cross-origin">

Observatory by Mozilla

2018-06-24T11:41:45Z

Has00: /* Meta-Tag Snippet für A+ Rating */

== Sicherheits-Scan mit Rating ==

[https://observatory.mozilla.org/ Das Observatory von Mozilla] scannt Websites und analysiert die Implementierung von wichtigen Sicherheits-Features. Auf der Ergebnisseite werden Webmaster darüber informiert, wie ihre Website abgeschnitten hat. Neben einem Rating von A bis F (analog der US-amerikanischen Schulnoten) erfährt man auf der Ergebnisseite, wie man die Sicherheit der eigenen Website verbessern kann.

Mozilla hat die Sicherheitshinweise in ausführlichen [https://infosec.mozilla.org/guidelines/web_security.html Guidelines] zusammengefasst.

== Snippet für A+ Rating ==

Die Header zur Verbesserung der Sicherheit können in der Apache-Konfiguration gesetzt werden.

Mit der folgenden Konfiguration erzielt die Homepage von Hostsharing beim Rating ein A+:

Header set Content-Security-Policy "default-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "DENY"
Header set X-XSS-Protection "1; mode=block"

== Meta-Tag Snippet für A+ Rating ==

Die Header können auch in HTML-Code der Website gesetzt werden.

Mit diesen Meta-Tags im Header erzielt man ebenfalls ein A+-Rating:

<meta http-equiv="Content-Security-Policy" content="default-src 'none'; object-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'">
<meta http-equiv="X-XSS-Protection" content="1; mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="X-Frame-Options" content="DENY">
<meta http-equiv="Referrer-Policy" content="no-referrer, strict-origin-when-cross-origin">

Observatory by Mozilla

2018-06-24T11:41:04Z

Has00: /* Snippet für A+ Rating */

== Sicherheits-Scan mit Rating ==

[https://observatory.mozilla.org/ Das Observatory von Mozilla] scannt Websites und analysiert die Implementierung von wichtigen Sicherheits-Features. Auf der Ergebnisseite werden Webmaster darüber informiert, wie ihre Website abgeschnitten hat. Neben einem Rating von A bis F (analog der US-amerikanischen Schulnoten) erfährt man auf der Ergebnisseite, wie man die Sicherheit der eigenen Website verbessern kann.

Mozilla hat die Sicherheitshinweise in ausführlichen [https://infosec.mozilla.org/guidelines/web_security.html Guidelines] zusammengefasst.

== Snippet für A+ Rating ==

Die Header zur Verbesserung der Sicherheit können in der Apache-Konfiguration gesetzt werden.

Mit der folgenden Konfiguration erzielt die Homepage von Hostsharing beim Rating ein A+:

Header set Content-Security-Policy "default-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "DENY"
Header set X-XSS-Protection "1; mode=block"

== Meta-Tag Snippet für A+ Rating ==

Mit diesen Meta-Tags im Header erzielt man ebenfalls ein A+-Rating:

<meta http-equiv="Content-Security-Policy" content="default-src 'none'; object-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'">
<meta http-equiv="X-XSS-Protection" content="1; mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="X-Frame-Options" content="DENY">
<meta http-equiv="Referrer-Policy" content="no-referrer, strict-origin-when-cross-origin">

Observatory by Mozilla

2018-06-24T11:30:42Z

Has00: /* Sicherheits-Scan mit Rating */

== Sicherheits-Scan mit Rating ==

[https://observatory.mozilla.org/ Das Observatory von Mozilla] scannt Websites und analysiert die Implementierung von wichtigen Sicherheits-Features. Auf der Ergebnisseite werden Webmaster darüber informiert, wie ihre Website abgeschnitten hat. Neben einem Rating von A bis F (analog der US-amerikanischen Schulnoten) erfährt man auf der Ergebnisseite, wie man die Sicherheit der eigenen Website verbessern kann.

Mozilla hat die Sicherheitshinweise in ausführlichen [https://infosec.mozilla.org/guidelines/web_security.html Guidelines] zusammengefasst.

== Snippet für A+ Rating ==

Header set Content-Security-Policy "default-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "DENY"
Header set X-XSS-Protection "1; mode=block"

== Meta-Tag Snippet für A+ Rating ==

Mit diesen Meta-Tags im Header erzielt man ebenfalls ein A+-Rating:

<meta http-equiv="Content-Security-Policy" content="default-src 'none'; object-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'">
<meta http-equiv="X-XSS-Protection" content="1; mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="X-Frame-Options" content="DENY">
<meta http-equiv="Referrer-Policy" content="no-referrer, strict-origin-when-cross-origin">

Observatory by Mozilla

2018-06-24T11:29:05Z

Has00: /* Sicherheits-Scan mit Rating */

== Sicherheits-Scan mit Rating ==

[https://observatory.mozilla.org/ Das Observatory von Mozilla] scannt Websites und analysiert die Implementierung von wichtigen Sicherheits-Features. Auf der Ergebnisseite werden Webmaster darüber informiert, wie ihre Website abgeschnitten hat. Neben einem Rating von A bis F (analog der US-amerikanischen Schulnoten) erfährt man auf der Ergebnisseite, wie man die Sicherheit der eigenen Website verbessern kann.

== Snippet für A+ Rating ==

Header set Content-Security-Policy "default-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "DENY"
Header set X-XSS-Protection "1; mode=block"

== Meta-Tag Snippet für A+ Rating ==

Mit diesen Meta-Tags im Header erzielt man ebenfalls ein A+-Rating:

<meta http-equiv="Content-Security-Policy" content="default-src 'none'; object-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'">
<meta http-equiv="X-XSS-Protection" content="1; mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="X-Frame-Options" content="DENY">
<meta http-equiv="Referrer-Policy" content="no-referrer, strict-origin-when-cross-origin">

Observatory by Mozilla

2018-06-24T11:25:05Z

Has00: Erste Fassung

== Sicherheits-Scan mit Rating ==

[https://observatory.mozilla.org/ Das Observatory von Mozilla] scannt Websites und analysiert die Sicherheitseinstellungen. Die Ergebnisseite gibt ein Rating aus und erklärt, wie man das Rating verbessern kann.

== Snippet für A+ Rating ==

Header set Content-Security-Policy "default-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'"
Header set X-Content-Type-Options "nosniff"
Header set X-Frame-Options "DENY"
Header set X-XSS-Protection "1; mode=block"

== Meta-Tag Snippet für A+ Rating ==

Mit diesen Meta-Tags im Header erzielt man ebenfalls ein A+-Rating:

<meta http-equiv="Content-Security-Policy" content="default-src 'none'; object-src 'none'; font-src 'self'; img-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'">
<meta http-equiv="X-XSS-Protection" content="1; mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="X-Frame-Options" content="DENY">
<meta http-equiv="Referrer-Policy" content="no-referrer, strict-origin-when-cross-origin">

WWW

2018-06-24T11:11:29Z

Has00: Observatory Link

{{HSDoku-Links}}

Diese Seite gibt Hinweise zur Konfiguration des Webservers und beschreibt Einstellungen, die typischerweise an eigene Bedürfnisse angepasst werden.

== Einstellungen zum HTTP Zugriff ==
Mit .htaccess Dateien können innerhalb der Domainverzeichnisse z.B. Verzeichnisschutz, Filelistings und Umleitungen (Redirects/Rewrites) des Apache Webservers eingestellt werden. Die Konfiguration wird auf der Seite [[.htaccess]] beschrieben.

=== Abbildung von http(s)-Requests auf das Dateisystem ===
* http(s)-Requests auf example.com werden auf das Verzeichnis ~/doms/example.com/htdocs(-ssl) geroutet. Standardmäßig ist im Verzeichnis ~/doms/example.com/htdocs(-ssl) eine .htaccess-Datei hinterlegt, welche beim Zugriff auf http(s)://example.com eine Weiterleitung auf http(s)://www.example.com auslöst.

* http(s)-Requests auf www.example.com werden auf das Verzeichnis ~/doms/example.com/subs(-ssl)/www geroutet, sofern dieses existiert.

Ansonsten werden diese Requests ebenfalls auf das Verzeichnis ~/doms/example.com/htdocs(-ssl) geroutet. Hierbei gilt www lediglich als
Standardbeispiel, es sind beliebige Subdomainnamen verwendbar. Dies sind sogenannte [[Leichtgewichtige Subdomain|leichtgewichtige Subdomains]].

Für [[Aufschaltung|aufgeschaltete Subdomains]] gilt das oben beschriebene analog. Sie werden intern wie eigene Domains behandelt. Die Subdomain (z.b. sub.example.com) tritt dann an die Stelle von example.com.

=== Anwendungsbeispiel ===
Alle Requests auf Subdomains, für die kein passendes Verzeichnis unterhalb von subs(-ssl) existiert, werden auf htdocs(-ssl) geroutet.

Löscht man nun die Weiterleitung aus dem Verzeichnis htdocs(-ssl) und installiert eine subdomainfähige Webanwendung, etwa gängige Content-Management-Systeme oder Blogs, in htdocs(-ssl) und löscht zudem subs(-ssl)/www, so kann die Webanwendung die Subdomains selbstständig verwalten. Das Einrichten neuer Subdomains innerhalb der Webanwendung erfordert dann keinen Eingriff in die Verzeichnisstrukturen mehr.

== Https / SSL / TLS ==
"Secure Socket Layer": Die Nutzung von verschlüsselten https:// Verbindungen und Sicherheitszertifikaten wird auf der Seite [[TLS_/_SSL|TLS/SSL]] beschrieben.

== PHP Ausführung ==
PHP Skripte (.php Dateien) werden beim http Zugriff standardmäßig ausgeführt. PHP kann jedoch (und muss oft) an individuelle Bedürfnisse angepasst werden. Die Konfiguration wird auf der Seite [[PHP]] beschrieben.

== Einstellen des im HTTP Header angegebenen Zeichensatzes ==
Die HS Systeme bieten volle Unterstützung für den universellen UTF Zeichensatz. Der Standard Zeichensatz, den der Apache Webserver im Header angibt, ist jedoch auf iso-8859-1 eingestellt. So funktionieren bestehende Webseiten, die im ISO Zeichensatz erstellt wurden, auch weiterhin ohne Modifikation.

Bei neuen Webseiten empfiehlt es sich, diese im UTF-8 Zeichensatz zu speichern, bzw. ist UTF-8 auf modernen Systemen ohnehin der Standardzeichensatz. Damit Webbrowser beim Abbruf von UTF-8-Seiten vom HS Server auch den korrekten UTF-8 Zeichensatz verwenden, muss jedoch entsprechend die Zeichensatzangabe im Header des Apache Webservers auf UTF-8 gestellt werden.

Für .htm(l) und .php Dateien kann dies in der [[.htaccess]] Datei mit Kombination in der php.ini siehe [[PHP|PHP Konfiguration]] eingestellt werden.

== CGI ==
"Common Gateway Interface": Was CGI Scripte sind und wie man sie auf unserem Server ausführen kann steht auf der Seite [[CGI]].

== Überwachung der HS-Dienste ==
Der Status der HS-Server, und damit auch der Status der eigenen Webseiten, wird von außen überwacht und ist unter [[Überwachung der HS-Dienste]] beschrieben.

== robots.txt ==

Die optionale Datei robots.txt dient der Steuerung der Indizierung der Webseiten einer Domain durch Suchmaschinen. Die Datei kann Steuerbefehle für die Robots enthalten, mit denen die Suchmaschinen Webseiten nach Informationen "abgrasen".

'''Achtung: Fehlerhafte oder so nicht gewollte Einträge können dafür sorgen, dass die Webseiten von den Suchmaschinen nicht mehr indiziert werden, also auch nicht mehr mit Suchmaschinen gefunden werden können!'''

Eine [http://http://www.robotstxt.org/ robots.txt]-Datei muss um Wurzelverzeichnis der veröffentlichten Website
abrufbar sein. Wenn die Website unter http://www.example.com erreichbar ist, muss
der Aufruf von http://www.example.com/robots.txt den Inhalt eben dieser Datei liefern.

Bei Hostsharing muss man sie also in den obersten Ordner der jeweiligen Website legen, für die Domain http://www.example.com in unserem Beispiel als [[Domain-Admin]] in den Ordner ~/doms/example.com/subs/www, wenn die Standardeinstellungen verwendet werden.

== Web Security ==

Firefox betreibt unter der URL https://observatory.mozilla.org/ einen Dienst zur Verbesserung der Sicherheit von Websites. Die Seite [[Observatory by Mozilla]] zeigt ein Snippet, mit dem man ein gutes Rating erzielen kann.
----
[[Kategorie:HSDoku]]
[[Kategorie:WWW]]

Tiny Tiny RSS Installieren

2017-08-30T12:54:51Z

Has00: /* Abschluss der Installation mit dem Installer von Tiny Tiny RSS */

== Über Tiny Tiny RSS ==

Wikipedia schreibt: »Tiny Tiny RSS ist ein freier, webbasierter Feedreader. Die Anwendung ermöglicht das Abonnieren und Betrachten von Web-Feeds über einen Webbrowser. Zudem gibt es eine offizielle Android-App, es wird jedoch auch ein API für weitere Clients zur Verfügung gestellt. Es werden die Formate RSS und Atom unterstützt. Das Programm ruft abonnierte Web-Feeds serverseitig in regelmäßigen Abständen ab und speichert die gefunden Artikel in einer Datenbank. Somit verpasst der Benutzer keinen Artikel, auch wenn er den Feedreader über einen langen Zeitraum nicht aufruft. Auf einer Instanz von Tiny Tiny RSS können mehrere Benutzer unabhängig voneinander arbeiten. Neue Benutzer können eigenständig direkt über die Anwendung ein neues Benutzerkonto erstellen. Des Weiteren bietet die Software komplexe Filterregeln für Artikel und das Teilen/Veröffentlichen von Artikeln in Form eines benutzerspezifischen Web-Feeds.«

== Vorbereitung der Installation ==

Um Tiny Tiny RSS auf der Managed Operation Platform von Hostsharing zu installieren, ist entsprechend der Best-Practice-Vorgaben folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers

2. Anlegen einer Domain

3. Anlegen eines Datenbank-Benutzers

4. Anlegen einer Datenbank (Tiny Tiny RSS arbeitet mit MySQL und PostgreSQL zusammen. Wir empfehlen die Nutzung von PostgreSQL.)

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet ''hsadmin'' mit ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-ttrss',password:'geheim',comment:'Drupal CMS'}})
xyz00@hsadmin> domain.add({set:{name:'ttrss.hs-example.de',user:'xyz00-ttrss'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_ttrssuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_ttrssdb',owner:'xyz00_ttrssuser'}})

== Herunterladen des Quellcodes mit Hilfe von Git ==

Wir installieren Tiny Tiny RSS mit Hilfe von Git aus den Quellen.

$ ssh xyz00-ttrss@xyz00.hostsharing.net
$ git clone https://tt-rss.org/git/tt-rss.git tt-rss

== Hostsharing-Dateisystem einrichten ==

Nun müssen wir nur noch einige Änderungen im Dateisystem vornehmen.

Wir wechseln in die neu angelegte Domain.

$ cd $HOME/doms/ttrss.hs-example.com/

Dort löschen wir zunächst die Ordner für die Subdomain <code>www</code>.

$ rm -rf subs/www
$ rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein.

$ vim htdocs/.htaccess

Der Eintrag muss folgendermaßen lauten:

Redirect permanent / https://ttrss.hs-example.com/

Danach löschen wir den htdocs-ssl Ordner und legen einen symbolischen Link auf unsere Shaarli-Installation an.

$ rm -rf htdocs-ssl/
$ ln -s $HOME/tt-rss htdocs-ssl

== Abschluss der Installation mit dem Installer von Tiny Tiny RSS ==

Unter der URL <code>ttrss.hs-example.com/install/</code> können wir nun den Installer von Tiny Tiny RSS aufrufen, um die Installation zu beenden.

[[Datei:Tiny-tiny-rss-installer.png]]

Database type: Die jeweils benutzte Datenbank, MySQL oder PostgreSQL

Username: Der Datenbankbenutzer: "xyz00_ttrssuser"

Passwort: Gemeint ist das Passwort des Datenbankbenutzers: "geheim"

Database name: der Namen der Datenbank: "xyz00_ttrssdb"

Host name: <code>localhost</code>.

Port: die jeweils gültige Portnummer; 3306 für MySQL und 5432 für PostgreSQL.

Tiny Tiny RSS URL: Die URL der neuen Domain unter der wir Tiny Tiny RSS aufrufen wollen: https://ttrss.hs-example.com/

Anschließend klicken wir auf "Test configuration", um die Konfiguration zu testen. War der Test erfolgreich, wird die Datei <code>config.php</code> angezeigt, in der alle Konfigurationsparameter stehen. Wir speichern die Konfigurations ab.

Nach dem Abspeichern befindet sich die Konfigurationsdatei unter dem Pfad <code>$HOME/tt-rss/config.php</code>.

Weitere Informationen zur Nutzung von Tiny Tiny RSS finden sich auf der Homepage des Projekts: https://tt-rss.org/

Tiny Tiny RSS Installieren

2017-08-30T12:53:18Z

Has00: /* Abschluss der Installation mit dem Installer von Tiny Tiny RSS */

Tiny Tiny RSS Installieren

2017-08-30T12:50:23Z

Has00: /* Abschluss der Installation mit dem Installer von Tiny Tiny RSS */

== Über Tiny Tiny RSS ==

Wikipedia schreibt: »Tiny Tiny RSS ist ein freier, webbasierter Feedreader. Die Anwendung ermöglicht das Abonnieren und Betrachten von Web-Feeds über einen Webbrowser. Zudem gibt es eine offizielle Android-App, es wird jedoch auch ein API für weitere Clients zur Verfügung gestellt. Es werden die Formate RSS und Atom unterstützt. Das Programm ruft abonnierte Web-Feeds serverseitig in regelmäßigen Abständen ab und speichert die gefunden Artikel in einer Datenbank. Somit verpasst der Benutzer keinen Artikel, auch wenn er den Feedreader über einen langen Zeitraum nicht aufruft. Auf einer Instanz von Tiny Tiny RSS können mehrere Benutzer unabhängig voneinander arbeiten. Neue Benutzer können eigenständig direkt über die Anwendung ein neues Benutzerkonto erstellen. Des Weiteren bietet die Software komplexe Filterregeln für Artikel und das Teilen/Veröffentlichen von Artikeln in Form eines benutzerspezifischen Web-Feeds.«

== Vorbereitung der Installation ==

Um Tiny Tiny RSS auf der Managed Operation Platform von Hostsharing zu installieren, ist entsprechend der Best-Practice-Vorgaben folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers

2. Anlegen einer Domain

3. Anlegen eines Datenbank-Benutzers

4. Anlegen einer Datenbank (Tiny Tiny RSS arbeitet mit MySQL und PostgreSQL zusammen. Wir empfehlen die Nutzung von PostgreSQL.)

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet ''hsadmin'' mit ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-ttrss',password:'geheim',comment:'Drupal CMS'}})
xyz00@hsadmin> domain.add({set:{name:'ttrss.hs-example.de',user:'xyz00-ttrss'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_ttrssuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_ttrssdb',owner:'xyz00_ttrssuser'}})

== Herunterladen des Quellcodes mit Hilfe von Git ==

Wir installieren Tiny Tiny RSS mit Hilfe von Git aus den Quellen.

$ ssh xyz00-ttrss@xyz00.hostsharing.net
$ git clone https://tt-rss.org/git/tt-rss.git tt-rss

== Hostsharing-Dateisystem einrichten ==

Nun müssen wir nur noch einige Änderungen im Dateisystem vornehmen.

Wir wechseln in die neu angelegte Domain.

$ cd $HOME/doms/ttrss.hs-example.com/

Dort löschen wir zunächst die Ordner für die Subdomain <code>www</code>.

$ rm -rf subs/www
$ rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein.

$ vim htdocs/.htaccess

Der Eintrag muss folgendermaßen lauten:

Redirect permanent / https://ttrss.hs-example.com/

Danach löschen wir den htdocs-ssl Ordner und legen einen symbolischen Link auf unsere Shaarli-Installation an.

$ rm -rf htdocs-ssl/
$ ln -s $HOME/tt-rss htdocs-ssl

== Abschluss der Installation mit dem Installer von Tiny Tiny RSS ==

Unter der URL <code>ttrss.hs-example.com/install/</code> können wir nun den Installer von Tiny Tiny RSS aufrufen, um die Installation zu beenden.

[[Datei:Tiny-tiny-rss-installer.png]]

Database type: Die jeweils benutzte Datenbank, MySQL oder PostgreSQL

Username: Der Datenbankbenutzer: "xyz00_ttrssuser"

Passwort: Gemeint ist das Passwort des Datenbankbenutzers: "geheim"

Database name: der Namen der Datenbank: "xyz00_ttrssdb"

Host name: <code>localhost</code>.

Port: die jeweils gültige Portnummer; 3306 für MySQL und 5432 für PostgreSQL.

Tiny Tiny RSS URL: Die URL der neuen Domain unter der wir Tiny Tiny RSS aufrufen wollen: https://ttrss.hs-example.com/

Anschließend testen wir die Konfiguration und speichern sie bei erfolgreichem Test.

Tiny Tiny RSS Installieren

2017-08-30T12:48:14Z

Has00:

== Über Tiny Tiny RSS ==

Wikipedia schreibt: »Tiny Tiny RSS ist ein freier, webbasierter Feedreader. Die Anwendung ermöglicht das Abonnieren und Betrachten von Web-Feeds über einen Webbrowser. Zudem gibt es eine offizielle Android-App, es wird jedoch auch ein API für weitere Clients zur Verfügung gestellt. Es werden die Formate RSS und Atom unterstützt. Das Programm ruft abonnierte Web-Feeds serverseitig in regelmäßigen Abständen ab und speichert die gefunden Artikel in einer Datenbank. Somit verpasst der Benutzer keinen Artikel, auch wenn er den Feedreader über einen langen Zeitraum nicht aufruft. Auf einer Instanz von Tiny Tiny RSS können mehrere Benutzer unabhängig voneinander arbeiten. Neue Benutzer können eigenständig direkt über die Anwendung ein neues Benutzerkonto erstellen. Des Weiteren bietet die Software komplexe Filterregeln für Artikel und das Teilen/Veröffentlichen von Artikeln in Form eines benutzerspezifischen Web-Feeds.«

== Vorbereitung der Installation ==

Um Tiny Tiny RSS auf der Managed Operation Platform von Hostsharing zu installieren, ist entsprechend der Best-Practice-Vorgaben folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers

2. Anlegen einer Domain

3. Anlegen eines Datenbank-Benutzers

4. Anlegen einer Datenbank (Tiny Tiny RSS arbeitet mit MySQL und PostgreSQL zusammen. Wir empfehlen die Nutzung von PostgreSQL.)

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet ''hsadmin'' mit ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-ttrss',password:'geheim',comment:'Drupal CMS'}})
xyz00@hsadmin> domain.add({set:{name:'ttrss.hs-example.de',user:'xyz00-ttrss'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_ttrssuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_ttrssdb',owner:'xyz00_ttrssuser'}})

== Herunterladen des Quellcodes mit Hilfe von Git ==

Wir installieren Tiny Tiny RSS mit Hilfe von Git aus den Quellen.

$ ssh xyz00-ttrss@xyz00.hostsharing.net
$ git clone https://tt-rss.org/git/tt-rss.git tt-rss

== Hostsharing-Dateisystem einrichten ==

Nun müssen wir nur noch einige Änderungen im Dateisystem vornehmen.

Wir wechseln in die neu angelegte Domain.

$ cd $HOME/doms/ttrss.hs-example.com/

Dort löschen wir zunächst die Ordner für die Subdomain <code>www</code>.

$ rm -rf subs/www
$ rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein.

$ vim htdocs/.htaccess

Der Eintrag muss folgendermaßen lauten:

Redirect permanent / https://ttrss.hs-example.com/

Danach löschen wir den htdocs-ssl Ordner und legen einen symbolischen Link auf unsere Shaarli-Installation an.

$ rm -rf htdocs-ssl/
$ ln -s $HOME/tt-rss htdocs-ssl

== Abschluss der Installation mit dem Installer von Tiny Tiny RSS ==

Unter der URL <code>ttrss.hs-example.com/install/</code> können wir nun den Installer von Tiny Tiny RSS aufrufen, um die Installation zu beenden.

[[Datei:Tiny-tiny-rss-installer.png]]

Unter Username tragen wir den Datenbankbenutzer ein: "xyz00_ttrssuser"

Unter Passwort das Passwort des Datenbankbenutzers: "geheim"

Unter Database name den Namen der Datenbank: "xyz00_ttrssdb"

Unter Host name tragen wir <code>localhost</code> ein.

Unter Port die jeweils gültige Portnummer. 3306 für MySQL und 5432 für PostgreSQL.

Und in das Feld Tiny Tiny RSS URL tragen wir die URL der neuen Domain ein: https://ttrss.hs-example.com/

Anschließend testen wir die Konfiguration und speichern sie bei erfolgreichem Test.

Datei:Tiny-tiny-rss-installer.png

2017-08-30T12:44:01Z

Has00: Has00 lud eine neue Version von Datei:Tiny-tiny-rss-installer.png hoch

Tiny Tiny RSS Installieren

2017-08-30T12:42:36Z

Has00: /* Abschluss der Installation mit dem Installer von Tiny Tiny RSS */

== Über Tiny Tiny RSS ==

Wikipedia schreibt: »Tiny Tiny RSS ist ein freier, webbasierter Feedreader. Die Anwendung ermöglicht das Abonnieren und Betrachten von Web-Feeds über einen Webbrowser. Zudem gibt es eine offizielle Android-App, es wird jedoch auch ein API für weitere Clients zur Verfügung gestellt. Es werden die Formate RSS und Atom unterstützt. Das Programm ruft abonnierte Web-Feeds serverseitig in regelmäßigen Abständen ab und speichert die gefunden Artikel in einer Datenbank. Somit verpasst der Benutzer keinen Artikel, auch wenn er den Feedreader über einen langen Zeitraum nicht aufruft. Auf einer Instanz von Tiny Tiny RSS können mehrere Benutzer unabhängig voneinander arbeiten. Neue Benutzer können eigenständig direkt über die Anwendung ein neues Benutzerkonto erstellen. Des Weiteren bietet die Software komplexe Filterregeln für Artikel und das Teilen/Veröffentlichen von Artikeln in Form eines benutzerspezifischen Web-Feeds.«

== Vorbereitung der Installation ==

Um Tiny Tiny RSS auf der Managed Operation Platform von Hostsharing zu installieren, ist entsprechend der Best-Practice-Vorgaben folgende Vorbereitung erforderlich.

1. Anlegen eines Domain-Benutzers

2. Anlegen einer Domain

3. Anlegen eines Datenbank-Benutzers

4. Anlegen einer Datenbank (Tiny Tiny RSS arbeitet mit MySQL und PostgreSQL zusammen. Wir empfehlen die Nutzung von PostgreSQL.)

Auf der Kommandozeile kann man dies folgendermaßen erledigen.

Man loggt sich als Paketbenutzer ein und startet ''hsadmin'' mit ''hsscript'':

hsscript -u xyz00 -i
Password: ********

Anschließend kann man die Vorbereitungsschritte 1 bis 4 erledigen:

xyz00@hsadmin> user.add({set:{name:'xyz00-ttrss',password:'geheim',comment:'Drupal CMS'}})
xyz00@hsadmin> domain.add({set:{name:'ttrss.hs-example.de',user:'xyz00-ttrss'}})
xyz00@hsadmin> postgresqluser.add({set:{name:'xyz00_ttrssuser',password:'geheim'}})
xyz00@hsadmin> postgresqldb.add({set:{name:'xyz00_ttrssdb',owner:'xyz00_ttrssuser'}})

== Herunterladen des Quellcodes mit Hilfe von Git ==

Wir installieren Tiny Tiny RSS mit Hilfe von Git aus den Quellen.

$ ssh xyz00-ttrss@xyz00.hostsharing.net
$ git clone https://tt-rss.org/git/tt-rss.git tt-rss

== Hostsharing-Dateisystem einrichten ==

Nun müssen wir nur noch einige Änderungen im Dateisystem vornehmen.

Wir wechseln in die neu angelegte Domain.

$ cd $HOME/doms/ttrss.hs-example.com/

Dort löschen wir zunächst die Ordner für die Subdomain <code>www</code>.

$ rm -rf subs/www
$ rm -rf subs-ssl/www

Anschließend tragen wir die Umleitung auf HTTPS ein.

$ vim htdocs/.htaccess

Der Eintrag muss folgendermaßen lauten:

Redirect permanent / https://ttrss.hs-example.com/

Danach löschen wir den htdocs-ssl Ordner und legen einen symbolischen Link auf unsere Shaarli-Installation an.

$ rm -rf htdocs-ssl/
$ ln -s $HOME/tt-rss htdocs-ssl

== Abschluss der Installation mit dem Installer von Tiny Tiny RSS ==

Unter der URL <code>ttrss.hs-example.com/install/</code> können wir nun den Installer von Tiny Tiny RSS aufrufen, um die Installation zu beenden.

[[Datei:Tiny-tiny-rss-installer.png]]

Unter Username tragen wir den Datenbankbenutzer ein.

Unter Passwort das Passwort des Datenbankbenutzers.

Unter Database name den Namen der Datenbank.

Unter Host name tragen wir <code>localhost</code> ein.

Unter Port die jeweils gültige Portnummer. 3306 für MySQL und 5432 für PostgreSQL.

Tiny Tiny RSS Installieren

2017-08-30T12:39:49Z

Has00: /* Abschluss der Installation mit dem Installer von Tiny Tiny RSS */

Datei:Tiny-tiny-rss-installer.png

2017-08-30T12:39:25Z

Has00:

Tiny Tiny RSS Installieren

2017-08-30T12:37:56Z

Has00: /* Abschluss der Installation mit dem Installer von Tiny Tiny RSS */

Tiny Tiny RSS Installieren

2017-08-30T12:36:32Z

Has00:

Tiny Tiny RSS Installieren

2017-08-30T12:34:57Z

Has00: /* Installation mit Hilfe von Git */

Tiny Tiny RSS Installieren

2017-08-30T12:27:09Z

Has00: