Install FiveM
Up to now you have written Lua in a browser sandbox, with no real game around it. To actually join a FiveM server, see your code run in a live world, and one day host your own, you need the real thing on your machine. That real thing is the FiveM client, a free app you install once. This lesson gets it onto your PC and gets you to the screen where servers are waiting.
What FiveM is to install
The thing you are about to install is called the FiveM client. A client is just the app that runs on your computer and lets you join something running somewhere else. Your web browser is a client for websites. Discord is a client for chat servers. The FiveM client is the app you open to join FiveM servers.
Vocabulary
- Client
- The app on your computer that you open to join something hosted elsewhere. The FiveM client is the app you launch to play on FiveM servers.
- FiveM
- A free modification platform for GTA V that lets community-run servers replace Rockstar's online mode with their own rules, jobs, and scripts.
- GTA V
- Grand Theft Auto V, the base game from Rockstar. FiveM needs your legitimately owned copy of it to work.
The important word is legitimate. FiveM uses the real GTA V files already on your PC. It does not give you the game, and it refuses to run on a pirated or cracked copy. If you own GTA V on Steam, Epic, or the Rockstar launcher, you are set.
Why you need it installed
In this Start Here track you have been writing Lua in a browser sandbox. That sandbox is perfect for learning the language, but it has no game world around it. It cannot show you a car spawn, a player join, or a server console reacting to your script. To see any of that, you need a real FiveM client that can connect to a real server.
Think of it like learning to drive. The browser sandbox is the parking lot where you practice steering with no traffic. FiveM is getting out onto the actual road. You need both, and you need them in that order. Installing FiveM is the moment your practice starts touching the real thing.
Once FiveM is installed you can join any public server to look around, and later you can connect to a server you host yourself and watch your own Lua run. That second part is the whole point of this school. You cannot get there without the client.
How it works
Here is the part that confuses most beginners, so we will make it plain. FiveM does not replace GTA V. It sits next to it. When you launch FiveM, it quietly starts your real GTA V in the background, then swaps out Rockstar's online mode for FiveM's own multiplayer layer. Your GTA V install is never changed or damaged.
YOUR PC
+-----------------------------------------------+
| |
| GTA V (your legit copy, untouched) |
| ^ |
| | FiveM launches it and loads the world |
| | |
| FiveM client ---> swaps in its own |
| multiplayer layer |
| |
+------------------------|----------------------+
|
v
Community FiveM servers
(where your Lua runs)So you end up with two ways to play, side by side. Open GTA V the normal way and you get Rockstar's GTA Online. Open FiveM and you get the community servers. Same game files underneath, two different front doors.
Install it
Now the actual install. Follow the steps in order. Only download FiveM from the official site, never from a mirror, a Discord link, or a video description.
Download FiveM from fivem.net
Open this address in your browser:
https://fivem.netClick the Download Client button. You will be asked to accept FiveM's terms, then a small file downloads. It is only a few megabytes, not the whole game. The big game data comes later, on your machine, from the GTA V you already own.
Run the installer
Double-click FiveM.exe. Windows may show a SmartScreen warning. SmartScreen is the built-in Windows check that flags files it has not seen many times before. If, and only if, you downloaded the file straight from fivem.net, click More info then Run anyway. If the file came from anywhere else, delete it and download again from the official site.
FiveM will ask where to install. The default location is fine for almost everyone:
%LocalAppData%\FiveM%LocalAppData% is a Windows shortcut to your personal app-data folder. You do not have to memorize it. Just accept the default.
Let FiveM find your GTA V
FiveM needs to locate your GTA V install. Often it finds it on its own. If it asks, browse to your GTA V folder and pick GTA5.exe (not PlayGTAV.exe, which is only the launcher shortcut). The usual folders are:
Steam: C:\Program Files (x86)\Steam\steamapps\common\Grand Theft Auto V\
Epic: C:\Program Files\Epic Games\GTAV\
Rockstar: C:\Program Files\Rockstar Games\Grand Theft Auto V\FiveM then builds a local cache of the GTA V game data so it can boot into servers quickly. This is a one-time job. Expect a few minutes on an SSD, longer on a hard drive. Let the progress bar finish.
Launch FiveM
From now on you start FiveM from your Windows Start menu, not from the GTA V launcher. Search FiveM in the Start menu and open it. FiveM starts GTA V in the background for you. You do not launch GTA V yourself first.
Reach the main menu
Once FiveM finishes loading you land on its main menu. Click Play and you will see the server browser, a scrollable list of public servers you could join.
You do not have to join anything yet. Reaching this screen and seeing servers listed means your install worked. That is all this lesson needs to prove.
Common beginner mistakes
These are the snags that stop new people. The text in the gray box is the literal message you might see.
| Symptom | Fix |
|---|---|
Could not find a Grand Theft Auto V installation | FiveM is pointed at the wrong folder, or you selected PlayGTAV.exe instead of GTA5.exe. Re-run FiveM and browse to your GTA V folder, then pick GTA5.exe directly. They sit side by side in the same folder. |
This product is not currently activated for online play | FiveM only works with a legitimate copy of GTA V. Open Steam, Epic, or the Rockstar launcher, launch GTA V once so it activates, then open FiveM again. Cracked or pirated copies will not run. |
SmartScreen prevented an unrecognized app from starting | If you downloaded from fivem.net, click More info then Run anyway. If the file came from anywhere else, delete it and download again from the official site only. |
Stuck on "updating game data" forever | Let the progress bar reach 100 percent and do not close it. On a hard drive this can take a while. Make sure GTA V is fully updated in your store, add a FiveM exception in your antivirus, and confirm you have a few GB of free disk space. |
Does FiveM replace GTA V or run on top of it?
It runs on top of GTA V. FiveM does not change, replace, or damage your GTA V files. When you open FiveM, it launches your real GTA V in the background and swaps Rockstar's online mode for its own multiplayer layer. Your normal GTA Online is still there, untouched, whenever you open the game the regular way.
Try it yourself
What you can do now
- Explain that FiveM is a free client app that uses your legitimate GTA V to join community servers.
- Say why FiveM runs on top of GTA V instead of replacing it, and that your normal GTA Online stays untouched.
- Download FiveM only from fivem.net and run the installer safely past a SmartScreen warning.
- Point FiveM at your GTA V folder by picking GTA5.exe, not PlayGTAV.exe.
- Launch FiveM from the Start menu and reach the main menu with a list of servers.
You now have a working FiveM client and you have seen the server list. Next you will set up the tool you write your code in. Continue to Set up VS Code for FiveM, where you install the free editor every FiveM developer uses and get it ready for Lua.