alt:V Server erstellen: Schnellstart-Anleitung 2026

Einführung

Wichtiger Hinweis (März 2026): alt:V hat eine Abschaltung zum 6. Juli 2026 angekündigt, nachdem Rockstar eine Unterlassungsaufforderung ausgesprochen hat. Die Erstellung neuer Server ist bereits deaktiviert. Wenn du einen GTA V Multiplayer-Server starten möchtest, verwende stattdessen FiveM. Lies dazu unseren alt:V-Shutdown-Guide und die FiveM-Migrations-Anleitung oder starte mit dem FiveM-Server-Management-Guide.

Möchtest du deine eigene GTA V Multiplayer-Welt mit alt:V hosten? Dieser Leitfaden zeigt dir zwei zuverlässige Setup-Wege (Windows & Linux), gibt dir eine saubere server.toml, eine erste funktionierende JavaScript-Ressource, Firewall/Ports und einen optionalen systemd-Dienst – damit du schnell von null bis zu einem öffentlichen, gemasterlisteten Server kommst.

---

Was du brauchst

• Eine legitime Kopie von GTA V (Spieler brauchen diese; der Server nicht).
• Windows 10/11 oder Ubuntu 22.04+ (oder ein aktuelles x64-Linux).
• Grundlegende Terminal-/PowerShell-Kenntnisse.

alt:V-Server sind eigenständig; du musst GTA nicht auf dem Server installieren.

---

Ordnerstruktur (die wir anlegen werden)

altv-server/
├─ altv-server.exe (Windows) oder altv-server (Linux)
├─ libnode.dll / libnode.so
├─ server.toml
├─ package.json  ← setzt ESM (type: module) für JS-Ressourcen
└─ resources/
   └─ example/
      ├─ resource.toml
      ├─ server.mjs
      └─ client/
         └─ client.mjs

---

alt:V Server-Dateien herunterladen

Option A — Schnellstart (Windows & Linux) mit altv-pkg

Damit werden die neuesten offiziellen Binärdateien automatisch heruntergeladen.

1. Arbeitsverzeichnis erstellen

mkdir altv-server && cd altv-server

2. Node initialisieren (nur für Tooling)

npm init -y
npm i --save-dev altv-pkg

3. Server-Binärdateien herunterladen

npx altv-pkg release

Zum Aktualisieren einfach npx altv-pkg release erneut ausführen.

---

Option B — Manuelle Installation

1. Den Server-Build von der offiziellen alt:V-Downloads-Seite herunterladen (Windows oder Linux wählen).
2. In altv-server/ entpacken.

---

package.json erstellen (oberste Ebene)

Dies aktiviert die ESM-Syntax (import ...) für deine JS-Ressourcen.

{
  "name": "altv-server",
  "private": true,
  "type": "module"
}

---

Minimale server.toml

server.toml im Server-Root erstellen:

# Angezeigter Name im alt:V-Client
name = "Mein alt:V Server"
# An alle Interfaces binden
host = "0.0.0.0"
# Standard-Spielport (TCP & UDP)
port = 7788
# Spieler-Slots
players = 128
# In der Masterliste anzeigen? (true für öffentlich)
announce = true
# Token vom alt:V-Dashboard holen und hier einfügen, wenn öffentlich
# token = "DEIN_MASTERLISTEN_TOKEN"

# JS-Modul und Beispiel-Ressource laden
modules = ["js-module"]
resources = ["example"]

# Hilfreich in der Entwicklung
debug = true
logStreams = ["console", "file"]

Tipp: Ports bei externem Voice sind typischerweise 7798 (Server) und 7799 (Client); nur öffnen, wenn du den Voice-Server separat betreibst. Das grundlegende In-Process-Voice benötigt nur deinen Spielport.

---

Deine erste Ressource (JavaScript)

resources/example/resource.toml erstellen:

# Server-seitige Sprache für diese Ressource
type = "js"
# Client-seitige Sprache für diese Ressource
client-type = "js"

# Einstiegspunkte
main = "server.mjs"
client-main = "client/client.mjs"

# Dateien, die der Client herunterladen darf
client-files = [
  "client/*",
]

resources/example/server.mjs

import * as alt from 'alt-server';

alt.on('playerConnect', (player) => {
  alt.log(`+ ${player.name} verbunden`);
  player.emit('welcome:notify', `Willkommen auf ${alt.getServerConfig().name}!`);
});

alt.on('playerDisconnect', (player, reason) => {
  alt.log(`- ${player?.name ?? 'unbekannt'} hat den Server verlassen (${reason})`);
});

resources/example/client/client.mjs

import * as alt from 'alt-client';

alt.onServer('welcome:notify', (msg) => {
  alt.log(`Server meldet: ${msg}`);
  // Einfacher On-Screen-Hilfetext
  alt.everyTick(() => {
    alt.drawText2d(msg, 0.5, 0.9, 0.5, 255, 255, 255, 255, 0, true, true, 0);
  });
  // Nach ~8 Sekunden entfernen
  alt.setTimeout(() => alt.clearEveryTick(), 8000);
});

Das ist eine vollständige Ressource. Wenn ein Spieler verbindet, erhält er einen Willkommenstext.

---

Server starten

Windows (PowerShell)

cd C:\pfad\zu\altv-server
./altv-server.exe

Linux

cd /opt/altv-server   # oder dein Pfad
chmod +x altv-server
./altv-server

Wenn der Start sauber ist, siehst du Logs und der Server ist unter deine.ip:7788 erreichbar. Über den alt:V-Client verbinden (Direkt-Verbinden) oder aus der Masterliste (wenn announce = true und ein gültiger token gesetzt ist).

---

Firewall öffnen

Windows (PowerShell, als Admin ausführen)

New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direction Inbound -Protocol TCP -LocalPort 7788 -Action Allow
New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direction Inbound -Protocol UDP -LocalPort 7788 -Action Allow

Linux (UFW)

sudo ufw allow 7788/tcp
sudo ufw allow 7788/udp

Bei Verwendung eines externen Voice-Servers auch 7798/udp und 7799/udp öffnen.

---

(Optional) alt:V als Dienst auf Linux einrichten

/etc/systemd/system/altv.service erstellen:

[Unit]
Description=alt:V Server
After=network.target

[Service]
User=altv
WorkingDirectory=/opt/altv-server
ExecStart=/opt/altv-server/altv-server --port 7788
Restart=on-failure

[Install]
WantedBy=multi-user.target

Aktivieren und starten:

sudo systemctl daemon-reload
sudo systemctl enable --now altv
journalctl -u altv -f

---

Entwicklungskomfort

• Debug-Modus: debug = true während der Entwicklung behalten; für die Produktion deaktivieren.
• Node Inspector (Server JS): Diese Zeile zu resources/example/resource.toml hinzufügen, wenn serverseitiges Debugging benötigt wird: [js-module] inspector = true Dann Chrome DevTools → Node-Ziel verbinden.
• TypeScript: Eine tsconfig.json hinzufügen, nach dist/ kompilieren und main/client-main auf die kompilierten Dateien zeigen lassen. Typen installieren: npm i -D @altv/types-server @altv/types-client.

---

Aktualisieren & Backups

• Binärdateien aktualisieren: npx altv-pkg release erneut ausführen (Option A) oder die ZIP-Datei neu herunterladen (Option B).
• Backups: resources/, server.toml und alle Datenbank-/externen Konfigurationen zippen. Mit einem Cron-Job oder einer geplanten Aufgabe automatisieren.

---

Produktions-Hardening Checkliste

• Starken token setzen und announce = true für die Masterliste.
• debug = false in der Produktion.
• logStreams = ["file"] in der Produktion verwenden und Logs extern rotieren.
• Nur benötigte Ports öffnen (7788; 7798/7799 bei externem Voice).
• useCdn = true für große Downloads in Betracht ziehen; Pakete mit --justpack generieren und über HTTPS bereitstellen.
• Mit einem Watchdog (systemd Restart=on-failure) überwachen und Alerts einrichten.

---

Fehlerbehebung (schnelle Lösungen)

• Server nicht in der Liste: announce = true, gültiger token, 7788 TCP/UDP auf Host und Router/NAT offen prüfen; einige Minuten auf Propagierung warten.
• Clients stecken beim Download: Bei großen Assets useCdn = true und Packaging (--justpack) in Betracht ziehen.
• Ports bereits in Verwendung: Einen anderen port in server.toml wählen oder den konfliktierenden Dienst stoppen.
• Nichts passiert bei Verbindung: Ressourcennamen prüfen, ob sie mit resources = ["example"] übereinstimmen und dein Ordner unter resources/example liegt.

---

FAQ – alt:V Server

Muss GTA V auf dem Server-Rechner installiert sein? Nein. Nur Spieler brauchen eine legitime GTA V Kopie. Der Server selbst läuft ohne das Spiel.

Welche Betriebssysteme werden für das Hosting von alt:V unterstützt? Windows 10/11 und moderne Linux-Distributionen (Ubuntu 22.04+ oder aktuelles x64-Linux) werden unterstützt.

Welche Ports müssen für alt:V geöffnet sein? Standardmäßig muss TCP/UDP-Port 7788 offen sein. Bei einem externen Voice-Server auch 7798/UDP und 7799/UDP öffnen.

Warum erscheint mein Server nicht in der Masterliste? Sicherstellen, dass announce = true gesetzt, ein gültiger Masterlisten-Token hinterlegt und 7788 TCP/UDP durch Firewall und Router freigegeben ist. Es kann einige Minuten dauern, bis das Listing propagiert wird.

Wie aktualisiere ich die Server-Binärdateien? Bei Installation über altv-pkg einfach ausführen:

npx altv-pkg release

Bei manueller Installation den neuesten Build von der offiziellen alt:V Download-Seite herunterladen.

Kann ich den Server als Hintergrunddienst betreiben? Ja. Auf Linux kann ein systemd-Dienst (altv.service) eingerichtet werden, der automatisch startet und bei Fehler neu startet.

Wie mache ich meinen Server für die Produktion sicherer?

• debug-Modus deaktivieren.
• logStreams = ["file"] setzen.
• Einen starken Masterlisten-Token verwenden.
• Nur benötigte Ports öffnen.
• Backups für Ressourcen und Konfigurationen automatisieren.

Wo finde ich weitere Ressourcen für meinen Server? Der offizielle alt:V Hub und Community-GitHub-Repositories enthalten viele Beispiel-Ressourcen. Auf FiveMX gibt es auch Guides zu Optimierung und Server-Wachstum.

---

Wie geht es weiter?

• Mehr Ressourcen aus dem Community Hub und Beispiel-Repositories hinzufügen.
• Einen Voice-Server extern für große Populations einrichten.
• CI/CD automatisieren, um Updates auf deine Box zu pushen.

Empfohlene Lesestücke (auf FiveMX)

• Frameworks vergleichen: FiveM vs RAGE:MP vs alt:V — Welches soll ich wählen?
• Community aufbauen: So wirbst du für deinen Server
• Heimatbasis aufbauen: Wie du eine Community für deinen FiveM-Server aufbaust
• Tuning-Tipps: FiveM-Server beschleunigen

---

Schnell-Referenz (Copy-Paste)

Windows starten:

./altv-server.exe

Linux starten:

./altv-server

Ports öffnen (Windows):

New-NetFirewallRule -DisplayName "altV 7788 TCP" -Direction Inbound -Protocol TCP -LocalPort 7788 -Action Allow
New-NetFirewallRule -DisplayName "altV 7788 UDP" -Direction Inbound -Protocol UDP -LocalPort 7788 -Action Allow

Ports öffnen (Linux):

sudo ufw allow 7788/tcp && sudo ufw allow 7788/udp

Fertig. Server starten, über den alt:V-Client verbinden und Ressourcen entwickeln!