vern
/
wiki
3
4
Fork 4
Code Issues Pull Requests Packages Projects Releases Wiki Activity

feat: finish matrix guide and partially transcribe SSH guide

This commit is contained in:
Leo Gavilieau 2023-05-22 07:45:14 +02:00
parent 9072ce1f18
commit b03d6719d7
No known key found for this signature in database
GPG Key ID: 9F86E792898BD16B
2 changed files with 95 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
content/en/guides/matrix.md
View File

@ -1,3 +1,22 @@
---
title: "How to use Matrix"
---
---
Matrix is a decentralized end-to-end encrypted Instant Messaging platform, this means that no one can spy on your messages, no one person or company single-handedly controls the entire network and you can message your friends like you would on Discord, Skype or WhatsApp. In fact, it is an ethical alternative to those proprietary platforms.
~vern hosts a Matrix instance, which means you can get a `@YOUR_USERNAME:vern.cc` account, and anyone else who uses Matrix (even on other servers) can talk to you using this address and vice versa. And ~vern also hosts many clients, a client is the actual chat program that lets you send and receive messages easily.
To get started, register a [~vern account](/guides/register/) and make sure to select "Matrix" as one of the services, if you did not enable "Matrix" then [contact the ~vern admins](/staff/#admins) and ask them to create an account for you.
~vern hosts a frontend called Element, this frontend is very user-friendly and you only need a web browser, there are other clients or frontends for mobile devices but we are not gonna talk about them here, just make sure the client you want to install is ethical and free software. If you use a proprietary or unethical one then be aware since it will have full access to your Matrix messages.
If you want to use Element, go to [riot.vern.cc](https://riot.vern.cc) and login with your username and password. Your Matrix username is usually your ~vern username. If you do not know your ~vern username then you can probably find it in the email you received from the ~vern admins. If you do not remember your password then you can [contact the admins](/staff/#admins) for help.
Now you will be presented with the Element dashboard, and you might notice how similar it is to Discord, Element looks and functions a lot like Discord so Discord users should have an easy time migrating and getting used to it. But Element is a very simple interface and it is easy to learn even if you do not know Discord.
You also might have noticed an invite to something called the "~vern Matrix Space" or "~vern Space", basically this space is ran by the ~vern administrators and it is a group for ~vern members to talk in. Anyone (irregardless of whether they are a ~vern member or not) can join and talk in this space but it is primarily for ~vern users. You can also contact the admins here but make sure to start a Direct Message if what you are talking about is sensitive (such as password recovery and whatnot)
One word of caution is that if you join too many rooms then it will take too long to synchronise messages every time you log in. Try to keep your room list tidy or you will be experiencing lag everytime you log in.
Have fun!

76
content/en/guides/ssh.md
View File

@ -1,3 +1,77 @@
---
title: "How to use SSH"
---
---
SSH stands for Secure SHell, it allows you to connect to ~vern's servers and run commands and whatnot.
You can also upload your website in the `public_html` folder and it will be available at `YOUR_USERNAME.vern.cc` or `vern.cc/~YOUR_USERNAME`
We have a dedicated guide on how to upload user sites, it can be found [here](/guides/usersites/) but this guide primarily focuses on how to actually connect to the ~vern SSH server, which is neccessary to upload user sites and whatnot.
This article assumes you have registered an account with ~vern and generated a public key. If you do not have an account at ~vern then you can check out [this page](/guides/register/) on how to create an account and an SSH key.
## GNU/Linux users
Download OpenSSH from your distribution's repositories, if you are using Debian or Ubuntu then you can run this command: ''apt install openssh-client''
Then simply run ''ssh YOUR_USERNAME@vern.cc'' to connect. At this point, SSH might ask you to verify a "fingerprint", make sure the fingerprint on your terminal matches one of these:
* SHA256:03UCtjS9J+Hh77jHBWdevkd8dSg2Cnwo4HknGkRcZLk.
If it does match it then you can safely type yes but if it does NOT match it then you must be careful. Someone could be performing a Man-in-the-middle attack on you.
When you finally connect, you will be presented with a shell, here you can type commands and do whatever you want (as long as you do not violate the rules)
===== BSD Users =====
The procedure should be similar to the one in GNU/Linux. OpenBSD and FreeBSD include OpenSSH by default. NetBSD users can get ''security/openssh'' from pkgsrc.
===== MacOS users =====
The procedure should be similar to the one in GNU/Linux. SSH is pre-installed on most modern MacOS versions. If it isn't, you can get it via homebrew.
===== Windows users =====
Although the Admins do not recommend the use of the Microsoft Windows operating system, we recognize that lots of people everyday use it and it also deserves a tutorial.
But please know that the article author hasn't used the Microsoft Windows operating system for 3 years and that he does not know how it works. So if this tutorial doesn't work then please contact him [[https://xmoo.vern.cc/contact/|using one of the contact methods from his website]] so he can fix it. Thanks!
Windows 10 automatically includes SSH by default and you do not need to use PuTTY for it to work.
==== Windows 10 Users ====
This guide assumes you have setup an SSH environment with your ~vern SSH key. If you have not then please set it up now using many tutorials available online.
Open a command prompt and type "ssh.exe YOUR_USERNAME@vern.cc" (Replace YOUR_USERNAME with the username you registered with) and press enter.
At this point, you will be asked to verify a fingerprint. So make sure the fingerprint on your screen is exactly the same as the following one:
* SHA256:03UCtjS9J+Hh77jHBWdevkd8dSg2Cnwo4HknGkRcZLk.
If it is the same then you can safely proceed by typing "Yes" and pressing enter, if it is not the same then proceed with caution, someone could be launching a Man-in-the-middle attack and you need to be careful, try connecting to ~vern in a different time or location.
You should now be presented with a Unix command shell where you can type commands. Using this shell is beyond this tutorial and probably will get its own wiki page in the future but you can find lots of tutorials online on how to use a Unix shell.
==== Windows 8 or earlier Users ====
Windows 8 (or earlier) users will need to download PuTTY from [[https://www.chiark.greenend.org.uk/~sgtatham/putty/|this page here.]] if you already have PuTTY installed then you can proceed.
When PuTTY starts up, it will ask you to enter the server details, here you must enter the following:
* Username: YOUR_USERNAME
* Hostname: vern.cc
* Port: 22
* Protocol: SSH
Finally press Connect and PuTTY will connect to ~vern's servers.
At this point, you might be asked to verify a "fingerprint" so make sure that the fingerprint on your screen is the same as this one:
* SHA256:03UCtjS9J+Hh77jHBWdevkd8dSg2Cnwo4HknGkRcZLk.
If the fingerprint on your screen matches the above one then it is safe to click "Yes", if not then be careful, someone could be performing a "Man-in-the-middle attack" on you and it is not safe to proceed, try again later or in a different location.
Once you click "Yes" you will finally connect to ~vern safely and securely, and you will be presented with a remote shell where you can type a command, this is a Unix shell and you find many tutorials online on how to use them. Have fun!