Server Editor Account Setup

Preparing SSH key-pair

Windows

Open Command Line by typing cmd in menu start or in WIN+R.

Linux

If gui based, open Terminal from Applications/Utilities menu or usually CTRL+ALT+T key combination.

Mac

Look for Terminal in Applications/Utilities or type terminal in Search Spotlight

Generate OpenSSH key

NOTE: Providing your personal info is not mandatory and not advised. Skip through questions with enter leaving them blank.

1. In terminal window type: ssh-keygen -b 4096
2. You will be asked to "Enter file in which to save the key". Press enter for default location. (Advanced Users can customise that to their own ability).
3. If you already have key in given location don't agree to Override (Skip to Account Setup and Verification section).
4. Set passphrase when asked to, this will encrypt your key and act as a password. (Not mandatory step but highly recommended.
5. On success you will see:

Your identification has been saved in .../.../username/.ssh/id_rsa.
Your public key has been saved in .../.../username/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx username@hostname
The key's randomart image is

Proceed to Account Setup and Verification section.

NOTE: Private key id_rsa is your unique identity, this file should be kept secret and never shared with anyone. Public key from pair is stored in id_rsa.pub file. This will be used to setup ssh authentication.

Notify @🧰 Server Admin in #💠┃community-chat. Provide your id_rsa.pub key in direct message to admin handling your request.

While account is being set up head to PuTTY to prepare tunnel.

PuTTY Setup

**[Terminal SSH Session]** will work only when admin is done.

Convert OpenSSH key to PPK

1. Download [package](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) for your system and install.

2. Open __puttygen.exe__ from PuTTY installation directory.

3. Click __File__ > __Load private key__.

4. Change type of browsed file in bottom right from __PuTTY Private Key Files (\*.ppk)__ to __All Files (\*.\*)__ and select your **private** `id_rsa` key file.

5. Enter passphrase if asked to. On sucess you will see:

```

Successfully imported foreign key

(OpenSSH SSH-2 private key (old PEM format)).

To use this key with PuTTY, you need to

use the "Save private key" command to

save it in PuTTY's own format.

```

6. Click __Save private key__.

7. Save as .ppk preferably in same directory as your OpenSSH key.

SSH Tunnel

1. Open PuTTY.

2. Expand __SSH__ list on left panel.

3. In left panel expand __Connection__ > __SSH__ and click __Auth__.

4. Click __Browse__.

5. Select your converted .ppk private key. If you cant see __Browse__ in __Auth__, expand it and click __Credentials__. Its first field __Browse__.

6. In __SSH__ click __Tunnels__.

7. Set __Source Port__ to `server_port`.

8. Set __Destination__ to `127.0.0.1:5432`.

9. Click __Add__.

10. In left panel click __Session__.

11. Set __Host Name (or IP address)__ to `server_ip`.

12. Set __Port__ to `22`.

13. In __Saved Sessions__ field type in configuration name to store settings. For example `RenewalSSH`.

14. Click __Save__.

Alternatively if you don't plan to use PuTTY for anything else:

- Click __Default Settings__.

- Click __Save__.

After configuration is done use __Open__ to start SSH session.

When asked to*"Login as"*, type in your given username, then passphrase.

If you see `-bash` in last line then it works.

If Tunnel is working you can proceed to **[Chakratos Save Manager] Setup**.

Terminal SSH

NOTE: If you can't use [PuTTY] 1. Open Terminal application on your system (refer to *[your platform]*).

2. Connect by typing `ssh -L server_port:localhost:5432 username@server_ip` where username is your account name.

3. If you set passphrase to your key, enter passphrase.

Chakratos Save Manager

1. Download [Chakratos Save Manager](https://github.com/Chakratos/mhf-save-manager/releases) referred to as **CSM**.

2. Browse to **CSM** directory after unpacking.

2. Open `/www/config.sample.php` with editor of choice, like notepad.

3. Change __DBNAME__, __DBUSER__ and __DBPASS__ to match values in <#channel>

4. Save.

5. Rename `config.sample.php` to `config.php`.

6. Go back to main folder and run `phpdesktop-chrome.exe`

7. Optionally create shortcut to it on your desktop.