Installer un serveur alt:V de zéro (Windows et Linux)

Vous voulez héberger votre serveur alt:V sur GTA V multijoueur ? Ce guide vous accompagne pas à pas pour télécharger, configurer et démarrer un serveur alt:V from scratch — sur Windows comme sur Linux. Toutes les commandes, fichiers et chemins sont vérifiés contre la documentation officielle alt:V.

Pas envie de gérer l’auto-update et le firewall ? Louez un serveur alt:V chez HebergTonServ — installation auto, panel intuitif et support 24/7 dès 1,90€/mois.

alt:V vs FiveM : différences clés

alt:V est plus performant mais l’écosystème de ressources est plus petit que FiveM.

Pré-requis matériels

alt:V publie des binaires natifs Windows et Linux. Pas de Wine.

Étape 1 — Télécharger altv-server

alt:V utilise un outil de téléchargement officiel appelé altv-server downloader. Il télécharge le serveur et ses modules selon la branche choisie.

Branches disponibles

Windows

1. Créez un dossier C:\altv-server\
2. Téléchargez altv-server.exe (downloader) depuis https://altv.mp/#/downloads
3. Placez-le dans C:\altv-server\
4. Ouvrez PowerShell dans ce dossier :

cd C:\altv-server
.\altv-server.exe

Au premier lancement, le downloader télécharge automatiquement les fichiers serveur et crée la structure.

Linux (Ubuntu 22.04+)

mkdir ~/altv-server && cd ~/altv-server

# Télécharger le binaire serveur Linux
wget https://cdn.alt-mp.com/server/release/x64_linux/altv-server

chmod +x altv-server

# Premier lancement (auto-download des modules)
./altv-server

Sur Ubuntu 22.04+, alt:V nécessite libatomic1 et libssl3. Installez-les avec sudo apt install libatomic1 libssl3 -y.

Étape 2 — Structure des fichiers générés

Après le premier lancement, voici la structure :

altv-server/
├── altv-server.exe (Windows) / altv-server (Linux)
├── libnode.dll / libnode.so          ← module JavaScript
├── server.toml                       ← config principale
├── data/
│   └── (assets serveur)
├── modules/
│   ├── js-module.dll / .so
│   └── csharp-module.dll / .so       (si activé)
├── resources/                        ← vos ressources
└── logs/

Étape 3 — Configurer server.toml

Le fichier server.toml est le cœur de la config. Ouvrez-le avec Notepad++ :

name = 'Mon Serveur alt:V FR'
host = '0.0.0.0'
port = 7788
players = 128
password = ''
announce = true
token = ''
gamemode = 'Freeroam'
website = 'https://example.com'
language = 'fr'
description = 'Serveur alt:V Roleplay'
debug = false
streamingDistance = 400

modules = [
  'js-module',
]

resources = [
  'my-first-resource',
]

[tags]
gamemode = 'Roleplay'
language = 'French'
version = '1.0'

Détails des paramètres

Étape 4 — Ouvrir les ports réseau

alt:V utilise par défaut le port 7788 :

Windows — règles firewall via PowerShell

Ouvrez PowerShell en administrateur :

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

Linux — UFW

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

Routeur / Box Internet

Forwardez TCP+UDP 7788 vers l’IP locale de la machine serveur.

Étape 5 — Créer une première ressource (Hello World)

Une ressource alt:V minimale en JavaScript :

Structure

resources/
└── my-first-resource/
    ├── resource.toml
    └── server.js

resource.toml

type = 'js'
main = 'server.js'
client-files = []
client-main = ''
deps = []

server.js

import * as alt from 'alt-server';

alt.log('Hello from my first alt:V resource!');

alt.on('playerConnect', (player) => {
    alt.log(`${player.name} a rejoint le serveur`);
    player.spawn(0, 0, 72);
    player.model = 'mp_m_freemode_01';
});

alt.on('playerDisconnect', (player, reason) => {
    alt.log(`${player.name} a quitté: ${reason}`);
});

Ajoutez my-first-resource dans le tableau resources de server.toml.

Étape 6 — Premier démarrage

Windows

cd C:\altv-server
.\altv-server.exe

Logs attendus :

[INFO] Server starting on port 7788
[INFO] Loaded module: js-module
[INFO] Loaded resource: my-first-resource
[INFO] Server started!

Linux

cd ~/altv-server
./altv-server

Pour tourner en arrière-plan, utilisez screen, tmux ou un service systemd :

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

[Service]
Type=simple
User=altv
WorkingDirectory=/home/altv/altv-server
ExecStart=/home/altv/altv-server/altv-server
Restart=on-failure

[Install]
WantedBy=multi-user.target

Étape 7 — Rejoindre votre serveur

1. Téléchargez et installez le client alt:V : https://altv.mp
2. Lancez le launcher alt:V
3. Onglet Connect to server → entrez IP:7788
4. Le client télécharge les ressources et vous connecte

Tester en local : utilisez 127.0.0.1:7788.

Étape 8 — Activer C# (optionnel)

Pour scripter en C#, ajoutez le module dans server.toml :

modules = [
  'js-module',
  'csharp-module',
]

Le downloader télécharge automatiquement csharp-module.dll/.so au prochain démarrage. Voir https://docs.altv.mp/cs/ pour la doc C#.

Étape 9 — Mettre à jour le serveur

Pour mettre à jour vers la dernière version stable :

Windows

cd C:\altv-server
.\altv-server.exe --update

Linux

cd ~/altv-server
./altv-server --update

Le downloader vérifie la branche définie et télécharge les binaires les plus récents.

FAQ

alt:V est-il gratuit ?

Oui, 100% gratuit et open-source. Pas de licence, pas de limite de slots côté client.

Combien de slots maximum ?

players = 128 par défaut. Techniquement, les serveurs alt:V supportent plus de 1000 slots avec une bonne config matérielle. Limite pratique selon RAM/CPU.

Quels langages sont supportés ?

JavaScript (via Node.js intégré) et C# (via le module csharp). Pas de Lua nativement.

alt:V est-il compatible avec les ressources FiveM ?

Non. alt:V utilise une API différente. Migration manuelle nécessaire.

Comment débugger un crash ?

Mettez debug = true dans server.toml, vérifiez les logs/ et la sortie console.

Mon serveur n’apparaît pas dans le master list

Vérifiez : announce = true, port 7788 ouvert TCP+UDP, IP publique correcte. Le master list peut prendre 5-15 minutes à indexer un nouveau serveur.

Comment installer un gamemode RP existant ?

Voir notre tuto config alt:V Roleplay pour Athena, GTArcos et autres gamemodes RP populaires.

Conclusion

Vous avez maintenant un serveur alt:V opérationnel from scratch. Étapes suivantes recommandées :

1. Configurer un gamemode RP — voir Configurer alt:V multiplayer Roleplay
2. Installer une base de données MariaDB pour persister les données joueur
3. Sécuriser le serveur avec un mot de passe et une whitelist Discord
4. Mises à jour — altv-server --update régulièrement

Pas envie de gérer Linux, le downloader et le firewall ? HebergTonServ installe votre serveur alt:V en moins de 5 minutes — Ryzen 9 5950X, jusqu’à 64 slots, Anti-DDoS 5 Tbps et support 24/7 dès 1,90€/mois.

Pour aller plus loin

• Hébergeur alt:V dès 1,90€/mois
• Configurer alt:V multiplayer Roleplay
• Documentation officielle alt:V — server.toml
• Documentation officielle alt:V — getting started JS