• Examples (iOS)
• Examples (Android)
• Examples (C++)
Server API Documentation


» The Administration Tool

The Administration Tool, also known as AdminTool, is a powerful application for SmartFoxServer 2X remote monitoring and management. Its main features are:

The following paragraphs describe how to access the Administration Tool, how to connect to SmartFoxServer 2X and how to handle multiple server profiles, and give an overview on the AdminTool's user interface. The available administration modules are described in dedicated pages linked below.

>> Go to the MODULES <<

» Accessing the AdminTool

After completing the SmartFoxServer 2X installation successfully, in order to rapidly access the AdminTool point your browser to http://localhost:8080/admin/.

When the main connection panel is displayed (more on this in the next paragraph), you can connect to your local SFS2X instance immediately by entering the following details:

The predefined administrator (sfsadmin) should be removed as soon as possible, creating a new administrator user in the Remote Admin tab of the Server Configurator module (see below). This is very important in particular when the server is put online and can be accessed publicly.

» The connection panel

The connection panel is the first screen you will be presented after launching the AdminTool. It consists of a Connection tab and a Bookmarks tab.

Connection panel

The Connection tab allows the administrator to enter the connection details directly and access the server administration by pressing the Connect button:

The provided connection details are validated against the settings entered in the Remote Admin tab of the Server Configurator module to allow or deny the access to the user.

Communication between the AdminTool's client and the SFS2X instance can be encrypted by activating the Encrypt switch in the Connection tab. This requires SFS2X to be previously configured as described in the Protocol Cryptography document (in this case you don't have to configure a Zone's encryption settings, but enable AdminTool's encryption in the Remote Admin tab mentioned above).

If the Remember me switch is enabled, the connection details (except the password) are saved and the form is filled in automatically the next time the AdminTool is opened.

Bookmarks panel

The Bookmarks tab allows the creation of profiles in which the server connection settings can be saved (all except the password, for security reasons). In this way administrators can access several SFS2X instances within the same AdminTool (no matter where it is located) and without worrying about remembering IP/ports/usernames each time.

Bookmarks can be arranged into custom groups to better organize the profiles. When you double click an existing profile (or click the Use profile button after selecting a profile), it will bring you back to the Connection tab and populate all the fields: simply enter the password and click the Connect button.

Click on the Create/edit/remove group or profile buttons buttons to add, edit or remove a group (left column) or a profile inside the selected group (right column). The AdminToll makes use of the Flash Player's shared objects to save the bookmarks. By means of the Export profiles button and Import profiles button buttons it is also possible, respectively, to export the groups and profiles to an xml file, and import them back. This allows moving the profiles to other client machines without the need to re-enter them each time.

As an example, clicking on this link you can download a profiles file (unzip it to get the xml) to be imported in your AdminTool which contains the localhost connection settings mentioned in the Accessing the AdminTool paragraph above.

» The administration modules

After the successful connection to a SmartFoxServer 2X instance, the following administration modules are available. Click on the module's name to access its specific documentation. Modules can be ideally divided into two categories:

Monitoring tools

Dashboard Live server information (CPU, memory, traffic, threads, etc)
Zone Monitor Runtime monitoring of SFS2X Zones, Rooms and users
Analytics Reporting console per business data analysis
Ban Manager Advanced form for users banishment and ban lists management
Log Viewer SFS2X boot and runtime logs view and backup
BlueBox Monitor Runtime monitoring of HTTP-tunnelled connections

Configuration tools

Server Configurator Configuration of SFS2X global settings
Zone Configurator Creation and configuration of SFS2X Zones and static Rooms
Extension Manager Server Extensions files uploading
Servlet Manager Java Servlets uploading
License Manager SFS2X license setup and test

Modules can be loaded by clicking on their icons in the AdminTool's main header.

» The AdminTool's main interface

The following image shows the main user interface of the AdminTool.

AdminTool interface

The central zone of the interface is where the administration modules are loaded (faded in the image). The other relevant interface elements are:

  1. The left side of the header contains the icons of the modules described previously, displayed as tabs. Click one of them to load the corresponding module. A tooltip also shows the name and a brief description.
    The "save last" switch is also displayed at the right of the last tab. When enabled (green), the AdminTool "remembers" the last opened module and will load it automatically the next time it is accessed. If disabled, the AdminTool will load the Dashboard module by default.
  2. The top right corner shows the version of the SFS2X instance to which the AdminTool is connected.
  3. The Restart (orange) and Halt (red) buttons respectively stop the server and stop-restart it; of course this causes an immediate disconnection of the administrator [please read the notes in the box below].
  4. The Chat button shows the administrators' activity and chat panel. Using this panel, administrator connected to the same SFS2X instance can discuss in the internal public chat and check each other's activity: the table at the top of the panel shows each administrator's name, his connection time and the administration module he his currently using. If a chat message is received while the panel is collapsed, the button's icon blinks. Click the button again to close the chat panel.
  5. The Help button opens the current module's documentation in a new browser window.
  6. The Logout button closes the current connection to SFS2X and switches the view back to the connection panel.
  7. The title bar shows the server's host and port number followed by the current module's name; if a custom name is assigned to the SFS2X instance (see the Server Configurator module), it is displayed in the title bar too.
  8. The AdminTool's footer displays system messages, which are logged automatically after some seconds; red messages indicate specific errors or warnings.
  9. The Clear button Clear button has a dual usage: when the log is displayed (see J), it deletes the whole log; when the log is hidden, it removes the currently displayed system message (see H);
  10. the Log button Log button shows/hides the area where system messages are logged during the current AdminTool's usage session.


1) Supported operating systems: Windows, Linux, OSX.

2) When SFS2X is restarted using the AdminTool, a new process is created, which is not detected by the command line tool. This means that you can either control the server via command line or via AdminTool, but you can't mix the two.

3) During the restart process, some exceptions may be logged: this is normal and those exceptions are harmless, in fact you will be able to access your SFS2X instance using the AdminTool in a few seconds.

» Server updates

Starting from the AdminTool version shipped with SmartFoxServer 2X v2.1.0, a basic server version check system is provided. The AdminTool automatically checks if a new version of SFS2X is available on the website as a full installer or a patch. In case it is found, the version number in the header (see B above) is turned into a button: clicking it opens a panel showing the update details and a button to go to the download page (no automatic installation is provided).