diff --git a/content/en/docs/How To Guides/_index.md b/content/en/docs/How To Guides/_index.md new file mode 100644 index 0000000..d17d45f --- /dev/null +++ b/content/en/docs/How To Guides/_index.md @@ -0,0 +1,7 @@ +--- +title: "How-to guides" +weight: 2 +date: 2023-03-14 +description: > + These are the guides on how to perform common tasks. +--- diff --git a/content/en/docs/How To Guides/root_ssh/_index.md b/content/en/docs/How To Guides/root_ssh/_index.md new file mode 100644 index 0000000..0ecf2b2 --- /dev/null +++ b/content/en/docs/How To Guides/root_ssh/_index.md @@ -0,0 +1,90 @@ +--- +title: "How to get root access via SSH" +weight: 2 +date: 2023-03-14 +description: > + If you need to manually perform some tasks, you can get root access via SSH. +categories: ["How-To Guides"] +--- + +To access your server's root shell you will have to generate your SSH key and add it to your server's authorized keys. + +## How to generate SSH key + +### Unix-like systems (PC) + +1. Open the terminal. +2. Run the following command: + ```bash + ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 + ``` + You will be asked to enter a passphrase. You can leave it empty, but it is recommended to use a passphrase. + If you do not want to use a passphrase, press **Enter**. +3. Print the public key to the terminal and copy it: + ```bash + cat ~/.ssh/id_ed25519.pub + ``` +4. Refer to the next section to add the key to your server. + +### Windows + +1. Open settings and under "Applications" click on "Manage additional components". +2. Press "Add Component". +3. Enter "OpenSSH client" in the search box and install it. +4. Open the Command Prompt. You can do this by pressing **Win+R**, typing `cmd` and pressing **Enter**. +5. Run the following command, replacing `user_name` with your Windows username: + ```ps1 + ssh-keygen -t ed25519 -f C:\Users\user_name\.ssh\id_ed25519.pub + ``` + You will be asked to enter a passphrase. You can leave it empty, but it is recommended to use a passphrase. + If you do not want to use a passphrase, press **Enter**. +6. Print the public key to the terminal and copy it: + ```ps1 + type C:\Users\user_name\.ssh\id_ed25519.pub + ``` + Once again, replace `user_name` with your Windows username. +7. Refer to the next section to add the key to your server. + +### Android (Termux) + +0. Install [Termux](https://termux.dev/en/). We recommend installing it from F-Droid. +1. Open Termux. +2. Run the following command: + ```bash + apt update -y && apt upgrade -y && apt install open-ssh -y && + ssh-keygen -t ed25519 -f /data/data/com.termux/files/usr/etc/ssh/ssh_host_ed25519_key + ``` + You will be asked to enter a passphrase. You can leave it empty, but it is recommended to use a passphrase. + If you do not want to use a passphrase, press **Enter**. +3. Print the public key to the terminal and copy it: + ```bash + cat /data/data/com.termux/files/usr/etc/ssh/ssh_host_ed25519_key.pub + ``` +4. Refer to the next section to add the key to your server. + +## How to add the key to your server + +0. Open the SelfPrivacy app. +1. Go to the "More" tab. +2. Tap on "Superuser SSH keys". +3. Tap on the "Create SSH key" button. +4. Paste the public key you copied earlier. +5. Tap on the "Create SSH key" button. +6. Open the Jobs list +7. Tap on the "Start" button. +8. In a few minutes, you will be able to access your server's root shell via SSH. + +{{< imgproc more-superuser Fill "1001x808">}} +{{< /imgproc >}} + +## How to access your server's root shell via SSH + +1. Open the terminal or Command Prompt. +2. Run the following command, replacing `server_ip` with your server's domain: + ```bash + ssh root@server_domain + ``` +3. Enter the passphrase you entered when generating the SSH key, if you used one. + +Be careful when using the root shell. If you do not know what you are doing, you can break your server or leak your data. +Responsibility for the consequences of your actions lies with you. Respect the privacy of other users. \ No newline at end of file diff --git a/content/en/docs/How To Guides/root_ssh/more-superuser.png b/content/en/docs/How To Guides/root_ssh/more-superuser.png new file mode 100644 index 0000000..c41b6e4 Binary files /dev/null and b/content/en/docs/How To Guides/root_ssh/more-superuser.png differ