Skip to main content

Installation

DediConnect automatically installs everything required for hosting game servers.
This guide helps you connect your dedicated root machine with DediConnect.

Connect machine >

Connect machine 1

Prepare a Windows machine​

WINDOWS ONLY

These steps are for Windows only. For Linux machines, continue here.

Before a Windows machine can connect with DediConnect, it must run a script to update the system and prepare it for hosting game servers. If you're using a non-Windows machine, skip ahead to the "Connect with DediConnect" section.

1. Login with RDP​

Use Microsoft Remote Desktop to access your dedicated machine using the Administrator account and the password from your hosting provider.

Administrator user required

If your machine doesn’t have an Administrator account, learn how to activate it >

2. Open "PowerShell"​

Click the Windows Start button, type PowerShell, then hit Enter.

Windows install 1

3. Run command in PowerShell​

Copy the appropriate command for your OS, paste it into PowerShell, and press Enter. The script will run and automatically restart your machine when finished.

Windows Server 2019​
Invoke-WebRequest -Uri https://raw.githubusercontent.com/gameserverapp/Platform/main/Downloads/DediConnect/install-script_windows-server-2019.ps1 -OutFile .\install-script.ps1; .\install-script.ps1
Windows Server 2022​
Invoke-WebRequest -Uri https://raw.githubusercontent.com/gameserverapp/Platform/main/Downloads/DediConnect/install-script_windows-server-2022.ps1 -OutFile .\install-script.ps1; .\install-script.ps1
Wait for reboot

Let the script complete fully, this might take up to 30 minutes. Don’t close the PowerShell window. Wait for the machine to reboot. This could take up to 30 minutes.

4. Wait for machine to come back online​

Once your machine is back online, it's ready to connect with DediConnect.

Connect with DediConnect​

before you begin

Make sure your machine runs a supported OS and meets all requirements.
Windows machines must first run the GSA install script!

You can add a new machine from the machine overview page or by clicking the next to Machines.

Connect machine 1

1. Enter machine IP​

DediConnect will quickly scan your machine to check compatibility.

Connect machine 2

2. Enter credentials​

Enter your machine’s username and password so GSA can install and manage game servers and services.

We use AES-256 military-grade encryption to store your credentials securely.

Windows machine

Windows machines must run the GSA install script first before connecting.

SSH Key Auth (advanced users only)

Prefer key-based SSH login? Learn more here.
If not, don't worry—your machine will automatically switch to key-based authentication during setup.

Click Start installation when you're ready.

Connect machine 3

3. Installation​

Once installation begins, DediConnect will install all the required software. You'll receive an email when setup is complete.

Connect machine 4

4. Ready!​

Once the installation has finished you can start using your machine.

Install game servers and services >

Connect machine 5

💥 Troubleshooting 💥​

Activate "Administrator" user on Windows​

If the Administrator account is missing, follow these steps to activate it:

1. Login with RDP​

Use Microsoft Remote Desktop with the credentials from your hosting provider to connect to your machine.

2. Open "Computer Management"​

Click Start, type Computer Management, and press Enter.

Windows user 1

3. Locate "Users"​

Navigate to Local Users and Groups, then Users.

Windows user 2

4. Administrator properties​

Right-click Administrator, then select Properties.

Windows user 3

5. Enable the account​

Uncheck the Account is disabled option.

Windows user 4

6. Set Administrator password​

Right-click Administrator again and select Set Password.

Windows user 5

Then click proceed.

Windows user 6

7. Enter password​

Use the password you received from your hosting provider.

Windows user 6

8. Test the account​

Close your RDP session and log back in using the Administrator account to make sure its working properly.

Debian: Change language to English​

1. Login and run command​

Connect via SSH and run:

dpkg-reconfigure locales

2. Select English locale​

Choose en_US.UTF-8 UTF8 and hit OK.

Debian issue 1

then select en_US.UTF-8 and hit OK again.

Debian issue 2

3. Reboot and confirm​

Run:

reboot

After reboot, confirm the change by running:

env | grep LANG

Expected output: LANGUAGE=en_US:en

Debian issue 3

Windows: Change language to English​

1. Login with RDP​

Use Microsoft Remote Desktop and log in with the Administrator account.

Administrator user required

Missing the Administrator account? Activate it >

2. Open PowerShell​

Type PowerShell in the search bar or open it from the Start menu.

Windows change language 1

3. Run language change commands​

Copy/Paste and run:

Set-WinSystemLocale -SystemLocale en-US
Set-WinUILanguageOverride -Language en-US

Windows change language 2

4. Reboot​

Restart the machine. After reboot, the system should be in English and ready to connect.

Update Windows​

Update Windows before installing DediConnect, but not during installation.

1. Login with RDP​

Use the credentials from your hosting provider.

2. Search for updates​

Click Start, type update, and press Enter.

Windows update 1

3. Check/install updates​

Click Check for updates and install everything listed.

Windows update 2

4. Reboot if required​

Reboot your machine if needed to apply updates.

Windows update 3

caution

Ensure your machine is fully operational before connecting to DediConnect.

In this article