Server Setup

Setting Up the XTABLES Server

This guide outlines the steps for setting up the XTABLES server on your system.

Prerequisites:

• Java 17 or higher: XTABLES requires Java 17 or a later version to function. You can download and install Java from the official website: https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html

Server Startup

1. Locate the XTABLES Server JAR:

   • Navigate to the directory where the XTABLES server JAR file (XTABLES.jar) is located. This file can be obtained from the XTABLES project repository: https://github.com/Kobeeeef/XTABLES

2. Open a Terminal or Command Prompt:

   • Open a terminal or command prompt window depending on your operating system. Navigate to the directory containing the XTABLES.jar file using the cd command. For example:

   cd /path/to/xtables/directory

3. Start the Server:

   • Execute the following command to start the XTABLES server:

   java -Djava.net.preferIPv4Stack=true -jar XTABLES.jar {port}

   • Explanation:

     • java: This invokes the Java runtime environment.

     • -Djava.net.preferIPv4Stack=true: This optional flag enforces the use of an IPv4 network stack for communication, which might be necessary in specific network environments.

     • -jar XTABLES.jar: This specifies the XTABLES server JAR file to be executed.

     • {port} (Optional): This is an optional parameter where you can define a custom port number for the server to listen on. If omitted, the default port 1735 will be used.

Example

To start the XTABLES server on the default port 1735, use the following command:

java -Djava.net.preferIPv4Stack=true -jar XTABLES.jar

Additional Notes:

• The server startup process might display informational messages on the console window. These messages can help troubleshoot any issues that may arise.

• By default, the XTABLES server will listen for client connections on all network interfaces. However, if you specify a custom port number, ensure firewall rules allow incoming connections on that port.

Web Interface

The XTABLES server also hosts a local web interface at port 4880. This interface allows you to:

• Manage Clients: You can view a list of connected clients, kick them from the server, and get detailed information about their machines.

• Request Information: See the number of requests each client has made.

• Circular Buffer: View the contents of the circular buffer assigned to each client (each size is dependent on the client).

• Server Information: Get detailed information about the XTABLES server itself.

• Server Reboot: Initiate a server reboot from the web interface.