QBCore Frameworkqbcore.netCommunity docs
On this page

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:

  1. close FiveM,
  2. press Win + R,
  3. open %localappdata%\FiveM\FiveM.app\data,
  4. remove the cache directory relevant to the problem:
    • cache
    • server-cache
    • server-cache-priv
  5. 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.

Safe FiveM cache diagnosis and cleanup workflow

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\data

The cache directories covered by this guide are:

cache
server-cache
server-cache-priv

If 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:

FolderPractical roleWhen to consider clearing it
cacheGeneral cached client/downloaded dataStale or corrupted cached content after an update
server-cacheCached server/resource dataOne server keeps serving old or inconsistent downloaded content
server-cache-privAdditional private server cache dataServer-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.

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\data

3. 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-priv

4. 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%\FiveM directory,
  • the entire %appdata%\CitizenFX directory,
  • 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:

  1. record the exact FiveM error text,
  2. restart FiveM once,
  3. confirm GTA V and Windows meet current FiveM requirements,
  4. follow the matching Cfx client-support article,
  5. 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.

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.

On this page

Leonida RP server website built with RPWebsite
RPWebsite

Advertisement · RPWebsite

Want a website for your server?

Launch a site with live player status, rules, and a join button in minutes.

Build your website