Artemis

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Artemis ist eine an der TU München entwickelte Lernplattform für Kurse, Aufgaben und Prüfungen.

Diese Anleitung richtet auf Ubuntu 26.04 LTS (amd64) eine eigene lokale Testinstanz direkt auf dem Rechner ein. Wenn du lediglich an einem TUM-Kurs teilnehmen möchtest, öffne stattdessen die Artemis-Instanz der TUM im Browser und verwende deinen Hochschulzugang.

Umfang und Voraussetzungen

Die Testinstanz verwendet PostgreSQL und ist nur vom eigenen Rechner erreichbar. Sie ist unabhängig von den Kursen und Benutzerkonten der TUM. Internetzugang ist für die Downloads erforderlich. Plane für den Quellcode, die Abhängigkeiten und den Build mehrere GB freien Speicher ein; für den Build sind 16 GB RAM eine sinnvolle Planungsgröße.

Grenze des Aufbaus: Die integrierte automatische Ausführung von Programmierabgaben benötigt Build-Agenten mit Container-Laufzeit. Diese Anleitung lässt deshalb die Profile localci, localvc und buildagent weg. Für Kurse mit automatisch getesteten Programmieraufgaben reicht dieser Aufbau nicht aus. Siehe die offizielle Beschreibung der Build-Infrastruktur.

Verwendet wird der Entwicklungszweig develop. Er verändert sich laufend; dies ist keine Anleitung für einen öffentlichen Hochschulserver. Die folgenden Build-Einstellungen wurden anhand des offiziellen Build-Skripts geprüft: Java 25 sowie ein projektverwalteter Download von Node.js und pnpm. Ein separates systemweites Gradle, Node.js oder pnpm ist für diesen Weg nicht nötig.

System vorbereiten

1. Paketlisten aktualisieren

Damit Ubuntu die verfügbaren Paketversionen kennt.

sudo apt update

2. Voraussetzungen installieren

Java übersetzt und startet Artemis. PostgreSQL speichert die Daten; Git lädt den Quellcode. Die übrigen Werkzeuge dienen dem Build, der Konfiguration und den Prüfungen.

sudo apt install openjdk-25-jdk postgresql postgresql-client git curl ca-certificates build-essential graphviz nano openssl

3. Java für dieses Terminal auswählen

Die feste Auswahl verhindert, dass ein anderes installiertes JDK für den Build verwendet wird. Wiederhole diesen Schritt in einem neuen Terminal vor dem Artemis-Start.

export JAVA_HOME=/usr/lib/jvm/java-25-openjdk-amd64

4. Java in den Suchpfad aufnehmen

Damit auch der direkte Aufruf von java die ausgewählte Version verwendet.

export PATH="$JAVA_HOME/bin:$PATH"

Prüfen: Die Ausgabe muss Java 25 nennen.

java -version

5. PostgreSQL starten

Aktiviert den Datenbankdienst auch für spätere Rechnerstarts.

sudo systemctl enable --now postgresql

Prüfen: Der Server muss Verbindungen annehmen.

pg_isready -h 127.0.0.1 -p 5432

Eigene Datenbank einrichten

6. Datenbankbenutzer anlegen

Der Benutzer erhält keine Administratorrechte. Gib auf Nachfrage ein eigenes Datenbankpasswort ein und bewahre es für Schritt 12 auf. Die Namen artemis_local werden ausschließlich für diese Testinstanz verwendet.

sudo -u postgres createuser --pwprompt artemis_local

7. Datenbank anlegen

Die separate Datenbank gehört dem neuen Benutzer. Artemis legt seine Tabellen später selbst an.

sudo -u postgres createdb --owner=artemis_local --encoding=UTF8 artemis_local

Prüfen: Gib das soeben gewählte Passwort ein. Die Ausgabe soll den Benutzer und die Datenbank artemis_local zeigen. Falls PostgreSQL bereits vor dieser Anleitung eingerichtet war, muss seine Zugriffskonfiguration lokale TCP-Verbindungen mit Passwort erlauben.

psql -h 127.0.0.1 -U artemis_local -d artemis_local -W -c 'SELECT current_user, current_database();'

Artemis herunterladen und konfigurieren

8. Ins Home-Verzeichnis wechseln

Der Quellcode wird im eigenen Benutzerkonto gespeichert; Artemis wird ohne sudo gebaut und gestartet.

cd ~

9. Quellcode laden

Lädt den Entwicklungszweig ohne die vollständige Änderungshistorie. Der Zielordner darf noch nicht existieren.

git clone --depth 1 --branch develop https://github.com/ls1intum/Artemis.git artemis-tum

10. In den Projektordner wechseln

Alle nachfolgenden Build-Befehle werden hier ausgeführt.

cd ~/artemis-tum

Prüfen: Notiere diese Kennung, damit du später weißt, welchen Quellstand du eingerichtet hast. Bei einem späteren Download können sich die Voraussetzungen ändern.

git rev-parse HEAD

11. Anmeldeschlüssel erzeugen

Der zufällige Schlüssel dient zur Signierung der Anmeldetokens. Kopiere die ausgegebene Zeile für die Konfiguration.

openssl rand -base64 64 | tr -d '\n'; echo

12. Lokale Konfiguration anlegen

Öffnet die Datei für die Einstellungen dieser Instanz. Die Kombination aus PostgreSQL und dem Profil local wird im offiziellen Setup-Handbuch beschrieben.

nano src/main/resources/config/application-local.yml

Trage den folgenden Inhalt ein. Ersetze die drei Platzhalter durch dein Datenbankpasswort, ein eigenes Adminpasswort und den Schlüssel aus Schritt 11. Verwende bei Passwörtern innerhalb einfacher YAML-Anführungszeichen für ein enthaltenes ' jeweils ''. Die Adminadresse ist für diesen lokalen Versuch ein Platzhalter; Mailversand wird hier nicht eingerichtet.

server:
    address: 127.0.0.1
    port: 8080
    url: http://localhost:8080

spring:
    datasource:
        url: jdbc:postgresql://127.0.0.1:5432/artemis_local
        username: artemis_local
        password: 'DATENBANKPASSWORT_ERSETZEN'
    jpa:
        database: POSTGRESQL

jhipster:
    security:
        authentication:
            jwt:
                base64-secret: 'SCHLUESSEL_ERSETZEN'

artemis:
    user-management:
        use-external: false
        internal-admin:
            username: lokaladmin
            password: 'ADMINPASSWORT_ERSETZEN'
            email: admin@localhost

Speichere mit Strg+O, bestätige mit Enter und schließe nano mit Strg+X. Die Admin-Einstellungen entsprechen den Schlüsseln der Artemis-Konfiguration.

13. Konfigurationsdatei schützen

Nur dein Benutzerkonto soll die Datei mit den Zugangsdaten lesen und ändern können.

chmod 600 src/main/resources/config/application-local.yml

Starten und prüfen

14. Artemis starten

Der Gradle Wrapper lädt die benötigten Build-Werkzeuge und Bibliotheken, baut die Weboberfläche und startet den Server. Der erste Aufruf kann erheblich dauern. Das Terminal bleibt während des Betriebs belegt. Die Einbindung des Frontend-Builds ist im Gradle-Entwicklungsprofil hinterlegt.

./gradlew bootRun --args='--spring.profiles.active=dev,artemis,scheduling,core,local'

Prüfen: Warte auf die Meldung, dass ArtemisApp gestartet wurde. Bei Connection refused prüfe PostgreSQL; bei einem Authentifizierungsfehler prüfe das Datenbankpasswort. Falls Port 8080 belegt ist, beende den dort laufenden eigenen Dienst oder wähle in der Konfiguration einen anderen Port und passe die folgenden Adressen an.

15. HTTP-Antwort prüfen

Öffne ein zweites Terminal. Eine Antwort mit HTTP-Status 200 zeigt, dass die Startseite ausgeliefert wird.

curl --fail --output /dev/null --write-out '%{http_code}\n' http://localhost:8080/

16. Im Browser anmelden

Öffne die lokale Adresse und melde dich mit lokaladmin und deinem Adminpasswort an. Prüfe, ob die Verwaltungsfunktionen erreichbar sind.

http://localhost:8080

17. Artemis beenden

Drücke im Serverterminal Strg+C. Die Daten bleiben in PostgreSQL und im Projektordner erhalten. Zum erneuten Start wiederholst du die Schritte 3, 4, 10 und 14.

Für einen öffentlichen Betrieb sind weitere Arbeiten nötig, unter anderem TLS, Backups, Mailversand und eine Produktionskonfiguration. Der lokale Entwicklungsaufbau ist dafür kein fertiger Ersatz. Ausgangspunkt ist das offizielle Administratorhandbuch.

Deinstallieren

Die folgenden Schritte löschen die Daten dieser Testinstanz unwiderruflich. Sichere benötigte Kurse, Uploads und eigene Quellcodeänderungen vorher.

1. Server beenden

Drücke im Serverterminal Strg+C, damit Artemis nicht mehr auf die Datenbank zugreift.

2. Datenbank löschen

Entfernt alle in dieser Testinstanz gespeicherten Datenbankinhalte.

sudo -u postgres dropdb artemis_local

3. Datenbankbenutzer löschen

Entfernt das ausschließlich für diese Instanz angelegte Datenbankkonto.

sudo -u postgres dropuser artemis_local

4. Projektordner löschen

Entfernt Quellcode, Konfiguration, Build-Dateien und dort abgelegte Artemis-Dateien. Gemeinsame Gradle-Caches im Home-Verzeichnis bleiben für andere Projekte erhalten.

rm -rf -- ~/artemis-tum

Prüfen: Die Ausgabe soll entfernt lauten.

test ! -e ~/artemis-tum && echo entfernt

5. Optional: Java-Entwicklungspaket entfernen

Führe dies nur aus, wenn du das Paket für kein anderes Projekt benötigst. PostgreSQL und die Hilfsprogramme bleiben installiert, damit bestehende Datenbanken und andere Anwendungen erhalten bleiben.

sudo apt remove openjdk-25-jdk

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Autor: Thorsten · Installationsanleitungen für Ubuntu

Alle Anleitungen ohne Gewähr. Befehle mit sudo verändern das System – vorher lesen, dann ausführen.