Skip to content

Server Troubleshooting

Common issues and solutions for game servers.

Server Won't Start

Check Logs

Always start by reviewing logs:

  1. Server Details → Console tab
  2. Look for error messages
  3. Note any "FATAL" or "ERROR" lines

Common Causes

Port Conflict

Error: Address already in use (port 27015)

Solution: Change server port or stop conflicting service

Insufficient Memory

Error: Cannot allocate memory

Solution: Increase RAM allocation or free up machine memory

Missing Dependencies

Error: libstdc++.so.6: cannot open shared object file

Solution: Install required system packages

Corrupt Files

Error: Failed to load engine.dll

Solution: Delete server, reinstall fresh

Server Crashes

Random Crashes

Check System Resources:

  • Is RAM exhausted?
  • Disk space full?
  • CPU temperature high?

Review Crash Logs:

/logs/crash-YYYY-MM-DD-HH-mm-ss.log

Common fixes:

  • Reduce player limit
  • Increase RAM allocation
  • Update game/mods
  • Disable problematic mods

Crashes on Player Join

Often mod-related:

  1. Disable all mods
  2. Test if crash persists
  3. Re-enable mods one by one
  4. Identify culprit

Connection Issues

Players Can't Connect

Verify Server Online:

  • Check status is "Online" in dashboard
  • Server console shows "Ready for connections"

Check Firewall:

bash
# Allow port through firewall
sudo ufw allow 27015/tcp
sudo ufw allow 27015/udp

Test Port Accessibility:

bash
# From another machine
telnet server-ip 27015

Verify IP Address:

  • Public IP, not private (192.168.x.x)
  • Check with: curl ifconfig.me

High Latency

Check Network:

  • Machine bandwidth sufficient?
  • Network congestion?
  • DDoS protection active?

Optimize Server:

  • Reduce view distance
  • Lower entity count
  • Optimize tick rate

Performance Issues

Low TPS/FPS

Identify Bottleneck:

  • CPU usage at 100%? Upgrade CPU or reduce load
  • RAM at capacity? Increase allocation
  • Disk I/O high? Use SSD instead of HDD

Game-Specific Optimizations:

Minecraft:

  • Reduce view-distance
  • Use Paper/Purpur for better performance
  • Limit entity counts

ARK:

  • Lower ClampItemSpoilingTimes
  • Reduce tamed dino count
  • Optimize structure limits

Rust:

  • Reduce world size
  • Lower entity count
  • Adjust save interval

Memory Leaks

Server RAM usage grows over time:

Short-term fix:

Schedule daily restart at low-activity time

Long-term fix:

  • Update to latest game version
  • Update/remove problematic mods
  • Report to game developers

Installation Failures

SteamCMD Errors

Login Failed:

Error: Login Failure: Rate Limit Exceeded

Solution: Wait 15 minutes, retry

Download Stalled:

Update state (0x61) downloading, progress: 45.23%
[Stuck for 10+ minutes]

Solution: Cancel, clear download cache, restart

Invalid App ID:

Error: No subscription

Solution: Verify game App ID is correct

Disk Space Issues

Error: No space left on device

Solutions:

  1. Free up space by deleting old backups
  2. Increase disk allocation
  3. Move server to different partition

Mod/Plugin Issues

Mod Won't Load

Check Compatibility:

  • Game version matches mod version?
  • Mod dependencies installed?
  • Mod conflicts with others?

Review Mod Logs:

/logs/mod-errors.log

Mod Causes Crashes

Isolate Problem Mod:

  1. Disable all mods
  2. Enable one at a time
  3. Test after each enable
  4. Remove problematic mod

Check for Updates:

  • Mods often need updates after game patches
  • Subscribe to mod update notifications

Update Problems

Update Fails

Error: Failed to download update

Solutions:

  • Check internet connection stable
  • Verify sufficient disk space
  • Clear Steam download cache
  • Restart machine

Server Broken After Update

Rollback Option:

  1. Restore from pre-update backup
  2. Revert to previous game version (if possible)
  3. Wait for hotfix from developers

Fresh Start:

  • Delete server files
  • Reinstall from scratch
  • Restore world save only

RCON Not Working

Can't Connect via RCON

Check RCON Enabled:

# Server config must have RCON enabled
rcon.port = 27020
rcon.password = your_password

Verify Port Open:

bash
telnet server-ip 27020

Check Password Correct:

  • No spaces in password
  • Case-sensitive
  • Special characters escaped properly

Database Connection Issues

Server Can't Connect to Database

For servers with database requirement:

Check Database Running:

bash
systemctl status postgresql

Verify Connection String:

  • Hostname correct?
  • Port accessible?
  • Username/password valid?
  • Database exists?

Test Connection Manually:

bash
psql -h localhost -U username -d database

Getting Help

Collecting Debug Information

When asking for help, provide:

  1. Server logs (last 100 lines)
  2. Error messages (exact text)
  3. Server configuration
  4. Game version
  5. Mod list (if applicable)
  6. Steps to reproduce

Support Channels

Reporting Bugs

Include in bug reports:

  • Arcadium version
  • Agent version
  • Game and version
  • Expected vs actual behavior
  • Error logs

Next Steps

Released under the MIT License.