Appearance
Server Troubleshooting
Common issues and solutions for game servers.
Server Won't Start
Check Logs
Always start by reviewing logs:
- Server Details → Console tab
- Look for error messages
- 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 memorySolution: Increase RAM allocation or free up machine memory
Missing Dependencies
Error: libstdc++.so.6: cannot open shared object fileSolution: Install required system packages
Corrupt Files
Error: Failed to load engine.dllSolution: 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.logCommon fixes:
- Reduce player limit
- Increase RAM allocation
- Update game/mods
- Disable problematic mods
Crashes on Player Join
Often mod-related:
- Disable all mods
- Test if crash persists
- Re-enable mods one by one
- 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/udpTest Port Accessibility:
bash
# From another machine
telnet server-ip 27015Verify 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 timeLong-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 ExceededSolution: 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 subscriptionSolution: Verify game App ID is correct
Disk Space Issues
Error: No space left on deviceSolutions:
- Free up space by deleting old backups
- Increase disk allocation
- 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.logMod Causes Crashes
Isolate Problem Mod:
- Disable all mods
- Enable one at a time
- Test after each enable
- 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 updateSolutions:
- Check internet connection stable
- Verify sufficient disk space
- Clear Steam download cache
- Restart machine
Server Broken After Update
Rollback Option:
- Restore from pre-update backup
- Revert to previous game version (if possible)
- 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_passwordVerify Port Open:
bash
telnet server-ip 27020Check 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 postgresqlVerify Connection String:
- Hostname correct?
- Port accessible?
- Username/password valid?
- Database exists?
Test Connection Manually:
bash
psql -h localhost -U username -d databaseGetting Help
Collecting Debug Information
When asking for help, provide:
- Server logs (last 100 lines)
- Error messages (exact text)
- Server configuration
- Game version
- Mod list (if applicable)
- Steps to reproduce
Support Channels
Reporting Bugs
Include in bug reports:
- Arcadium version
- Agent version
- Game and version
- Expected vs actual behavior
- Error logs