Troubleshooting

The server does not show up in the dashboard

• In the console, sg status should say cloud=Connected.
• cloud=Disabled: safeguard_cloud_url or safeguard_license_key is missing in server.cfg (with set).
• cloud=Rejected: wrong, expired or revoked key, or already active on another machine. In Licenses, check its state and use Reset activation if you moved machines.
• cloud=Connecting for a long time: the server cannot reach the API address. Check the address and the server's outgoing firewall.

SafeGuard does not start (/onesync dependency)

The resource needs OneSync. Enable it (set onesync on or in txAdmin) and restart the server.

The framework is not detected

sg framework shows the selected adapter. Make sure ensure safeguard comes after the framework. vRPex/creative bases need Config.Framework = 'vrpex'.

Staff get detected

Check they have safeguard.bypass (ACE) or one of the permissions in Config.Staff.FrameworkPermissions. sg staff shows who is exempt and why.

False "teleport" when entering houses, garages or jail

The script that teleports should call exports.safeguard:allowTeleport(source, 5000) before the teleport (see Scripts and integrations). If you cannot change the script, lower the sensitivity of movement.teleport.

Spectate is slow or screenshots do not arrive

• The player must have SafeGuard running in their game (shown in Live and in the F10 menu).
• Pictures go straight to your FiveM server's HTTP address. If your server is not reachable over HTTP, a slower path is used. In the console, spectate.stats shows frames per second and where the time goes; send us that line on Discord.
• With a weak player connection, use Balanced or Detail.

A detection fires for no reason

See Detections → False positives.

Support

Talk to us on Discord or by e-mail at equipa@safeguardac.online. Include the version (sg status), the framework and, if you can, the console lines.