How To Create an alt:V Server (2026 Quickstart Guide)

Option A — Quickstart (Windows & Linux) with altv-pkg

This pulls the latest official binaries for you.

1. Create a working directory

mkdir altv-server && cd altv-server

2. Initialize Node (for tooling only)

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

3. Download server binaries

npx altv-pkg release

Re-run npx altv-pkg release any time you want to update.

Option B — Manual install

1. Download the Server build from the official alt:V downloads page (choose Windows or Linux).
2. Extract into altv-server/.

Create package.json (top-level)

This enables ESM syntax (import ...) for your JS resources.

{

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

}

Minimal server.toml

Create server.toml in the server root:

Create server.toml in the server root:

# Displayed name in the alt:V client name = "My alt:V Server" # Bind to all interfaces host = "0.0.0.0" # Default game port (TCP & UDP) port = 7788 # Player slots players = 128 # Show on masterlist? (set true for public) announce = true # Obtain a token from the alt:V dashboard and paste here when going public # token = "YOUR_MASTERLIST_TOKEN"

# Load the JS module and our example resource modules = ["js-module"] resources = ["example"]

# Helpful in development debug = true logStreams = ["console", "file"]

Tip: Ports when using external voice are typically 7798 (server) and 7799 (client); open them only if you run the voice server separately. The basic in-process voice needs only your game port.

Your first resource (JavaScript)

Create resources/example/resource.toml:

# Server-side language for this resource type = "js" # Client-side language for this resource client-type = "js"

# Entry files main = "server.mjs" client-main = "client/client.mjs"

# Files the client may download client-files = [ "client/*", ]

resources/example/server.mjs

import * as alt from 'alt-server';

alt.on('playerConnect', (player) => { lua

  alt.log(\`+ ${player.name} connected\`);
  player.emit('welcome:notify', \`Welcome to ${alt.getServerConfig().name}!\`);
```lua
```lua
});

alt.on('playerDisconnect', (player, reason) => { ```lua
  alt.log(\`- ${player?.name ?? 'unknown'} left (${reason})\`);
});

resources/example/client/client.mjs

import * as alt from 'alt-client';

alt.onServer('welcome:notify', (msg) => { lua

  alt.log(\`Server says: ${msg}\`);
  // Simple on-screen help text
  alt.everyTick(() => { ```lua
    alt.drawText2d(msg, 0.5, 0.9, 0.5, 255, 255, 255, 255, 0, true, true, 0);
  });
  // Remove after ~8 seconds

alt.setTimeout(() => alt.clearEveryTick(), 8000);

});

That’s a complete resource

That’s a complete resource. When a player connects they receive a welcome text.

Start the server

Windows (PowerShell)

cd C:\path\to\altv-server ./altv-server.exe

Linux

cd /opt/altv-server # or your path chmod +x altv-server ./altv-server

If startup is clean, you’ll see logs and the server will be reachable at your.ip:7788. Join via the alt:V client (Direct Connect) or from the Masterlist (if announce = true and a valid token is set).

Open the firewall

Windows (PowerShell, run as Admin)

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

If using an external voice server, also allow 7798/udp and 7799/udp.

(Optional) Run alt:V as a service on Linux

Create /etc/systemd/system/altv.service: | [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 | |

Launch faster

Compare curated bundles

Bundles shorten the path from planning to launch by grouping the highest-leverage scripts into a cleaner commercial starting point.