Skip to main content
To install CS2-SimpleAdmin on a Counter-Strike 2 server, install CounterStrikeSharp on the Frameworks page, upload SimpleAdmin and its three required plugins (PlayerSettings, AnyBaseLibCS2 and MenuManagerCS2) to game/csgo/addons/counterstrikesharp/plugins/, and restart. SimpleAdmin then creates CS2-SimpleAdmin.json, where you choose SQLite or MySQL. Admins open the menu with !admin in chat.

Before you start

  • Make a backup so you can go back if something goes wrong.
  • Have your SteamID64 ready (a 17-digit number that starts with 7656119).

What is CS2-SimpleAdmin?

CS2-SimpleAdmin is a CounterStrikeSharp plugin that adds an admin menu and commands for kicks, bans, mutes, gags, warnings and map changes. It stores bans and other penalties in a database, so they survive restarts. It is one of the most used CS2 admin plugins.

How to install CS2-SimpleAdmin

1

Install CounterStrikeSharp

Open Frameworks under COUNTER-STRIKE 2 in the sidebar and click Install CounterStrikeSharp. Metamod:Source is installed with it. Restart the server when it says Restart the server to load it.
Frameworks page with cards for SwiftlyS2, CounterStrikeSharp, Metamod:Source and gameinfo.gi, used to install CounterStrikeSharp before CS2-SimpleAdmin

The Frameworks page

2

Download the plugins

Download the latest release of each plugin from its official page:
3

Upload them

Click Files and open game/csgo/. Upload each .zip, click … next to it and choose Unarchive. Each plugin must end up in its own folder under game/csgo/addons/counterstrikesharp/plugins/. If a download already contains an addons folder, unarchive it in game/csgo/ so the folders merge.
4

Restart and check

Restart the server and type css_plugins list in the Console. All four plugins should be listed. They also appear on the Plugins page.
5

Make yourself an admin

Add your SteamID64 with the @css/root flag to admins.json and type css_admins_reload. See how to add admins in CS2.

How to connect CS2-SimpleAdmin to a database

The first start creates game/csgo/addons/counterstrikesharp/configs/plugins/CS2-SimpleAdmin/CS2-SimpleAdmin.json. Its DatabaseConfig section uses SQLite by default, a file on your server, and needs no setup. Use MySQL if you want to share bans between several servers or view them on a website.
1

Create a database

Click Databases in the sidebar, then Create database. Give it a name such as admin. See how to manage databases.
2

Copy the details

The database card shows HOST, DATABASE, USER NAME and PASSWORD, each with a copy button.
3

Edit the config

Open CS2-SimpleAdmin.json and fill in DatabaseConfig:
The HOST on the card ends in :3306. Put the address before the colon in DatabaseHost and 3306 in DatabasePort. Do not use 127.0.0.1 or localhost: the database does not run inside your game server.
4

Restart

Restart the server. Check the Console for database errors while it starts.

CS2-SimpleAdmin commands

Type commands in chat with ! (for example !ban) or in the console with css_. A #userid is the number shown by status. Admins in admins.json are reloaded with css_admins_reload instead.

Frequently asked questions

Why does CS2-SimpleAdmin not load?

Usually one of its three required plugins is missing or out of date. Type css_plugins list and check that MenuManagerCS2, PlayerSettings and AnyBaseLibCS2 are loaded, and that CounterStrikeSharp is up to date (click Reinstall on its card if not).

Why can’t SimpleAdmin connect to MySQL?

The host is wrong or the password changed. Use the address from the Databases card, not 127.0.0.1. If you clicked Rotate password, paste the new password into the config and restart.

Do I need MySQL?

No. SQLite works on a single server without any setup. You only need MySQL to share data between servers or with a website.

Is there a one-click install?

No. The Plugins page shows installed plugins with a switch for each, but you upload plugins yourself with the file manager.

My plugins stopped after a CS2 update. What now?

Open Frameworks and click Repair gameinfo.gi, then restart. See repair gameinfo.gi after a CS2 update.

CS2 server guide

Every Counter-Strike 2 guide in one place.

Add admins in CS2

admins.json, flags and reloading.

Install CS2 plugins

Upload plugins and use the Plugins page.

CS2 server commands

Built-in console commands.

Manage databases

Create a MySQL database for plugins.
Reviewed by the FREAKHOSTING team on 29 October 2026. Game Panel steps were checked on our panel (Counter-Strike 2 with CounterStrikeSharp 1.0.378); game and plugin details follow their official documentation. Steps may differ slightly if the game or its plugins change.


Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: October 2026