Troubleshooting

The server shuts down 10 seconds after starting

SafeGuard has no valid license. The console says why, in red:

• no license key: safeguard_license_key or safeguard_cloud_url is missing in server.cfg (with set).
• the license key is invalid: the key was copied wrong or has been rotated. Copy the current key from Licenses.
• the license is revoked or suspended: the license was revoked or suspended in the dashboard.
• the license has expired: renew it in Licenses.

For the server to stop with the normal quit command (instead of the process being ended), add to server.cfg: add_ace resource.safeguard command.quit allow.

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

From version 1.3.1, going back and forth between the same places (door, lobby, apartment) no longer counts as a teleport pattern. If the detection continues, you have two options:

• Without changing the script: open the detection, copy the from and to coordinates and add the door or interior to Config.TransitionZones in config.lua. A jump that starts or ends in that area does not count. Keep the areas small, about 10 m.
• In the server script: add the resource to Config.MovementPermissionResources and call exports.safeguard:allowTeleport(source, 5000, 'apartment') before the teleport (see Scripts and integrations). Without the resource on that list, the call is refused.

Lowering the sensitivity of movement.teleport also works, but it affects the whole server.

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.