alt:V Server erstellen: Schnellstart-Anleitung 2026

⚠️ Wichtig (März 2026): alt:V wird am 6. Juli 2026 endgültig abgeschaltet, nachdem Rockstar Games eine Unterlassungsaufforderung ausgesprochen hat. Neue Server können nicht mehr erstellt werden. Wir empfehlen FiveM als Alternative für GTA V Multiplayer-Server. Die folgende Anleitung bleibt als Archiv verfügbar, ist aber nicht mehr praktisch nutzbar.

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!

---

Verwandte Artikel

• FiveM Server Backup erstellen: Vollständige Anleitung
• FiveM Server erstellen 2026 — Vollständige Einrichtungsanleitung
• FiveM Server Trailer erstellen
• FivePD Server erstellen
• RageMP Server erstellen: Schritt-für-Schritt-Anleitung

Entdecke unsere Premium FiveM Mods und die kostenlose Mods-Sammlung für sofort einsetzbare Ressourcen.

Erweiterte Konfiguration: server.toml im Detail

Die server.toml Datei ist das Herzstück deiner alt:V Serverkonfiguration. Hier eine detailliertere Aufschlüsselung der einzelnen Optionen und deren Auswirkungen:

# Serverinformationen
name = "Mein alt:V Server"             # Öffentlich angezeigter Name
description = "Willkommen!"          # Serverbeschreibung (optional)
gamemode = "Freeroam"          # Spielmodus (optional)
website = "https://example.com"        # Webseite (optional)

# Netzwerk
host = "0.0.0.0"                     # IP-Adresse, an die der Server bindet (0.0.0.0 = alle)
port = 7788                          # Standard-Spielport (TCP & UDP)
players = 128                        # Maximale Spieleranzahl
password = ""                      # Serverpasswort (optional)
announce = true                      # In der Masterliste anzeigen?
token = "DEIN_MASTERLISTEN_TOKEN"      # Token vom alt:V Dashboard (für öffentliche Server)

# Ressourcen und Module
modules = ["js-module"]                # Geladene Module
resources = ["example"]                # Geladene Ressourcen
streamingDistance = 500                # Streaming Distanz

# Servereinstellungen
tickRate = 30                        # Server-Tickrate (Standard: 30)
migrationDistanceLimit = 200          # Distanzlimit für Charakter Migration (optional)
useCdn = false                       # CDN für Ressourcendownloads verwenden? (empfohlen für große Ressourcen)

# Debugging und Logging
debug = true                         # Debug-Modus aktivieren?
logStreams = ["console", "file"]      # Log-Ausgabe (Konsole, Datei oder beides)


# Zusätzliche Optionen (Beispiele)
# tags = ["deutsch", "roleplay", "community"] # Server-Tags für die Masterliste
# timezone = "Europe/Berlin"        # Zeitzone des Servers

Expertenanalyse:

• streamingDistance: Dieser Wert bestimmt, wie weit Objekte und Entities für Spieler sichtbar sind. Ein höherer Wert erhöht die Last auf den Server und die Clients. Experimentiere, um ein gutes Gleichgewicht zwischen Sichtweite und Performance zu finden.
• tickRate: Bestimmt, wie oft der Server pro Sekunde aktualisiert wird. Ein höherer Wert kann die Reaktionsfähigkeit verbessern, erhöht aber auch die CPU-Last. 30 ist ein guter Ausgangspunkt.
• useCdn: Wenn dein Server große Ressourcen (z.B. viele Custom-Fahrzeuge, Karten) verwendet, ist die Aktivierung von useCdn und die Bereitstellung der Ressourcen über ein Content Delivery Network (CDN) dringend empfohlen. Dies entlastet den Server und beschleunigt die Downloadzeiten für die Spieler. Die Vorbereitung hierfür ist etwas aufwändiger (siehe Abschnitt "CDN-Integration").
• tags: Hilfreich, um Deinen Server in der Masterliste besser auffindbar zu machen.

Actionable Takeaways:

• Passe die server.toml Datei an deine spezifischen Bedürfnisse an. Experimentiere mit den Optionen, um die Performance und das Spielerlebnis zu optimieren.
• Achte besonders auf die streamingDistance und tickRate Werte. Diese haben einen direkten Einfluss auf die Server-Performance.

CDN-Integration (Content Delivery Network)

Wenn dein Server viele große Custom-Assets verwendet, kann die Auslieferung über ein CDN die Downloadzeiten für Spieler drastisch verbessern und die Server-Performance entlasten. Hier eine Schritt-für-Schritt-Anleitung zur Integration eines CDNs:

1. CDN-Anbieter wählen: Cloudflare, Amazon CloudFront, BunnyCDN sind beliebte Optionen.

2. CDN einrichten: Folge den Anweisungen deines CDN-Anbieters, um ein CDN für deinen Server einzurichten. Du benötigst in der Regel einen "Origin Server", der deine Ressourcen hostet. Dies kann dein alt:V Server selbst sein (wenn er genügend Bandbreite hat) oder ein separater Webserver.

3. Ressourcen packen: Verwende das altv-pkg Tool mit dem --justpack Flag, um deine Ressourcen für die CDN-Auslieferung vorzubereiten:

   npx altv-pkg --justpack
   

   Dies erstellt .tar.gz Archive deiner Ressourcen.

4. Archive hochladen: Lade die .tar.gz Archive in deinen CDN-Speicher hoch. Stelle sicher, dass die Dateien öffentlich zugänglich sind (lesbar für jedermann).

5. CDN-URL konfigurieren: In deiner server.toml Datei musst du die cdnUrl Option setzen. Diese URL muss auf das Verzeichnis verweisen, in dem deine .tar.gz Archive im CDN gespeichert sind. Zum Beispiel:

   cdnUrl = "https://dein-cdn.example.com/altv-ressourcen/"
   useCdn = true
   

Wichtig: Stelle sicher, dass dein CDN korrekt konfiguriert ist und die Ressourcen über HTTPS ausgeliefert werden. Teste die CDN-URL in deinem Browser, um sicherzustellen, dass du auf die Dateien zugreifen kannst.

Community Perspective:

Viele Serverbetreiber, die auf CDNs umgestiegen sind, berichten von deutlich kürzeren Downloadzeiten für die Spieler und einer geringeren Serverlast. Die anfängliche Einrichtung ist zwar etwas aufwändiger, aber der langfristige Nutzen überwiegt.

Erweiterte Ressourcen-Entwicklung mit TypeScript

Für größere Ressourcenprojekte ist die Verwendung von TypeScript sehr empfehlenswert. TypeScript bietet Typensicherheit, Code-Vervollständigung und andere Vorteile, die die Entwicklung und Wartung erleichtern.

1. TypeScript installieren:

   npm install -D typescript @altv/types-server @altv/types-client
   

2. tsconfig.json erstellen: Erstelle eine tsconfig.json Datei in deinem Ressourcenverzeichnis (z.B. resources/example/tsconfig.json). Hier ein Beispiel:

   {
     "compilerOptions": {
       "target": "esnext",
       "module": "esnext",
       "moduleResolution": "node",
       "esModuleInterop": true,
       "forceConsistentCasingInFileNames": true,
       "strict": true,
       "outDir": "dist"
     },
     "include": ["./src/**/*"]
   }
   

3. Quellcode in src/ erstellen: Erstelle deinen TypeScript-Quellcode im src/ Verzeichnis. Zum Beispiel: resources/example/src/server.ts und resources/example/src/client/client.ts.

4. Kompilieren: Kompiliere deinen TypeScript-Code mit dem tsc Befehl:

   npx tsc
   

   Dies erstellt die JavaScript-Dateien im dist/ Verzeichnis.

5. resource.toml anpassen: Passe deine resource.toml Datei an, um auf die kompilierten JavaScript-Dateien zu verweisen:

   main = "dist/server.js"
   client-main = "dist/client/client.js"
   client-files = [
     "dist/client/*",
   ]
   

Vorteile von TypeScript:

• Typensicherheit: Verhindert viele Laufzeitfehler durch statische Typüberprüfung.
• Code-Vervollständigung: IDEs bieten bessere Code-Vervollständigung und Navigation.
• Refactoring: Erleichtert das Refactoring von Code.
• Bessere Wartbarkeit: TypeScript-Code ist leichter zu verstehen und zu warten als reiner JavaScript-Code.

Zukunftsausblick:

Die Verwendung von TypeScript wird in der alt:V Community immer beliebter. Viele fortgeschrittene Projekte setzen bereits auf TypeScript, um die Codequalität und Wartbarkeit zu verbessern.

Überwachung und Wartung

Ein stabiler Serverbetrieb erfordert regelmäßige Überwachung und Wartung.

• Server-Logs: Überprüfe regelmäßig die Server-Logs auf Fehlermeldungen oder Warnungen.
• Ressourcen-Monitoring: Überwache die CPU- und Speicherauslastung deiner Ressourcen. Optimierung ist wichtig, um Performance-Probleme zu vermeiden.
• Updates: Halte deine Server-Binärdateien und Ressourcen auf dem neuesten Stand. Beachte die Changelogs, um mögliche Inkompatibilitäten zu vermeiden.
• Sicherheitsupdates: Achte auf Sicherheitsupdates für dein Betriebssystem und deine Software.
• Backups: Erstelle regelmäßig Backups deiner Serverdateien (Ressourcen, Konfigurationen, Datenbanken).

Datenbasierte Einblicke:

Server, die regelmäßig gewartet und überwacht werden, haben tendenziell eine höhere Verfügbarkeit und weniger Performance-Probleme. Die Investition in Überwachungstools und automatisierte Wartungsprozesse zahlt sich langfristig aus.