Logging in to the System Console
While console login as root is permitted with LiquidFiles. That does not mean that making any changes are supported.
If you login to the console, it is assumed that you know what you are doing and are comfortable administrating Unix/Linux/Ubuntu systems.
If anything happens and you don't know how to fix it, you will likely have to re-install the LiquidFiles system to get back to a supported state.
How do I login to the console in LiquidFiles?
Every system has a console, either you have a physical system to which you connect a keyboard and monitor, or you have a virtual system where the virtual system provides the console somehow. In VMware ESX for instance, there's a console tab.
![VMware ESX Console Example](/assets/images/system/console_esx_v4-d82dbb6d450f198ef482446424827ee1f5a37a001dbda9da6f34bfbd2a73a7c05a61552b6dfab277416c55915127c01b543c6875920985200d92892aa150cf01.png)
After you've clicked on the console tab (or where the console is located in your virtual system), you can click F1 (or ESC and F1 on some hosts) to get to the login prompt.
Root password
You login as the user root. There's no default root password. You set the root password in Admin → System → Console Access. If you're using a virtualization system such as Hyper-V, VMware or a physical server you can login with the username `root` and the root password set in the Root Password section.
![Setting the Root password](/assets/images/system/console_root_password_v4-c3b2f9788c0858932a808c5d9acac7a34e1001abaae9940c2bc435d529fbf5f4dac8f1e6d6d1e0305c6f492de48f0fea5d022972cf8d67125fb435054d37e490.png)
Reset Root password
If you don't remember the root password, you need to reset it. To reset the Root Password, please go to Admin → System → Console Access. Click on the Root Password Tab and you will see the instructions there:
![Setting the Root password](/assets/images/system/reset_root_password_v4-63c6efe40212c0dc19bd19563742474f205224dbcd64b650f7517abf27ab328e51a76823590812f993b32ae3a1ca990e4fba5bf2f57b51df8f8e5982a9beb61c.png)
SSH Login - for versions 2 and 3 ONLY
You can also use SSH with an SSH client like Putty (if you're using Windows).
When logging in, you need to enter the hostname or ip address of the LiquidFiles system, and specify TCP port 222 as per the screenshot below (LiquidFiles v2.x and earlier used TCP port 22 for SSH). For login use root super user. Only when login to LF versions 3 or 2:
![SSH Putty Example](/assets/images/system/putty-617ad42b2c22337003cc3b3ce84f71fe077be8175ffdd14334abd2daa6a2433a797198dab7ec68a653063ebddc5c553ccc3cb10823c3824b78e6ea795144d7d0.png)
The equivalent example on a Unix/Linux system would be:
user@system% ssh -p 222 root@172.16.5.131
SSH Login with SSH keys - mandatory for Versions 4 and instances in AWS and Azure cloud
Since LiquidFiles v4 you can login only with SSH keys. Login as root with password is not supported now via SSH. To login to the command line on a LiquidFiles instance you will need to generate ssh keys for on-prem instances out of the LiquidFiles box (i.e. with ssh-keygen or Putty Key Generator). If you have LiquidFiles running in AWS or Azure cloud then use the ssh keys you had generated/assigned to that instance during the initial deployment.
In the Windows based Putty client, you need to have the ssh keys in PPK format. In case you have the SSH keys in OpenSSH PEM format you will need to convert them to the PPK format. This needs to be done by loading the private key in PEM in the Putty Key Generator and save it a PPK file.
![SSH Putty Key Generator](/assets/images/system/putty_key_generator_v4-f37fcb9ea60f80c180d3b7d3cadffa61bf39c507359a20d1cca936a69cf1f28003c51f5300b41e293fcc07a70925b8bec8c628d41fb2d71941869bfb7426493a.png)
The public key in PEM format which is also shoved in the Key Generator copy to a clipboard and paste under the Admin → System → Console Access → SSH authorized Keys tab on the LF server:
![Authorized Key tab](/assets/images/system/authorized_keys_v4-db6264975ad9dd5e0a2026412f34c6748693461b3a7241786ca73fdabec9bfb962ca96e07fff9fa6f4a4aa3dd5720e7dcf0767371f8124df9f16b22261018293.png)
Now when the SSH keys have been converted in the PPK format you can continue with the Putty client setup. You need to enter the hostname or ip address of the LiquidFiles system, and specify TCP port 222, and the liquidfiles system user as per the screenshot below.
![SSH Putty login with ssh keys Example](/assets/images/system/putty_v4-2e874e4438eaf91446b4c45dfd3a025fb9ace1f28de5f3bf31d6ca548a25362725685a6d62daaa79cb4839dbb0fc5301bd1c49585c9015c02e68d90a4f40545c.png)
Select the PPK file to use by selecting Connection → SSH → Auth → Credentials → Private key file for authentication as in the screenshot below:
![SSH Putty SSH Key Authentication](/assets/images/system/putty_ppk_key_v4-6f13085b716f6f59e56526a41bff90c248f52f9ae76ceb360f23ce6fced1cb1ed4af70b0ec1f6483b1513b16a1848d6a89200f5a930dda5166f3773b5751bbc9.png)
Depending on LiquidFiles version when you first installed LiquidFiles, the username to use when logging in is liquidfiles.
To become root (superuser), after you've logged in please run:
[liquidfiles@liquidfiles ~]$ sudo bash
The equivalent example on a Unix/Linux system would be:
user@system% ssh -p 222 -i /path/to/private_ssh_key liquidfiles@liquidfiles.mycompany.com
SSH Access Control
If you wish to limit SSH Logins to certain hosts and networks, please go to Admin → System → Console Access. You'll see the following screen:
![SSH Access Control Configuration](/assets/images/system/ssh_access_control_v4-908c8f7423a3d265a4fe3c10454577cf356a6f604e9f4ad1fe833d06632cd7b2a36fad202a6e3a88bcad73a5b1aded56f8ee13d51ba30eb200a7d23545d95d0b.png)
As per the screenshot, you can limit logins to this LiquidFiles system from certain hosts, ip addresses or networks. This is very useful if you have a general open network and all admin PC's on a specific network.