Installation
DediConnect automatically installs everything required for hosting game servers. Learn how to connect your dedicated root machine with DediConnect.
Prepare a Windows machine
These steps are for Windows only. For Linux machines, continue here.
Before a Windows machine can connect with DediConnect, it must first run a script that will update the machine and prepare it for hosting game servers. If you are running a non-Windows machine, skip to the "Connect with Dediconnect" Section.
1. Login with RDP
Use Microsoft Remote Desktop to login on your dedicated machine using the Administrator
account and the password you received from your hosting provider.
Administrator
user requiredDid your machine come without a Administrator
user account?
2. Open "PowerShell"
Click the Windows Start
button and type Powershell
and hit enter
to open it.
3. Run command in PowerShell
Copy the command for your OS and paste it into PowerShell. Then hit enter
to execute it. When the script has finished it will restart the machine.
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
After hitting enter
it may take a while for the script to finish. Do not close the window. Wait for the machine to reboot, this may take up to 30 minutes.
4. Wait for machine to come back online
After the machine rebooted and it is operational it is ready to connect with Dediconnect.
Connect with DediConnect
Ensure the machine has a supported OS installed and meets the requirements. Windows machine must run the GSA install script first!
Add a new machine from the machine overview page or take a shortcut by clicking the next to Machines
.
1. Enter machine IP
The system will perform a quick scan to confirm your machine is compatible with DediConnect.
2. Enter credentials
Enter the username and password for the dedicated root machine. GSA needs this information to manage game servers and services on the machine.
We use AES-256
encryption (Military grade) to securely store the credentials.
Windows machine must run the GSA install script first before they can connect.
Prefer using key-based SSH authentication? Check out our information for SSH. Otherwise, no worries! Your machine will automatically move to an extra secure key-based authentication during installation.
Hit Start installation
when you're ready.
3. Installation
After clicking Start installation
DediConnect will install all the required software on the machine to host game servers.
You get an email when the installation is finished.
4. Ready!
When the installation finished you can start using the machine.
Learn how to install game servers and services >
💥 Troubleshooting 💥
Activate "Administrator" user on Windows
When your machine comes without a Administrator
user account you need to manually activate it.
1. Login with RDP
Login on your machine using Microsoft Remote Desktop. Use the IP address and credentials you received from your hosting provider.
2. Open "Computer Management"
Click the Windows Start
button and type Computer Management
and hit enter
to open it.
3. Locate "Users" overview
Click Local Users and Groups
and then click Users
.
4. Administrator properties
Right-click the Administrator
account and click Properties
.
5. Un-check Account is disabled
6. Set password for Administrator
Right-click the Administrator
account and click Set Password
.
7. Enter new password for Administrator
Enter the password you received from the hosting provider.
8. Test the new acount
Close the RDP connection and login again using the Administrator
user to confirm everything is working.
Debian change language to English
1. Login and run command
Login on your machine via SSH and run dpkg-reconfigure locales
2. Select en_US.UTF-8 UTF8
Select en_US.UTF-8 UTF8
and hit OK
.
Then select en_US.UTF-8
and hit OK
.
3. Reboot your machine & confirm changes applied
Restart your machine by running reboot
and wait for it to come back online. When it's online run env | grep LANG
to confirm it now says LANGUAGE=en_US:en
.
Windows change language to English
1. Login with RDP
Use Microsoft Remote Desktop to login on your dedicated machine using the Administrator
account and the password you received from your hosting provider.
Administrator
user requiredDid your machine come without a Administrator
user account?
2. Open Powershell
Type Powershell
in the search bar. If you don't have a search bar, click the Windows Start menu
button.
3. Run commands
Copy the commands below in Powershell and hit enter
. These commands will change the language of Windows to English.
Set-WinSystemLocale -SystemLocale en-US
Set-WinUILanguageOverride -Language en-US
3. Reboot machine
Restart the machine and confirm that the language changed when it comes back online. You can now connect the machine with GSA DediConnect.
Update Windows
You should update your Windows install before installing DediConnect. Do not do this while installing DediConnect.
1. Login with RDP
Login on your machine using Microsoft Remote Desktop. Use the IP address and credentials you received from your hosting provider.
2. Check for updates
Click the Windows Start
button and type update
and hit enter
.
3. Check for updates / install all
Depending on your system there may already be updates listed. If the machine indicates it is up-to-date you may want to click the Check for updates
button to be sure.
4. Restart machine
Some updates require the system to restart. You should do this before connecting it to DediConnect.
Make sure your machine is fully operational before trying to connect the machine with DediConnect.