6 min read
How to Clear FiveM Cache Safely
Clearing FiveM cache can help when downloaded server content is stale or a local cache is damaged. It is not a universal fix for connection failures, server-side script errors, authentication problems, outdated server artifacts, or a broken GTA V installation.
Do not clear cache on a schedule. Use it when the symptoms point to cached client/server content.
Quick answer
On a normal Windows installation:
- close FiveM,
- press
Win + R, - open
%localappdata%\FiveM\FiveM.app\data, - remove the cache directory relevant to the problem:
cacheserver-cacheserver-cache-priv
- start FiveM again and reconnect.
FiveM will rebuild or redownload data it needs. The first reconnect can therefore take longer.
Do not delete unrelated FiveM application data, GTA V save/configuration folders, authentication files, or the whole FiveM installation just because a cache clear did not help. Preserve logs before troubleshooting so you still have evidence of the original error.
Conceptual diagram; verify the behavior against your installed resource version.
Before deleting anything
A cache clear is most useful when the issue appeared after server assets or resources changed.
Check these first:
- Only one server is affected: the problem may be server-specific. Test another known server before changing the client installation.
- The server is offline or unreachable: cache deletion does not repair routing, firewall or server-list configuration.
- F8 shows a specific error: search that error first. Cfx documents targeted fixes for some client failures that are different from deleting the general cache.
- The server shows an EOS/EOL warning: the server owner must update server artifacts; players cannot repair that by clearing local cache.
- The problem is inside one QBCore resource: collect the client/server error and troubleshoot the resource before repeatedly wiping caches.
The current Cfx client-issues guide explicitly uses targeted fixes for several errors. Prefer the documented fix when your error matches one.
FiveM cache location
The common FiveM client data path on Windows is:
%localappdata%\FiveM\FiveM.app\dataThe cache directories covered by this guide are:
cache
server-cache
server-cache-privIf your FiveM application data is installed elsewhere, use the actual FiveM application-data location rather than inventing a second copy of these folders.
What the cache folders are for
From a troubleshooting perspective, treat the folders like this:
| Folder | Practical role | When to consider clearing it |
|---|---|---|
cache | General cached client/downloaded data | Stale or corrupted cached content after an update |
server-cache | Cached server/resource data | One server keeps serving old or inconsistent downloaded content |
server-cache-priv | Additional private server cache data | Server-specific cache problems persist after a narrower cleanup |
The exact internal cache implementation can change. The important troubleshooting distinction is that deleting these folders forces FiveM to rebuild/redownload cached data; it does not change the server's source code or repair upstream services.
Recommended: selective cache clear
Start with the narrowest change that matches the symptom.
1. Close FiveM
Exit FiveM normally. If Windows reports that a cache file is still in use, check Task Manager for a remaining FiveM process and close that process before deleting files.
2. Open the data directory
Press Win + R and enter:
%localappdata%\FiveM\FiveM.app\data3. Delete the relevant cache folder
If the problem is tied to one server or a recent server-resource update, start with the server cache rather than deleting unrelated application data.
For a broader cache reset, remove:
cache
server-cache
server-cache-priv4. Restart FiveM
Launch FiveM and reconnect. Expect required server assets to download again.
5. Reproduce the original problem
Do not treat a successful launch as proof that the issue is fixed. Repeat the action that originally failed and check F8/client logs and server logs if the problem returns.
When clearing cache can help
Cache cleanup is a reasonable diagnostic step for symptoms such as:
- old textures, models, NUI or other downloaded server assets still appearing after an update,
- a server resource appearing locally stale while other players receive the current version,
- a suspected corrupted local cache after an interrupted resource download,
- a reproducible server-specific client issue that disappears on a clean cache.
It should be one controlled troubleshooting step, not a default response to every FiveM problem.
When clearing cache will not fix the root cause
Server is not reachable
If direct connection fails because of firewall, port-forwarding, DNS, proxy or server configuration, clearing local cache does not change that infrastructure.
Use the FiveM server-connection troubleshooting guide or the upstream Cfx server-issues documentation.
Server artifacts are outdated
Cfx EOS/EOL warnings require the server owner to update server artifacts. The Cfx EOS/EOL documentation states that the player does not fix the red EOL condition locally.
Authentication or entitlement errors
Follow the exact Cfx client-support article for the displayed error. Authentication files are not general cache and should not be deleted as routine maintenance.
QBCore resource errors
If F8 or the server console names a QBCore resource, export, event, SQL query or dependency, fix that technical cause. A cache clear can refresh downloaded client assets, but it cannot repair bad Lua, missing SQL, invalid configuration or the wrong resource load order.
Start with QBCore troubleshooting.
GTA V or game-storage problems
FiveM uses additional game storage and requires a supported Windows/GTA V installation. Do not
delete game-storage as part of a normal server-cache cleanup. Follow the exact Cfx support path for
game-storage or installation errors instead.
What not to delete as routine cache cleanup
Avoid broad deletion of:
- the entire
%localappdata%\FiveMdirectory, - the entire
%appdata%\CitizenFXdirectory, game-storage,- GTA V documents/save folders,
- authentication or entitlement files,
- logs you still need for diagnosis.
Some official Cfx support procedures intentionally remove a specific file for a specific error. That does not make those files general-purpose cache-cleaning targets.
For example, Cfx currently documents a targeted caches.xml removal for certain component-loading
errors. Follow that procedure only when the matching error applies.
FiveM needs to update game cache / game storage errors
Do not assume that server-cache or server-cache-priv is the cause. A game-cache or game-storage
message can concern the local game installation rather than one server's downloaded resources.
Use this order:
- record the exact FiveM error text,
- restart FiveM once,
- confirm GTA V and Windows meet current FiveM requirements,
- follow the matching Cfx client-support article,
- only clear the general/server cache when the error or recent server changes make cached content a plausible cause.
Server owners: diagnose before telling every player to clear cache
If many players report the same issue immediately after a deployment, investigate the deployment first.
Check:
- resource startup errors,
- manifest/file declarations,
- changed asset filenames,
- CDN/proxy behavior,
- load order and dependencies,
- whether the same issue reproduces on a clean test client.
Do not add undocumented convars to server.cfg as a generic cache fix. Use current Cfx/QBCore
documentation for the actual subsystem involved.
FAQ
Should I clear FiveM cache every month?
No. There is no reason to treat cache deletion as scheduled maintenance. Clear it when you are diagnosing stale or corrupted cached content.
Do I need to restart Windows?
Usually not. Close FiveM first. Restart Windows only when a process or file lock persists and you cannot cleanly stop it.
Should I clear Steam's download cache too?
Not for a normal FiveM server-cache problem. Steam's download cache is a different subsystem. Use Steam troubleshooting only when the GTA V/Steam installation itself is implicated.
Why is the first reconnect slower after clearing cache?
FiveM has to rebuild or download data that was previously cached.
Can clearing cache fix a broken QBCore script?
It can refresh client-downloaded assets, but it cannot fix broken Lua, SQL, configuration, dependencies, permissions or server-side state.
Is FiveM supported on macOS or Linux as a normal client?
The current Cfx system requirements list supported Windows versions for the FiveM client. This guide therefore documents the supported Windows client path instead of publishing speculative macOS/Linux cache paths.
Related troubleshooting
Found an issue in this guide?
Send the page URL, the affected example, and a source or reproduction to the site maintainer. For a server or resource problem, use the support guide.
Commands and Key Mappings
How RegisterCommand, RegisterKeyMapping, and QBCore.Commands.Add fit together, and the mistakes that break rebindable keys.
Create a QBCore Side Job Resource
Create a complete QBCore delivery job resource with server-issued stops, distance and duty checks, replay protection, controlled payouts and cleanup.
