I create free, open-source projects for the community. If you'd like to support my work, consider becoming a sponsor!

Support this project through GitHub Sponsors with flexible options:

• One-time or monthly contributions
• Custom amount - choose what works for you
• Multiple tiers available - from basic benefits to priority support or private project access

Every contribution helps me dedicate more time to development, support, and creating new features. Thank you! 🙏

⭐ Or support me for free by starring this repository!

Run CS2 on multiple servers without storing 55GB per server. One installation, shared across all containers.

A guided installation wizard handles everything - download, configuration, systemd daemon, and cron setup. Default options work for most setups.

curl -fsSL https://raw.githubusercontent.com/K4ryuu/CS2-Egg/main/misc/install-cs2-update.sh | sudo bash

Recommended: run with default options. Just press Enter through the wizard.

→ Full documentation

Supported Panels

Supported Operating Systems (for VPK Sync & Centralized Updates)

The centralized update script automatically detects your OS version and installs appropriate dependencies.

(back to top)

Multi-Framework Support → Enable multiple frameworks simultaneously with independent boolean toggles. The egg automatically handles framework dependencies, load order, and gameinfo.gi configuration.

• MetaMod:Source → Core plugin framework (required for CSS)
• CounterStrikeSharp → C# plugin framework with .NET 8 runtime
• SwiftlyS2 → Standalone C# framework v2
• ModSharp → Standalone C# platform with .NET 9 runtime

Each framework can be enabled/disabled independently via Pterodactyl/Pelican panel. Auto-updates on server restart while enabled.

• Auto-Updaters → MetaMod, CounterStrikeSharp, SwiftlyS2, ModSharp automatically update on server restart
• Centralized Update Script → Auto-restart on CS2 updates with version tracking (misc/update-cs2-centralized.sh)

• VPK Sync → 80% storage & bandwidth reduction via centralized file sharing
• Junk Cleaner → Automatic cleanup (backups, logs, demos)

• Console Filter → Block unwanted messages (inspired by Poggu's CleanerCS2)
• JSON Configs → FTP-editable configuration files
• Colored Logging → Enhanced console output
• Custom Parameters → Safe user-configurable startup options
• Tokenless Servers → Run servers without GSLT token requirement

(back to top)

Comprehensive documentation is available:

• Installation Guide → Install and configure the egg
• Quick Start → Get running quickly
• Updating → Update guide

• VPK Sync & Centralized Updates → 80% storage savings + auto-restart on CS2 updates
• Auto-Updaters → Plugin auto-updates (MetaMod, CSS, SwiftlyS2, ModSharp)
• Console Filter → Message filtering
• Junk Cleaner → Automatic cleanup

• Building from Source → Build your own image
• Troubleshooting → Common issues

View Full Documentation →

(back to top)

Build your own Docker image using the included build script:

# Build with custom tag
./build.sh latest

# Build and publish to Docker Hub
./build.sh latest --publish

Note: Edit build.sh to change the registry from sples1/k4ryuu-cs2 to your own.

Full Building Guide → - Customization, multi-arch builds, CI/CD integration

(back to top)

• CS2 Pterodactyl from 1zc: The base of the image is maximally based on this image and if you don't want to use the custom scripts, you can use this image instead. Appreciate the work of 1zc and give him a star.

• Improve bad SFTP client compatibility against stating symbolic links
• GDC optional connection to automatically detect unreliable gamedatas(?)
• Optimize and add more automated tests for update scripts

(back to top)

Distributed under the GPL-3.0 License. See LICENSE.md for more information.

(back to top)