Troubleshooting & Known Issues

xServer has some minor known issues, and here you can find a step by step of how to get around most errors.

The tag WIN is for Windows systems, TUX is for Linux systems.

Root Folder for WIN systems: %appdata%, you will see three x42 related folders here, Blockcore, xServer and xServerData.

Root Folder for TUX systems: ., you will see three x42 related folders here, .Blockcore, .xServer and .xServerData.

If you see the tag [WIN/TUX] these are fixes applicable to both systems.

a. The following workaround steps work for the following:

• Not being able to create a wallet
• Address Indexer not syncing
• Software not leaving initial block download (IBD) mode
• Not being able to get connections.

1. [WIN] (Optional) Make sure your PCs clock is properly synced, we highly advise users to install this software: https://www.timesynctool.com/
2. [WIN/TUX] Close your xServer software, make sure all x42 and blockcore related processes are not running. Navigate to /Blockcore/x42/x42Main.
3. [WIN/TUX] Navigate to /Blockcore/x42/x42Main/ and delete the txdb folder.
4. [WIN/TUX] (For Address Indexer issues) Delete addressindex.litedb.
5. [WIN/TUX] (For connection issues) Delete peers.json.
6. [WIN/TUX] Reboot your PC/VPS.

b. For problems with database connection:

1. [WIN/TUX] Close your xServer software, make sure all x42 and blockcore related processes are not running and navigate to /xServerData/Main and open your xServer.conf file with a text editor.
2. [WIN/TUX] Look for this line:

#connectionstring=User ID=postgres;Password=password;Host=localhost;Port=5432;Database=x42;

Edit out the # to activate the line, substitute the ‘password’ for your chosen password for the PostgreSQL database. It should look similar to this after your edits:

connectionstring=User ID=postgres;Password=YOUR-CHOSEN-POSTGRESQL-PASSWORD;Host=localhost;Port=5432;Database=x42;

3. [WIN/TUX] Save the xServer.conf file and re-open your client.
4. [WIN/TUX] If you are still having problems open your pgAdmin 4 (your version may be different) and navigate to: ‘Servers’ > ‘PosgreSQL 13 (your version may be different)’ > ‘Databases’. Delete ‘x42’ and/or ‘x42Main’.
5. [WIN] If you are still having issues reboot your PC/VPS.

c. Software not recognizing the creation of the server wallet:

1. [WIN] (Optional) Make sure your PC clock is properly synced, we highly advise users to install this software: https://www.timesynctool.com/
2. [WIN/TUX] Close your xServer software, make sure all x42 and blockcore related processes are not running.
3. [WIN/TUX] Navigate to /Blockcore/x42/x42Main/ and check if a x42ServerMain.wallet.json file has been created. If it has: Remove any delegated funds using your xCore client ‘Cold Staking’ interface and then delete said file. If it has not: Go to step 04.
4. [WIN/TUX] Delete the txdb folder.

d. If all else fails:

1. [WIN/TUX] Reboot your PC/VPS.
2. [WIN/TUX] Make sure all x42 and blockcore related processes are not running.
3. [WIN/TUX] If you have delegated funds to host your xServer already withdraw them using your xCore client.
4. [WIN/TUX] Safely backup the x42ServerMain.wallet.json.
5. [WIN/TUX] Delete the entirety of the /Blockcore/x42/x42Test folder, this will trigger a full resync of the blockchain, this may take several hours.

For more additional information and advanced help head to our discord #xserver-support channel that can be found here.