This is an old revision of the document!
Table of Contents
First steps
Congratulations on becoming a newfangled subcon citizen! This guide will help you get on your way and inform you about what there is to do in Subcon Town.
First off, praise SSH
While Subcon has a number of services that can be accessed from a web browser, the bulk of the fun is to be had on the server itself. For that, you'll require SSH access. Fortunately, by the time you're reading this, you should already have had a small introduction about it while setting up your keys for authentication. If not, don't worry, that will happen sooner or later.
First off, to login with SSH, you will need an SSH client. If you are using Linux, this will likely be already installed by default; for other operating systems, you will have to install a suitable client yourself. Below we will provide instructions for Windows, MacOS and Linux.
For windows users
Windows users will need to install a suitable client to connect to SSH. While any will most likely do, we recommend PuTTY to begin with if you have little experience with SSH. While it may look less-than-simple, it has been the goto SSH tool for Windows for ages now. It offers a lot of settings, but for basic connectivity there's only a few you'll need to set.
When opening PuTTY, you'll be met with the session options. Here you'll need to enter the host name and port that PuTTY should connect to. You may also save and load sessions here, for easier connecting next time.
Next, you'll need to set up your connection settings. Proceed to Connection > Data and fill out the auto-login username field with your given username. This will make PuTTY automatically login with your username. Leaving this blank means you'll have to type in your username at the login prompt once you connect.
Proceed to Connection > SSH > Auth to set up your private key for the connection. Ifyou do not yet have a keypair, you can generate one with the PuTTYgen tool. Subcon will only accept connections authenticating with a key, so it's imperative that you have one. Once you have a public/private keypair, click Browse…and select your private key file. They usually end in the .ppk extension.
And that's all! Going back to the Session options, be sure to save your session for easy use next time. Once done, click Open to connect to Subcon Town!
You'll be greeted with the terminal prompt. If your key requires a password, you'll be asked to enter it now. After that, you'll be logged in and ready to go.
For MacOS users
–
For Linux users
–
What to do next?
So, you have logged in and are ready to use the system. So, what to do next? Good question, so below we will list a number of guides for the different programs and services that we have running. Each will have a dedicated page on this wiki with more detailed information for you to read. Note however that it's not necessary to read it all; everyone uses the system in whatever way they like, using whatever services they have use for.
How to Linux 101
If you are new to Linux, this guide will be essential to you. Here we will explain to you the basic commands for navigating and working with the filesystem, how to edit files, as well as explain some things that are in your personal home directory.