FAQ: Technical & Troubleshooting Problem Solving
Technical issues, error messages, and troubleshooting guides.
Technical Issues
The website won't load
Troubleshooting steps:
- Check your internet connection
- Clear browser cache and cookies
- Try a different browser
- Check if the server is online (contact admin)
- Disable browser extensions that might interfere
I can't log in with Steam
Common causes:
- Steam is down (check https://steamstat.us/)
- Cookies are disabled in your browser
- Browser is blocking pop-ups
- Steam Community is blocked by firewall
Solutions:
- Enable cookies and pop-ups
- Try incognito/private browsing mode
- Check firewall settings
- Wait and retry if Steam is having issues
My loadout isn't saving
Possible reasons:
- No active internet connection
- Server database is down
- Session expired (log in again)
- Browser localStorage is full
Solutions:
- Check browser console for errors (F12)
- Try refreshing the page
- Log out and log back in
- Clear browser data and try again
Images aren't loading
Common causes:
- CDN is down or blocked
- Ad blocker is interfering
- Network issue
- Missing image assets
Solutions:
- Disable ad blocker for this site
- Check browser console for 404 errors
- Try a different network
- Report missing images to developers
The application is slow
Performance tips:
- Close unnecessary browser tabs
- Clear browser cache
- Use a modern browser (Chrome, Firefox, Edge)
- Check CPU/memory usage
- Disable browser extensions temporarily
Database errors
Error: "Database connection failed"
Solutions:
- This is a server-side issue
- Contact server administrator
- Check server logs if you have access
- Wait for admin to fix database connection
Troubleshooting Error Messages
"Session expired" or "Please log in again"
Cause: Your authentication session has timed out.
Solution: Click "Login with Steam" again to authenticate.
"Failed to load item data"
Cause: Cannot fetch item information from Steam or database.
Solutions:
- Check internet connection
- Retry the operation
- Try a different item
- Contact administrator if persistent
"Invalid inspect URL"
Cause: The inspect link is malformed or incomplete.
Solutions:
- Copy the full inspect link
- Verify link format starts with
steam://rungame/730/... - Try getting a fresh link from the source
- Test with a different item's inspect link
"Cannot connect to Steam"
Cause: Backend server cannot reach Steam servers.
Solutions:
- Check if Steam is online (steamstat.us)
- Contact server administrator
- Wait for Steam services to recover
- Try again later
"Database error" or "Failed to save"
Cause: Server-side database issue.
Solutions:
- This requires administrator intervention
- Check server status page if available
- Contact support with error details
- Try again after a few minutes
"Unauthorized" or "Access denied"
Cause: Not logged in or session invalid.
Solutions:
- Log out and log back in
- Clear cookies and try again
- Check if your account is active
- Contact support if persistent
Development & Self-Hosting
Can I host my own instance?
Yes! CS2Inspect is open source. See the Setup Guide and Deployment Guide for instructions.
What are the system requirements?
Minimum:
- Node.js 16+
- MariaDB/MySQL 10+
- 1GB RAM
- 10GB disk space
Recommended:
- Node.js 18+
- MariaDB 10.11+
- 2GB+ RAM
- 20GB+ disk space
Do I need a Steam account for self-hosting?
Steam API Key: Required (for authentication) Steam Bot Account: Optional (only for unmasked inspect URLs)
Get Steam API key: https://steamcommunity.com/dev/apikey
How do I contribute?
See the Contributing Guide for:
- Code standards
- Development workflow
- Pull request process
- Issue guidelines
Where can I report bugs?
Report bugs on GitHub Issues:
- Search existing issues first
- Create new issue if not found
- Include detailed description
- Add screenshots if applicable
- Specify browser/OS version
Performance Optimization
Why is the Visual Customizer slow?
The Visual Customizer uses HTML5 Canvas which can be CPU-intensive:
- Close other applications
- Use hardware acceleration in browser
- Reduce browser window size
- Disable unnecessary browser extensions
How can I speed up page loading?
- Use a faster internet connection
- Enable browser caching
- Use a modern browser
- Close unnecessary tabs
- Clear old browser data
Database is slow when loading loadouts
Server-side issue:
- Contact administrator
- Check database indexing
- Review server resources
- Consider database optimization
Related Documentation
- General FAQ - General questions and getting started
- Customization FAQ - Loadouts and weapon customization
- User Guide - Complete usage guide
- Setup Guide - Developer setup instructions
- Deployment Guide - Production deployment