Complete guide to setting up your RedM server on Legion Hosting. RedM is a multiplayer modification framework for Red Dead Redemption 2, built by Cfx.re (the same team behind FiveM). This guide covers license key registration, server configuration, resource management, and connecting players. If you run into issues, see our RedM Troubleshooting guide.

What is RedM?

RedM is a community-driven multiplayer framework for Red Dead Redemption 2, developed and maintained by the Cfx.re Collective — the same organization behind FiveM (the GTA V multiplayer framework). RedM provides:

• A dedicated server platform for hosting custom RDR2 multiplayer experiences
• A resource/scripting system using Lua, C#, and JavaScript
• Support for custom game modes, roleplay frameworks, and community mods
• A client launcher that connects players to custom servers
• Native function access for extensive game modification

Getting a Cfx.re License Key

Every RedM server requires a valid Cfx.re license key. This key is free and tied to your Cfx.re account.

1. Go to the Cfx.re Keymaster at https://keymaster.fivem.net/.
2. Log in with your Cfx.re account (or create one if you do not have one).
3. Click Register a new server (or "New Server" depending on the current interface).
4. Fill in the form:
   • Label: A name for your server (for your reference only).
   • Server IP: Enter your server's IP address from GPanel. You can find this under your server's overview page.
   • Server Type: Select the appropriate type (typically "Other/VPS" for hosted servers).
5. Click Generate. Your license key will be displayed. Copy it and save it securely.

First Start and GPanel Startup Variables

After purchasing your RedM server from Legion Hosting, log in to GPanel and navigate to your server.

Setting Startup Variables

Go to the Startup tab in GPanel. You will see several configurable variables:

First Start

1. Enter your Cfx.re license key in the CFX_LICENSE field.
2. Set your desired server name and max player count.
3. Go to the Console tab and click Start.
4. The server will download the RedM server artifacts on first boot. This may take a few minutes.
5. Once you see messages indicating the server is listening (e.g., Started resource manager), your server is online.

server.cfg Configuration

The server.cfg file is the primary configuration file for your RedM server. Access it through GPanel's File Manager or via SFTP. Below is a comprehensive example configuration:

# ========================================
# RedM Server Configuration
# ========================================

# Network Endpoints
# These define what IP and port the server listens on.
# 0.0.0.0 means listen on all available interfaces.
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Server Identity
sv_hostname "My RedM Roleplay Server"
sv_maxclients 32
sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"

# Server Password (leave empty for no password)
# sv_password "MyServerPassword"

# Server Description and Tags (shown in server browser)
sets sv_projectName "My RedM RP"
sets sv_projectDesc "A Wild West roleplay experience"
sets tags "roleplay, rp, economy, custom"

# Locale
sets locale "en-US"

# Steam Web API Key (optional, for Steam identity)
# Get one from https://steamcommunity.com/dev/apikey
# set steam_webApiKey "YOUR_STEAM_API_KEY"

# OneSync (networked entity sync)
# "on" = standard OneSync, "legacy" = legacy mode
set onesync on

# RCON Password (for remote console access)
rcon_password "YourRconPassword123"

# Resource Directories
# Ensure resources are loaded from these directories
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog

# ========================================
# Add your custom resources below
# ========================================
# ensure my_custom_resource
# ensure vorp_core
# ensure oxmysql

Key Configuration Options Explained

Resource Management

Resources are the building blocks of a RedM server. They contain scripts, assets, and configurations that add functionality to your server.

Resource Structure

Each resource is a folder inside the resources/ directory containing at minimum a fxmanifest.lua (or legacy __resource.lua) file:

resources/
    [system]/
        chat/
            fxmanifest.lua
            cl_chat.lua
            sv_chat.lua
        spawnmanager/
            fxmanifest.lua
            ...
    [custom]/
        my_resource/
            fxmanifest.lua
            client.lua
            server.lua
            config.lua

Loading Resources

Resources are loaded using the ensure command in server.cfg:

# Load a specific resource
ensure my_resource

# You can also use 'start' (functionally equivalent to ensure)
start another_resource

The difference between ensure and start: ensure will start the resource if it is stopped, or restart it if it is already running. start will only start it if it is not already running.

Installing New Resources

1. Download the resource from its source (GitHub, community forums, etc.).
2. Upload the resource folder to your server's resources/ directory via SFTP (see SFTP Upload Guide) or GPanel file manager.
3. Add an ensure resource_name line to your server.cfg.
4. Restart the server for the resource to load.

Popular RedM Frameworks and Resources

How to Connect

Players need the RedM client to connect to your server. Here is how to get started:

Installing RedM

1. Players must own a legitimate copy of Red Dead Redemption 2 on Steam, Epic Games Store, or Rockstar Games Launcher.
2. Download the RedM client from redm.net.
3. Install RedM. It will automatically detect the RDR2 installation.
4. Launch RedM. On first launch, it will update and cache game files.

Connecting via Server Browser

1. Launch RedM.
2. Click Play from the main menu to open the server browser.
3. Search for your server by name (the sv_hostname value from your config).
4. Select your server and click Connect. Enter the password if one is set.

Direct Connect

1. Launch RedM.
2. Press F8 to open the client console.
3. Type the following command with your server's IP and port:

connect YOUR_SERVER_IP:PORT

For example:

connect 192.168.1.100:30120

Find your server IP and port in GPanel under your server's overview page, or see How to Find Your Server IP and Port.

FiveM Shared Concepts

Since RedM and FiveM are both built on the Cfx.re platform, many concepts transfer directly:

• server.cfg syntax is identical between FiveM and RedM.
• Resource manifests (fxmanifest.lua) use the same format and fields.
• Server-side scripting (Lua, C#, JavaScript) works the same way.
• oxmysql and other shared libraries work on both platforms.
• txAdmin management panel works with both FiveM and RedM servers.
• OneSync entity synchronization is available on both platforms.

The primary differences are client-side natives (game-specific functions), resource compatibility (FiveM resources need porting for RDR2), and the available game world/entities.

Related Articles

• RedM Troubleshooting — Solutions for common license key, connection, resource, and performance issues.
• How to Find Your Server IP and Port
• How to Upload Files via SFTP
• Getting Started with Your New Server

Need Help?

If you need assistance setting up your RedM server, obtaining a license key, or configuring resources, open a support ticket and our team will help you get up and running.