sbrl/Linux-101
1
0
Fork 0
Code Issues 1 Pull requests Releases Wiki Activity

rm files that arent needed and added new in progress slides
Some checks are pending
continuous-integration/laminar-eldarion Build failed with exit code 1 after 2 seconds
Details

Browse source
This commit is contained in:
Rowan Clark 2022-05-08 00:12:24 +01:00 committed by Matt Clark
parent 54659461c7
commit fef2f52ad1
No known key found for this signature in database
GPG key ID: 8347886807482CDA
56 changed files with 2 additions and 14893 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

78
.gitignore vendored
View file

@ -1,78 +0,0 @@
dist/
# ---> Node
# Logs
logs
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
# Runtime data
pids
*.pid
*.seed
*.pid.lock
# Directory for instrumented libs generated by jscoverage/JSCover
lib-cov
# Coverage directory used by tools like istanbul
coverage
# nyc test coverage
.nyc_output
# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
.grunt
# Bower dependency directory (https://bower.io/)
bower_components
# node-waf configuration
.lock-wscript
# Compiled binary addons (https://nodejs.org/api/addons.html)
build/Release
# Dependency directories
node_modules/
jspm_packages/
# TypeScript v1 declaration files
typings/
# Optional npm cache directory
.npm
# Optional eslint cache
.eslintcache
# Optional REPL history
.node_repl_history
# Output of 'npm pack'
*.tgz
# Yarn Integrity file
.yarn-integrity
# dotenv environment variables file
.env
# parcel-bundler cache (https://parceljs.org/)
.cache
# next.js build output
.next
# nuxt.js build output
.nuxt
# vuepress build output
.vuepress/dist
# Serverless directories
.serverless
# FuseBox cache
.fusebox/

3
.gitmodules vendored
View file

@ -1,3 +0,0 @@
[submodule "lantern-build-engine"]
path = lantern-build-engine
url = https://gitlab.com/sbrl/lantern-build-engine.git

643
201/Lab-Sheet.md
View file

@ -1,643 +0,0 @@
---
title: "Linux 201: Web Server Setup"
---
<!-- # Linux 201: Web Server Setup -->
## Introduction
Hello, and welcome to Linux 201! This Lab sheet will guide you through setting up a Linux-based web server, and look at a number of other useful aspects of server management and administration along the way.
If you follow this lab sheet to the end, you should:
- Understand the process of setting up a web server
- Understand why security is important when setting a web server.
- Have setup a basic web server to serve static files
If you have any questions, please ask! There should be a number of Freeside Admins experienced with server administration to help you out should you get stuck.
It is worth mentioning before we begin though that this lab sheet will _not_ be showing you how to do the following:
- Set up HTTPS - This requires that you have a domain name.
Despite this, links to some useful tutorials showing you how to do these things will be provided at the end of this lab sheet. In addition, you can always ask on the Freeside Discord or Forums, and we'll be happy to help you out:
- [Discord](http://discord.freeside.co.uk/) [^discord_invite]
- [Forums](https://forums.freeside.co.uk) [^forums] - Login with your Freeside account (or get one [here](https://profiles.freeside.co.uk/join) [^freeside_account]!)
[^discord_invite]: <http://discord.freeside.co.uk/>
[^forums]: <https://forums.freeside.co.uk>
[^freeside_account]: <https://profiles.freeside.co.uk/join>
Finally, before we get started, a word on the rationale behind the software we're going to be using in this tutorial. Firstly, Ubuntu Server is the server version of the highly popular Ubuntu Linux distribution - which has _heaps_ of support out there should you run into difficulties in the future after this lab. It's well tested, and great for beginners.
Secondly, we're going to be using _[Nginx](https://nginx.org/)_ as our web server here. Although most people may be heard of or perhaps even used _Apache_ before, _Nginx_ is the web server of choice here for several reasons:
- It's much higher performance than Apache
- It's event-based, not thread-based like Apache - which means it can handle more requests faster with a lower overhead
- It's more powerful than Apache - especially when you start getting into the more advanced use-cases.
- It's rapidly becoming (if not already) an industry standard
In short, skills in _Nginx_ will likely be much more useful in the future - especially when dealing with reverse-proxying to application servers, which will be a topic covered in _Linux 301_.
## Getting Started
This workshop will make use of a virtual machine running on the Department on Computer Science's cluster. 1 virtual machine has been allocated per student attending the workshop. To access it, click on the following link:
<http://www2.dcs.hull.ac.uk/people/cssaph/FreesideLinux201/>
Note that if you have turned up to the lab without having first filled out the registration form, you won't have access to a virtual machine. This is easily fixed however - simply talk to a Freeside Admin and they will get one allocated for you.
Once you've got access to your virtual machine, you can begin setting it up by following the instructions below. As it's a server, it won't have a graphical user interface. Instead, you'll be configuring it through the command line, or _terminal_ as it's known in the Linux world.
The Linux terminal (in this case) is _Bash_, and is very similar to the Windows command prompt, if you have any experience with that. There are a few command differences, but if you have experience with 1 then the other should feel at least somewhat familiar.
If you don't have command-line experience yet, don't worry! It's all part of the learning process. In short, on a command-line (or terminal), you enter text-based commands to tell the computer what you want it to do. Much like any other programming language, there are patterns and syntax rules - so try to look out for those. For example, things are always space-separated, and the first word is always the name of the command to execute:
```bash
nano myfile.txt
```
The above command launches the _nano_ text editor and tells it to open `myfile.txt`. If you forget the space, like this:
```bash
nanomyfile.txt
```
...then the server is probably going to get rather upset and throw an error:
```
nanomyfile.txt: command not found
```
Thankfully, the error message in this instance is fairly straight-forward and tells us what went wrong. In other cases the problem might not be so obvious, so don't forget that you can ask any of the Freeside Admins for assistance.
A good reference for Linux commands can be found here: <https://files.fosswire.com/2007/08/fwunixref.pdf>.
## Setting the hostname
The first thing we should do to our server is to give it a unique hostname. On _Ubuntu Server 18.04_, this is fairly easy to do:
```bash
sudo hostnamectl set-hostname INSERT_HOSTNAME_HERE
```
For this workshop, we'll use a standard naming convention. Please set your hostname to be the following:
```
linux201-server-XX
```
....where XX is the number of your server from the list linked to above. Notice the `sudo` in the command above. It's short for _super-user do_, and tells Linux that you want to run a command as an administrator. You'll have to type your password for this, which is a key security mechanism that's built-in to Linux. If you've been to _Linux 101_, it was explained in more detail there. For the curious, the Linux 101 slide deck can be found here:
<https://starbeamrainbowlabs.com/labs/Linux101/>
You might need to quickly restart your shell for this to take effect:
```bash
exec bash
```
You should now see that the prompt has changed to reflect the new hostname. If not, try rebooting:
```bash
sudo reboot
```
## Basic Security
`root` is the administrative account of Linux systems. Owing to the extremely broad permissions granted to root accounts, one of the core tenants of Linux security is ensuring each user has their own account.
This is because root can be used, even accidentally to damage or destroy the system because of its extensive permissions. Having separate accounts, such as "yourusername" also increases accountability and decreases the likelihood of system damage.
Normally, this is handled by your operating system installer, so you shouldn't need to create a new account manually here. If you'd like to rename the default user account here, this is how you'd do it.
_This section is optional. If you'd prefer, you can skip this section and move on to the next section, [setting your password](#setting-your-password)._
To create a new non-root account, do the following:
`sudo adduser "yourusername"`
We should create the new user as root, so don't forget to prefix it with `sudo` (though if you're already logged in as root, there's no need for `sudo`. You can tell if you're logged in as root by the last character in the prompt: if it's a dollar `$` then you're a regular user and need to use `sudo`, if it's a hash `#` then you're the root user).
Execute the command as above, replacing `"yourusername"` with a desired username.
During the setup, you may be asked for a password along with other information. You may customise this information as you wish.
Now that the user has been created, we should ensure that that user can execute commands with escalated permissions - i.e. as the `root` account. These are called `sudo` permissions. These can be assigned to your new account like this:
`sudo usermod -aG sudo yourusername`
Execute the command as above, replacing `"yourusername"` with the user you created in the previous step.
This adds your new user account to the `sudo` group of users on the system, which is a group of users permitted to use the `sudo` command to run commands as other users - including `root`.
At this point, you should be able to logout and log back in as the new user account you've just created - you should do this now.
If you're creating a new account to replace the default non-root user account, it's a good idea at this point to delete the old default user account now. This helps keep your VM secure, as fewer user accounts (note: system accounts are a different topic) mean fewer potential entry points for attackers.
Don't forget also that you should always know _why_ you're typing your password. This is a key security mechanism in Linux: anything that needs administrative privileges should be done through `sudo`, and `sudo` requires your password. If it didn't require your password, then _anything_ running under a user account that has `sudo` privileges would be able to run a command as `root` at any time, which is obviously a bad thing.
### Setting your password
If you didn't change the default user account that's come with your VM (or even if you did), you should probably change your account password. Leaving your account password as the default is the best way to invite an attacker in to hack your server.
Thankfully, this is really easy to do. Simply enter the following command:
```bash
passwd
```
It will ask you for your current password, and ten for a new password twice. Once done, try logging out and then back in again to see that your new password has been applied. Note that this will also affect things when you're using `sudo`: you should use your new password instead of the old one, since the password you use with `sudo` is synced with your local user account.
It's also worth mentioning at this point that storing said password in a secure _password manager_ would be a good idea, rather than writing it down in a text file. Password databases are encrypted with a master password, which is much more secure. Many password managers exist, from [KeePass](https://keepass.info/) to [Firefox Lockwise](https://www.mozilla.org/en-GB/firefox/lockwise/) to [BitWarden](https://bitwarden.com/), and many more.
### Securing SSH
At this point if you're still using the physical VMware console, it might be worth signing in to your VM via _SSH_. Standing for _Secure SHell_, it's used by servers and their administrators across the world to talk to one another. TO do this, you'll need the IP address of your server. Get this like so:
```bash
hostname -I
```
Then, open PuTTY **TODO: Finish this**
If someone manages to get in who isn't supposed to, they could do all kinds of damage!
The first, and easiest thing we can do it improve security is to prevent the `root` user logging in. We already have a non-root account that we use `sudo` with, so why allow direct access to `root` at all? Open `/etc/ssh/sshd_config` for editing like this:
```bash
sudo nano /etc/ssh/sshd_config
```
This will open the `nano` command-line text editor. Others exist, but they are either not installed by default or more difficult to use. You can navigate with the arrow keys. Find the line that says something like this:
```config
PermitRootLogin yes
```
....and change it to
```config
PermitRootLogin no
```
You may need to uncomment the line by removing the `#` symbol preceding it.
Once done, restart the ssh server like so:
```bash
sudo systemctl restart ssh
```
Your configuration might be slightly different (e.g. it might be `PermitRootLogin without-password`) - but the principle is the same. This adds an extra barrier to getting into your server, as now attackers must not only guess your password, but your username as well (some won't even bother, and keep trying to login to the `root` account!).
#### Key-based authentication
So we've created a new user account with a secure password (tip: use a password manager if you have trouble remembering it :-)) and disabled root login. Is there anything else we can do? Turns out there is.
Passwords are not the only we can authenticate against an SSH server. Public private keypairs can be used too - and are much more secure - and convenient - than passwords if used correctly. They are a pair of files on your computer, which are used when you try to login instead of a password. Without the private key, you can't login.
The exact way you do this depends on the operating system of the local machine you are using to connect to your server.
##### For Linux users
_If your **local machine** is a Linux computer, then this is the section for you. If your local machine is a **Windows** computer, then skip this section and move onto the one below entitled "For Windows users"._
If you are using Linux on your _local machine_ generate your own public-private keypair like so:
```bash
mkdir $HOME/.ssh
ssh-keygen -t ed25519
```
It will ask you a few questions, such as a password to encrypt the private key on disk, and where to save it. Once done, we need to tell `ssh` to use the new public-private keypair. This is fairly easy to do, actually (though it took me a while to figure out how!). Simply edit `~/.ssh/config` (or create it if it doesn't exist), and create (or edit) an entry for your ssh server, making it look something like this:
```config
Host {bobsrockets.com}
Hostname {ip_address}
Port 22
IdentityFile {path/to/private/keyfile}
```
Change `{bobsrockets.com}` to a short name that's easy to remember. You'll be able to SSH into your server later with `ssh short_name`.
Change `{ip_address}` to match the IP address of your server (or, if you're lucky enough to have a domain name pointed at your server, use that instead).
It's the `IdentityFile` line that's important - replace `{path/to/private/keyfile}` with the path to your key file (e.g. `~/.ssh/id_ed25519`).
With `ssh` configured, we can use a handy little utility called `ssh-copy-id` to copy the SSH public key to the server. Do that like this:
```bash
ssh-copy-id `{username}@{hostname}`
```
Where `{username}` is the username of the new user account you created earlier, and `{hostname}` is the short code from before when you editing your `~/.ssh/config` file.
##### For Windows users
_If your **local machine** is a Windows computer, then this is the section for you. If your local machine is a **Linux** computer, then skip this section and move onto the one below entitled "For Windows users"._
This section will assume that you are using [PuTTY](https://putty.org/) (<https://putty.org/>) to connect via SSH to your server. Content in this section is taken from [this DigitalOcean tutorial](https://www.digitalocean.com/docs/droplets/how-to/add-ssh-keys/create-with-putty/) [^putty_tutorial].
Start the PuTTYgen program through your Start Menu, or by launching the `puttygen.exe` portable executable. The key generation program looks similar to this:
![A screenshot of PuTTYgen.](images/puttygen.png)
_(Above: A screenshot of PuTTYgen. Taken from [this DigitalOcean tutorial](https://www.digitalocean.com/docs/droplets/how-to/add-ssh-keys/create-with-putty/) [^putty_tutorial].)_
[^putty_tutorial]: <https://www.digitalocean.com/docs/droplets/how-to/add-ssh-keys/create-with-putty/>
Set the key type to _ED25519_, and click the generate button.
You might be prompted to "generate some randomness by moving the mouse over the blank area". This randomness, known as _entropy_, is used to create keys in a secure fashion so that other people can't reproduce them.
![A screenshot of PuTTYgen generating some randomness.](images/puttygen-randomness.png)
When the key is generated, you’ll see the public key displayed in a text box. Save this somewhere safe for later. Be sure to scroll within the text area so you copy the entire key.
Next, you’ll be prompted to enter a passphrase for your SSH key. This improves security by preventing someone who gains access to your private key from using it without also knowing the passphrase. You’ll need to provide your passphrase every time you use this key (unless you use SSH agent software that stores the decrypted key).
![A screenshot of PuTTYgen asking for a password.](images/puttygen-password.png)
When you’re done, click the "save private key" button and select a secure location to keep it. You can name your key whatever you’d like, and the extension `.ppk` is automatically added.
If you have not entered a passphrase, you will be asked to confirm that you want to save the key without one. We strongly recommend using a passphrase, but you can press enter to bypass this prompt.
Next, you need to tell your server about your new SSH key. This is done by editing the `~/.ssh/authorized_keys` file. The `~/.ssh/` directory might not exist, so we may need to create that too. Do that like this:
```bash
mkdir ~/.ssh/;
nano ~/.ssh/authorized_keys
```
Of course, don't worry about any errors telling you that `~/.ssh/` already exists. Next, paste in your public key that saved earlier into the `nano` text editor. Save it and exit (Ctrl + X, then Y, then Enter), and then ensure it has the correct permissions like so:
```bash
chown -R username:username ~/.ssh
chmod 0700 ~/.ssh
chmod 0600 ~/.ssh/*
```
...replacing `username` with the username of the account you created earlier.
Now, try opening a new instance of PuTTY and logging into your server with the public key. Before hitting the login button, go to "Connection" -> "SSH" -> "Auth" and select your `.ppk` file.
If all is well, you should now be logged in with your new public/private keypair.
### Setting up a firewall
Firewalls control how data is allowed to travel in and out of your computer. In Ubuntu, a firewall called `ufw`, the 'uncomplicated firewall' is already present. It acts as a nice front-end to `iptables`, which I find to be difficult to understand and use. We will be using that as our firewall. If for some reason it is not installed already, install it like so:
```bash
sudo apt install ufw
```
### Activation
Ufw, by default, allows all outgoing connections and denies all incoming connections. This means that if you are using ssh to connect to your server, you will need to open the appropriate ports first *before* enabling ufw. Do that like this:
```bash
sudo ufw allow 22/tcp
```
Ufw will automatically configure `iptables` to allow incoming connections on port 22 that use `tcp`. I will talk more about allowing and denying different connections later.
Just in case ufw blocks your ssh connection and you are unable to get back in, you can use another program called `at` to schedule the disabling of the ufw so that you can get back in again. If you don't have it installed, you can install it with `sudo apt install at`.
```bash
sudo at -vM now +10 minutes
ufw disable
^D
```
Where `^D` stands for `CTRL + D`. Now that you have it set such that ufw will disable itself in 10 minutes time, we go ahead and turn ufw on:
```bash
sudo ufw enable
```
<!-- TODO: check that `yes` is the correct response -->
It will warn you that this may disrupt any existing ssh connections you have open. Reply `yes` to this. Once it have been enabled successfully, you should check that you can still ssh into your server (if that is the method that you are using to control it). If yes, great! If not, ufw will disable itself in 10 minutes and then you can try again.
Now that we have ufw enabled, we can cancel the `at` job we created to disable ufw. Type `sudo atq` to list the jobs you have schedules, and `sudo atrm <number>` to remove it, where `<number>` is the number of the jobs that you want to delete.
You may also want to check the status of ufw to make sure that it is enabled, or to get a list of the rules that are currently in force. You can do that like this:
```bash
sudo ufw status
```
```
Status: active
To Action From
-- ------ ----
22/tcp ALLOW Anywhere
22/tcp (v6) ALLOW Anywhere
```
#### Allowing connections
Since we're going to be setting up a web server, we'll need to allow it through our new firewall. Doing so is easy. Simply do this:
```bash
sudo ufw allow 80/tcp
```
Ufw will automatically configure iptables, in this example, to allow all connections on port 80 that use TCP. It will also configure it appropriately for both ipv4 and ipv6.
If you ever want to incoming connections on another port in the future, replace `80` with the port number you want to allow and `tcp` with `udp` if needed.
Ufw also understands several protocol names, and can configure itself accordingly:
```bash
sudo ufw allow http
sudo ufw allow imap
```
## Installing a Web Server
With our server secured, we can now install our web server. In this tutorial, we'll be using _[Nginx](https://nginx.org)_. Nginx is very powerful and [much more efficient](https://www.nginx.com/blog/nginx-vs-apache-our-view/) [^nginx_vs_apache] than Apache. This is done with `apt`, Ubuntu's package manager:
[^nginx_vs_apache]: <https://www.nginx.com/blog/nginx-vs-apache-our-view/>
```bash
sudo apt install nginx
```
The `apt` package manager manages the software and libraries installed on a Linux computer. Other package managers exist too, which are used in other distributions of Linux (such as _Arch Linux_, _Alpine Linux_, and _Fedora_). The concept is broadly similar to a package manager you might use to manage the dependencies of a program you're writing, such as [NuGet](https://www.nuget.org/) [^nuget] (for .NET) and [NPM](https://www.npmjs.com/) [^npm] (for Javascript).
[^nuget]: <https://www.nuget.org/>
[^npm]: <https://www.npmjs.org/>
Anyway, with Nginx installed, we should be able to test it out - just as soon as we allow it through our firewall:
```bash
sudo ufw allow http
```
### Testing it out
At this point you should bee able to type the IP address of your server into your web browser and see the default configuration page. You can obtain your server's IP address by using the `hostname` command like so:
```bash
hostname -I
```
<!--
This will produce a lot of output, so let's decode it. For an IPv4 address, we want to look at the bit directly after the word `inet` in the output from the command above for our server's ethernet network interface.
You may notice that the output follows a pattern, in which the unindented lines follow the pattern `number: interface_id blah blah blah......`. To identify the ethernet network interface, look for the entry in the output list that has an id that looks something like any of these:
- `eth0`
- `enp3s0`
- `enp2s5`
Note that you do **not** want any that look like this:
- `lo` (the local loopback interface - i.e. `127.0.0.1`)
- `wlan0` (WiFi)
Once identified, look for the `inet` keyword directly after the network interface id and before the next network interface id further down. The IP address will directly follow it. For example, if I had the following output:
```bash
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
link/ether 00:22:4d:ae:00:5a brd ff:ff:ff:ff:ff:ff
inet 1.2.3.4/24 brd 1.2.3.255 scope global eth0
valid_lft forever preferred_lft forever
inet6 67b0:daac:98ee:7951::1/128 scope global
valid_lft forever preferred_lft forever
inet6 fe80::f89:3729:c223:86da/64 scope link
valid_lft forever preferred_lft forever
```
....I could identify that my server's IP address is `1.2.3.4`, as `1.2.3.4` appears directly after the word `inet`, which appears a line or two below the line that starts with `2: eth0`.
-->
Another, but less reliable, way of finding your IP address is to use an online service. Such services report back to you your external IP address. If your server is located on a complex network, the IP address such a service reports may not be the local IP address of your server, however. You can utilise a service like this as follows:
```bash
curl https://icanhazip.com/
```
You might need to install `curl` with `sudo apt install curl`.
Once you have determined your server's IP address, enter it into your web browser like so: `http://1.2.3.4/`
You should see a page like this:
![The default web page that Nginx should serve.](images/nginx-default.png)
If you don't see something like the above, please ask for help.
### Customisation
Now that we've got our web server installed, we can customise it to our liking. This is quite easy to do. On Linux, almost everything is driven by configuration files. These are stored in the `/etc` directory - and Nginx is no exception. Nginx stores its configuration files in `/etc/nginx`. There a few important files and directories here:
File | Purpose
--------------------------------|---------------------------------
`/etc/nginx/nginx.conf` | The main configuration file. Global settings are defined here.
`/etc/nginx/sites-available/` | The virtual host configuration files. Put website configuration files here.
`/etc/nginx/sites-enabled/` | The enabled virtual hosts. This directory contains [symbolic links](https://linuxhandbook.com/symbolic-link-linux/) [^symlinks] to the `sites-enabled` directory.
[^symlinks]: https://linuxhandbook.com/symbolic-link-linux/
Nginx, like most web servers, can service multiple web servers at the same time. This is done by using a variety of techniques to determine what domain name you have entered into your address bar (namely the `Host` HTTP header and, in the case, of HTTPS, [Server Name Indication](https://en.wikipedia.org/wiki/Server_Name_Indication) [^sni]). To this end, it supports multiple _virtual hosts_ - which are basically configuration files that tell it which website to serve under which circumstances.
[^sni]: <https://en.wikipedia.org/wiki/Server_Name_Indication>
Try looking at some of the different configuration files in the `/etc/nginx` directory to get a feel for how it works - particularly `/etc/nginx/nginx.conf`.
In our case, we already have a default virtual host created for us. It's located in `/etc/nginx/sites-available/default`. Open it for editing now:
```bash
sudo nano /etc/nginx/sites-available/default
# or, if you're a `vim` user:
sudo vim /etc/nginx/sites-available/default
```
`nano` is usually best for beginners, as it's easier to use. You might see something like this:
```bash
##
# You should look at the following URL's in order to grasp a solid understanding
# of Nginx configuration files in order to fully unleash the power of Nginx.
# https://www.nginx.com/resources/wiki/start/
# https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/
# https://wiki.debian.org/Nginx/DirectoryStructure
#
# In most cases, administrators will remove this file from sites-enabled/ and
# leave it as reference inside of sites-available where it will continue to be
# updated by the nginx packaging team.
#
# This file will automatically load configuration files provided by other
# applications, such as Drupal or Wordpress. These applications will be made
# available underneath a path with that package name, such as /drupal8.
#
# Please see /usr/share/doc/nginx-doc/examples/ for more detailed examples.
##
# Default server configuration
#
server {
listen 80 default_server;
listen [::]:80 default_server;
# SSL configuration
#
# listen 443 ssl default_server;
# listen [::]:443 ssl default_server;
#
# Note: You should disable gzip for SSL traffic.
# See: https://bugs.debian.org/773332
#
# Read up on ssl_ciphers to ensure a secure configuration.
# See: https://bugs.debian.org/765782
#
# Self signed certs generated by the ssl-cert package
# Don't use them in a production server!
#
# include snippets/snakeoil.conf;
root /var/www/html;
# Add index.php to the list if you are using PHP
index index.html index.htm index.nginx-debian.html;
server_name _;
location / {
# First attempt to serve request as file, then
# as directory, then fall back to displaying a 404.
try_files $uri $uri/ =404;
}
# pass PHP scripts to FastCGI server
#
#location ~ \.php$ {
# include snippets/fastcgi-php.conf;
#
# # With php-fpm (or other unix sockets):
# fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
# # With php-cgi (or other tcp sockets):
# fastcgi_pass 127.0.0.1:9000;
#}
# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
# deny all;
#}
}
# Virtual Host configuration for example.com
#
# You can move that to a different file under sites-available/ and symlink that
# to sites-enabled/ to enable it.
#
#server {
# listen 80;
# listen [::]:80;
#
# server_name example.com;
#
# root /var/www/example.com;
# index index.html;
#
# location / {
# try_files $uri $uri/ =404;
# }
#}
```
There's a lot of 'stuff' here, so let's break it down. Nginx works on the concept of servers. Each virtual host has it's own `server { }` block in a configuration file inside `/etc/nginx/sites-available`. Lines that start with a hash `#` are comments - and are ignored by Nginx (just like Python and Bash comments).
The `listen` directives tell Nginx to listen on Ipv4 and IPv6 for requests.
The `root /var/www/html;` directive tells Nginx where to find the files that it should serve. For our example, let's change this from `/var/www/html` to `/srv/www`.
The `location { }` blocks allow us to tell Nginx to do specific things for specific subdirectories. They are quite complex, and are out-of-scope of this workshop. However, the default configuration file contains some links that you can use to find out more - and you can always ask on the [Freeside Discord](http://discord.freeside.co.uk/) [^discord_invite] too.
You may wish to enable [directory listing](https://nginxlibrary.com/enable-directory-listing/) [^dir_listing], so that if Nginx does not find an `index.html` file it will list the contents of the directory instead. You can do this by creating a new line directly below the `root` directory like so:
[^dir_listing]: <https://nginxlibrary.com/enable-directory-listing/>
```nginx
autoindex on;
```
Once you've finished editing the file, save and close it with **Ctrl + X**, then **Y**, then **Enter** (if using `nano`), or **Esc** followed by typing `:wq` for `vim`.
With the configuration file edited, we should restart Nginx. Before we do that though, let's test that configuration file:
```bash
sudo nginx -t
```
If all goes well, Nginx should say something like this:
```
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
```
If it doesn't, then go back and check the syntax of the configuration file you edited. You might want to ask for help.
Before we reload Nginx though, we need to create that new web root directory we decided on earlier. Let's do that now:
```bash
sudo mkdir /srv/www
sudo chown -R www-data:www-data /srv/www
sudo chmod 0775 /srv/www
```
With that in place, you can now reload Nginx like so:
```bash
sudo systemctl reload nginx
```
This will cause Nginx to reload it's configuration files from disk without restarting. Not all services support this, but if they do it's handy to take advantage of it.
The final step here is to upload some files to your new web server to serve. To do this, we will need to ensure that our user account has permission to write to the new folder. Do tha like this:
```bash
sudo usermod -a -G www-data YOUR_USERNAME_HERE
```
This adds your user account to the `www-data` group. You will need to log out and log back in again at this stage for the change to take effect.
Actually uploading files can be done using SFTP. Windows users can use [WinSCP Portable](https://winscp.net/eng/docs/portable) [^winscp], while Linux users can use their native file manager (try entering `sftp://username@1.2.3.4/` into your address bar).
[^winscp]: <https://winscp.net/eng/docs/portable>
Once you have uploaded some files to your web server, try refreshing your web browser! You should see your new website appear before your eyes.
## Conclusion
We've looked at setting up a basic Linux web server with Ubuntu Server 18.04 and Nginx. We've done this by first taking some basic steps to secure our server, and then installing and configuring the necessary software.
This workshop should provide you with a good starting point from which to explore more complex uses for Linux. For example, you could now use your new web server to serve a [personal static website and blog](https://www.staticgen.com/) [^staticgen], or you could take your skills further and learn about containerisation technologies such as [LXD](https://linuxcontainers.org/lxd/) [^lxd] and [Docker](https://www.docker.com/) [^docker]. You could even learn how to deploy your own application to a Linux server using a [system service](https://starbeamrainbowlabs.com/blog/article.php?article=posts/326-systemd-service-files.html) [^system_service] and [syslog](https://starbeamrainbowlabs.com/blog/article.php?article=posts/345-logrotate.html) [^logrotate] - the possibilities are endless!
[^staticgen]: Static site generator comparison: <https://www.staticgen.com/>
[^lxd]: <https://linuxcontainers.org/lxd/>
[^docker]: <https://www.docker.com/>
[^system_service]: <https://starbeamrainbowlabs.com/blog/article.php?article=posts/326-systemd-service-files.html>
[^logrotate]: <https://starbeamrainbowlabs.com/blog/article.php?article=posts/345-logrotate.html>
Be sure to join the [Freeside Discord](http://discord.freeside.co.uk/) [^discord_invite], where you can learn more about Linux and hang out with other Linux users.
## References and Further Reading
- [Linux command reference](https://files.fosswire.com/2007/08/fwunixref.pdf) (<https://files.fosswire.com/2007/08/fwunixref.pdf>)
- [Learn your terminal (or command line)](https://starbeamrainbowlabs.com/blog/article.php?article=posts/242-Learn-Your-Terminal.html) (<https://starbeamrainbowlabs.com/blog/article.php?article=posts/242-Learn-Your-Terminal.html>)
- [Nginx](https://www.nginx.com/) (<https://www.nginx.com/>)
- [How to Secure a Linux Server](https://github.com/imthenachoman/How-To-Secure-A-Linux-Server/) (<https://github.com/imthenachoman/How-To-Secure-A-Linux-Server/>)
- [SSL Certificates](https://letsencrypt.org) (<https://letsencrypt.org>)
- [How to secure Nginx with Let's Encrypt on Ubuntu Server 18.04](https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-18-04) (<https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-18-04>)
- [Freeside Discord Invite](http://discord.freeside.co.uk/) (<http://discord.freeside.co.uk/>)
- [Static Site Generators Comparison](https://www.staticgen.com/) (<https://www.staticgen.com/>)

532
201/images/feedback.svg
View file

@ -1,532 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.1" baseProfile="full" width="328" height="328" viewBox="0 0 328 328"
xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ev="http://www.w3.org/2001/xml-events">
<desc></desc>
<rect width="328" height="328" fill="#ffffff" cx="0" cy="0" />
<defs>
<rect id="p" width="8" height="8" />
</defs>
<g fill="#000000">
<use x="32" y="32" xlink:href="#p" />
<use x="32" y="40" xlink:href="#p" />
<use x="32" y="48" xlink:href="#p" />
<use x="32" y="56" xlink:href="#p" />
<use x="32" y="64" xlink:href="#p" />
<use x="32" y="72" xlink:href="#p" />
<use x="32" y="80" xlink:href="#p" />
<use x="32" y="128" xlink:href="#p" />
<use x="32" y="136" xlink:href="#p" />
<use x="32" y="144" xlink:href="#p" />
<use x="32" y="160" xlink:href="#p" />
<use x="32" y="200" xlink:href="#p" />
<use x="32" y="216" xlink:href="#p" />
<use x="32" y="240" xlink:href="#p" />
<use x="32" y="248" xlink:href="#p" />
<use x="32" y="256" xlink:href="#p" />
<use x="32" y="264" xlink:href="#p" />
<use x="32" y="272" xlink:href="#p" />
<use x="32" y="280" xlink:href="#p" />
<use x="32" y="288" xlink:href="#p" />
<use x="40" y="32" xlink:href="#p" />
<use x="40" y="80" xlink:href="#p" />
<use x="40" y="96" xlink:href="#p" />
<use x="40" y="112" xlink:href="#p" />
<use x="40" y="120" xlink:href="#p" />
<use x="40" y="136" xlink:href="#p" />
<use x="40" y="168" xlink:href="#p" />
<use x="40" y="192" xlink:href="#p" />
<use x="40" y="200" xlink:href="#p" />
<use x="40" y="208" xlink:href="#p" />
<use x="40" y="224" xlink:href="#p" />
<use x="40" y="240" xlink:href="#p" />
<use x="40" y="288" xlink:href="#p" />
<use x="48" y="32" xlink:href="#p" />
<use x="48" y="48" xlink:href="#p" />
<use x="48" y="56" xlink:href="#p" />
<use x="48" y="64" xlink:href="#p" />
<use x="48" y="80" xlink:href="#p" />
<use x="48" y="96" xlink:href="#p" />
<use x="48" y="120" xlink:href="#p" />
<use x="48" y="144" xlink:href="#p" />
<use x="48" y="152" xlink:href="#p" />
<use x="48" y="160" xlink:href="#p" />
<use x="48" y="184" xlink:href="#p" />
<use x="48" y="192" xlink:href="#p" />
<use x="48" y="200" xlink:href="#p" />
<use x="48" y="224" xlink:href="#p" />
<use x="48" y="240" xlink:href="#p" />
<use x="48" y="256" xlink:href="#p" />
<use x="48" y="264" xlink:href="#p" />
<use x="48" y="272" xlink:href="#p" />
<use x="48" y="288" xlink:href="#p" />
<use x="56" y="32" xlink:href="#p" />
<use x="56" y="48" xlink:href="#p" />
<use x="56" y="56" xlink:href="#p" />
<use x="56" y="64" xlink:href="#p" />
<use x="56" y="80" xlink:href="#p" />
<use x="56" y="120" xlink:href="#p" />
<use x="56" y="160" xlink:href="#p" />
<use x="56" y="168" xlink:href="#p" />
<use x="56" y="184" xlink:href="#p" />
<use x="56" y="216" xlink:href="#p" />
<use x="56" y="240" xlink:href="#p" />
<use x="56" y="256" xlink:href="#p" />
<use x="56" y="264" xlink:href="#p" />
<use x="56" y="272" xlink:href="#p" />
<use x="56" y="288" xlink:href="#p" />
<use x="64" y="32" xlink:href="#p" />
<use x="64" y="48" xlink:href="#p" />
<use x="64" y="56" xlink:href="#p" />
<use x="64" y="64" xlink:href="#p" />
<use x="64" y="80" xlink:href="#p" />
<use x="64" y="96" xlink:href="#p" />
<use x="64" y="112" xlink:href="#p" />
<use x="64" y="128" xlink:href="#p" />
<use x="64" y="136" xlink:href="#p" />
<use x="64" y="152" xlink:href="#p" />
<use x="64" y="168" xlink:href="#p" />
<use x="64" y="176" xlink:href="#p" />
<use x="64" y="184" xlink:href="#p" />
<use x="64" y="192" xlink:href="#p" />
<use x="64" y="216" xlink:href="#p" />
<use x="64" y="240" xlink:href="#p" />
<use x="64" y="256" xlink:href="#p" />
<use x="64" y="264" xlink:href="#p" />
<use x="64" y="272" xlink:href="#p" />
<use x="64" y="288" xlink:href="#p" />
<use x="72" y="32" xlink:href="#p" />
<use x="72" y="80" xlink:href="#p" />
<use x="72" y="104" xlink:href="#p" />
<use x="72" y="120" xlink:href="#p" />
<use x="72" y="128" xlink:href="#p" />
<use x="72" y="144" xlink:href="#p" />
<use x="72" y="176" xlink:href="#p" />
<use x="72" y="192" xlink:href="#p" />
<use x="72" y="216" xlink:href="#p" />
<use x="72" y="240" xlink:href="#p" />
<use x="72" y="288" xlink:href="#p" />
<use x="80" y="32" xlink:href="#p" />
<use x="80" y="40" xlink:href="#p" />
<use x="80" y="48" xlink:href="#p" />
<use x="80" y="56" xlink:href="#p" />
<use x="80" y="64" xlink:href="#p" />
<use x="80" y="72" xlink:href="#p" />
<use x="80" y="80" xlink:href="#p" />
<use x="80" y="96" xlink:href="#p" />
<use x="80" y="112" xlink:href="#p" />
<use x="80" y="128" xlink:href="#p" />
<use x="80" y="144" xlink:href="#p" />
<use x="80" y="160" xlink:href="#p" />
<use x="80" y="176" xlink:href="#p" />
<use x="80" y="192" xlink:href="#p" />
<use x="80" y="208" xlink:href="#p" />
<use x="80" y="224" xlink:href="#p" />
<use x="80" y="240" xlink:href="#p" />
<use x="80" y="248" xlink:href="#p" />
<use x="80" y="256" xlink:href="#p" />
<use x="80" y="264" xlink:href="#p" />
<use x="80" y="272" xlink:href="#p" />
<use x="80" y="280" xlink:href="#p" />
<use x="80" y="288" xlink:href="#p" />
<use x="88" y="96" xlink:href="#p" />
<use x="88" y="112" xlink:href="#p" />
<use x="88" y="120" xlink:href="#p" />
<use x="88" y="128" xlink:href="#p" />
<use x="88" y="152" xlink:href="#p" />
<use x="88" y="160" xlink:href="#p" />
<use x="88" y="176" xlink:href="#p" />
<use x="88" y="184" xlink:href="#p" />
<use x="88" y="192" xlink:href="#p" />
<use x="88" y="200" xlink:href="#p" />
<use x="88" y="208" xlink:href="#p" />
<use x="88" y="224" xlink:href="#p" />
<use x="96" y="32" xlink:href="#p" />
<use x="96" y="40" xlink:href="#p" />
<use x="96" y="48" xlink:href="#p" />
<use x="96" y="56" xlink:href="#p" />
<use x="96" y="64" xlink:href="#p" />
<use x="96" y="80" xlink:href="#p" />
<use x="96" y="88" xlink:href="#p" />
<use x="96" y="104" xlink:href="#p" />
<use x="96" y="112" xlink:href="#p" />
<use x="96" y="128" xlink:href="#p" />
<use x="96" y="144" xlink:href="#p" />
<use x="96" y="152" xlink:href="#p" />
<use x="96" y="168" xlink:href="#p" />
<use x="96" y="176" xlink:href="#p" />
<use x="96" y="184" xlink:href="#p" />
<use x="96" y="232" xlink:href="#p" />
<use x="96" y="240" xlink:href="#p" />
<use x="96" y="256" xlink:href="#p" />
<use x="96" y="272" xlink:href="#p" />
<use x="96" y="280" xlink:href="#p" />
<use x="104" y="40" xlink:href="#p" />
<use x="104" y="72" xlink:href="#p" />
<use x="104" y="88" xlink:href="#p" />
<use x="104" y="96" xlink:href="#p" />
<use x="104" y="104" xlink:href="#p" />
<use x="104" y="136" xlink:href="#p" />
<use x="104" y="144" xlink:href="#p" />
<use x="104" y="160" xlink:href="#p" />
<use x="104" y="168" xlink:href="#p" />
<use x="104" y="176" xlink:href="#p" />
<use x="104" y="208" xlink:href="#p" />
<use x="104" y="216" xlink:href="#p" />
<use x="104" y="224" xlink:href="#p" />
<use x="104" y="248" xlink:href="#p" />
<use x="104" y="256" xlink:href="#p" />
<use x="112" y="64" xlink:href="#p" />
<use x="112" y="72" xlink:href="#p" />
<use x="112" y="80" xlink:href="#p" />
<use x="112" y="96" xlink:href="#p" />
<use x="112" y="120" xlink:href="#p" />
<use x="112" y="128" xlink:href="#p" />
<use x="112" y="152" xlink:href="#p" />
<use x="112" y="168" xlink:href="#p" />
<use x="112" y="176" xlink:href="#p" />
<use x="112" y="192" xlink:href="#p" />
<use x="112" y="208" xlink:href="#p" />
<use x="112" y="224" xlink:href="#p" />
<use x="112" y="248" xlink:href="#p" />
<use x="112" y="256" xlink:href="#p" />
<use x="112" y="280" xlink:href="#p" />
<use x="120" y="40" xlink:href="#p" />
<use x="120" y="48" xlink:href="#p" />
<use x="120" y="56" xlink:href="#p" />
<use x="120" y="72" xlink:href="#p" />
<use x="120" y="136" xlink:href="#p" />
<use x="120" y="184" xlink:href="#p" />
<use x="120" y="224" xlink:href="#p" />
<use x="120" y="232" xlink:href="#p" />
<use x="120" y="240" xlink:href="#p" />
<use x="120" y="280" xlink:href="#p" />
<use x="120" y="288" xlink:href="#p" />
<use x="128" y="40" xlink:href="#p" />
<use x="128" y="48" xlink:href="#p" />
<use x="128" y="56" xlink:href="#p" />
<use x="128" y="64" xlink:href="#p" />
<use x="128" y="72" xlink:href="#p" />
<use x="128" y="80" xlink:href="#p" />
<use x="128" y="104" xlink:href="#p" />
<use x="128" y="120" xlink:href="#p" />
<use x="128" y="128" xlink:href="#p" />
<use x="128" y="152" xlink:href="#p" />
<use x="128" y="160" xlink:href="#p" />
<use x="128" y="176" xlink:href="#p" />
<use x="128" y="216" xlink:href="#p" />
<use x="128" y="232" xlink:href="#p" />
<use x="128" y="264" xlink:href="#p" />
<use x="128" y="272" xlink:href="#p" />
<use x="128" y="288" xlink:href="#p" />
<use x="136" y="40" xlink:href="#p" />
<use x="136" y="96" xlink:href="#p" />
<use x="136" y="144" xlink:href="#p" />
<use x="136" y="152" xlink:href="#p" />
<use x="136" y="208" xlink:href="#p" />
<use x="136" y="216" xlink:href="#p" />
<use x="136" y="248" xlink:href="#p" />
<use x="136" y="256" xlink:href="#p" />
<use x="136" y="264" xlink:href="#p" />
<use x="136" y="288" xlink:href="#p" />
<use x="144" y="56" xlink:href="#p" />
<use x="144" y="64" xlink:href="#p" />
<use x="144" y="80" xlink:href="#p" />
<use x="144" y="104" xlink:href="#p" />
<use x="144" y="112" xlink:href="#p" />
<use x="144" y="120" xlink:href="#p" />
<use x="144" y="136" xlink:href="#p" />
<use x="144" y="152" xlink:href="#p" />
<use x="144" y="168" xlink:href="#p" />
<use x="144" y="176" xlink:href="#p" />
<use x="144" y="200" xlink:href="#p" />
<use x="144" y="240" xlink:href="#p" />
<use x="144" y="256" xlink:href="#p" />
<use x="144" y="272" xlink:href="#p" />
<use x="144" y="280" xlink:href="#p" />
<use x="152" y="32" xlink:href="#p" />
<use x="152" y="48" xlink:href="#p" />
<use x="152" y="72" xlink:href="#p" />
<use x="152" y="88" xlink:href="#p" />
<use x="152" y="104" xlink:href="#p" />
<use x="152" y="112" xlink:href="#p" />
<use x="152" y="136" xlink:href="#p" />
<use x="152" y="152" xlink:href="#p" />
<use x="152" y="168" xlink:href="#p" />
<use x="152" y="176" xlink:href="#p" />
<use x="152" y="192" xlink:href="#p" />
<use x="152" y="224" xlink:href="#p" />
<use x="152" y="232" xlink:href="#p" />
<use x="152" y="256" xlink:href="#p" />
<use x="152" y="288" xlink:href="#p" />
<use x="160" y="48" xlink:href="#p" />
<use x="160" y="56" xlink:href="#p" />
<use x="160" y="64" xlink:href="#p" />
<use x="160" y="72" xlink:href="#p" />
<use x="160" y="80" xlink:href="#p" />
<use x="160" y="104" xlink:href="#p" />
<use x="160" y="112" xlink:href="#p" />
<use x="160" y="144" xlink:href="#p" />
<use x="160" y="168" xlink:href="#p" />
<use x="160" y="176" xlink:href="#p" />
<use x="160" y="208" xlink:href="#p" />
<use x="160" y="216" xlink:href="#p" />
<use x="168" y="40" xlink:href="#p" />
<use x="168" y="56" xlink:href="#p" />
<use x="168" y="64" xlink:href="#p" />
<use x="168" y="88" xlink:href="#p" />
<use x="168" y="112" xlink:href="#p" />
<use x="168" y="136" xlink:href="#p" />
<use x="168" y="144" xlink:href="#p" />
<use x="168" y="152" xlink:href="#p" />
<use x="168" y="160" xlink:href="#p" />
<use x="168" y="192" xlink:href="#p" />
<use x="168" y="216" xlink:href="#p" />
<use x="168" y="224" xlink:href="#p" />
<use x="168" y="248" xlink:href="#p" />
<use x="168" y="264" xlink:href="#p" />
<use x="168" y="272" xlink:href="#p" />
<use x="168" y="280" xlink:href="#p" />
<use x="168" y="288" xlink:href="#p" />
<use x="176" y="32" xlink:href="#p" />
<use x="176" y="72" xlink:href="#p" />
<use x="176" y="80" xlink:href="#p" />
<use x="176" y="104" xlink:href="#p" />
<use x="176" y="144" xlink:href="#p" />
<use x="176" y="176" xlink:href="#p" />
<use x="176" y="184" xlink:href="#p" />
<use x="176" y="200" xlink:href="#p" />
<use x="176" y="216" xlink:href="#p" />
<use x="176" y="224" xlink:href="#p" />
<use x="176" y="240" xlink:href="#p" />
<use x="176" y="264" xlink:href="#p" />
<use x="176" y="280" xlink:href="#p" />
<use x="176" y="288" xlink:href="#p" />
<use x="184" y="40" xlink:href="#p" />
<use x="184" y="96" xlink:href="#p" />
<use x="184" y="104" xlink:href="#p" />
<use x="184" y="136" xlink:href="#p" />
<use x="184" y="152" xlink:href="#p" />
<use x="184" y="184" xlink:href="#p" />
<use x="184" y="200" xlink:href="#p" />
<use x="184" y="208" xlink:href="#p" />
<use x="184" y="224" xlink:href="#p" />
<use x="184" y="256" xlink:href="#p" />
<use x="184" y="264" xlink:href="#p" />
<use x="184" y="280" xlink:href="#p" />
<use x="192" y="80" xlink:href="#p" />
<use x="192" y="88" xlink:href="#p" />
<use x="192" y="96" xlink:href="#p" />
<use x="192" y="104" xlink:href="#p" />
<use x="192" y="120" xlink:href="#p" />
<use x="192" y="168" xlink:href="#p" />
<use x="192" y="192" xlink:href="#p" />
<use x="192" y="200" xlink:href="#p" />
<use x="192" y="208" xlink:href="#p" />
<use x="192" y="216" xlink:href="#p" />
<use x="192" y="232" xlink:href="#p" />
<use x="192" y="248" xlink:href="#p" />
<use x="192" y="288" xlink:href="#p" />
<use x="200" y="40" xlink:href="#p" />
<use x="200" y="56" xlink:href="#p" />
<use x="200" y="64" xlink:href="#p" />
<use x="200" y="88" xlink:href="#p" />
<use x="200" y="96" xlink:href="#p" />
<use x="200" y="112" xlink:href="#p" />
<use x="200" y="136" xlink:href="#p" />
<use x="200" y="144" xlink:href="#p" />
<use x="200" y="152" xlink:href="#p" />
<use x="200" y="160" xlink:href="#p" />
<use x="200" y="168" xlink:href="#p" />
<use x="200" y="184" xlink:href="#p" />
<use x="200" y="216" xlink:href="#p" />
<use x="200" y="224" xlink:href="#p" />
<use x="200" y="240" xlink:href="#p" />
<use x="200" y="264" xlink:href="#p" />
<use x="200" y="280" xlink:href="#p" />
<use x="200" y="288" xlink:href="#p" />
<use x="208" y="32" xlink:href="#p" />
<use x="208" y="72" xlink:href="#p" />
<use x="208" y="80" xlink:href="#p" />
<use x="208" y="152" xlink:href="#p" />
<use x="208" y="176" xlink:href="#p" />
<use x="208" y="184" xlink:href="#p" />
<use x="208" y="192" xlink:href="#p" />
<use x="208" y="200" xlink:href="#p" />
<use x="208" y="280" xlink:href="#p" />
<use x="208" y="288" xlink:href="#p" />
<use x="216" y="32" xlink:href="#p" />
<use x="216" y="40" xlink:href="#p" />
<use x="216" y="48" xlink:href="#p" />
<use x="216" y="56" xlink:href="#p" />
<use x="216" y="96" xlink:href="#p" />
<use x="216" y="120" xlink:href="#p" />
<use x="216" y="128" xlink:href="#p" />
<use x="216" y="136" xlink:href="#p" />
<use x="216" y="152" xlink:href="#p" />
<use x="216" y="160" xlink:href="#p" />
<use x="216" y="216" xlink:href="#p" />
<use x="216" y="224" xlink:href="#p" />
<use x="216" y="240" xlink:href="#p" />
<use x="216" y="272" xlink:href="#p" />
<use x="216" y="288" xlink:href="#p" />
<use x="224" y="32" xlink:href="#p" />
<use x="224" y="40" xlink:href="#p" />
<use x="224" y="48" xlink:href="#p" />
<use x="224" y="80" xlink:href="#p" />
<use x="224" y="88" xlink:href="#p" />
<use x="224" y="104" xlink:href="#p" />
<use x="224" y="120" xlink:href="#p" />
<use x="224" y="128" xlink:href="#p" />
<use x="224" y="144" xlink:href="#p" />
<use x="224" y="160" xlink:href="#p" />
<use x="224" y="168" xlink:href="#p" />
<use x="224" y="176" xlink:href="#p" />
<use x="224" y="208" xlink:href="#p" />
<use x="224" y="224" xlink:href="#p" />
<use x="224" y="232" xlink:href="#p" />
<use x="224" y="240" xlink:href="#p" />
<use x="224" y="248" xlink:href="#p" />
<use x="224" y="256" xlink:href="#p" />
<use x="224" y="264" xlink:href="#p" />
<use x="224" y="288" xlink:href="#p" />
<use x="232" y="104" xlink:href="#p" />
<use x="232" y="144" xlink:href="#p" />
<use x="232" y="160" xlink:href="#p" />
<use x="232" y="168" xlink:href="#p" />
<use x="232" y="184" xlink:href="#p" />
<use x="232" y="192" xlink:href="#p" />
<use x="232" y="200" xlink:href="#p" />
<use x="232" y="208" xlink:href="#p" />
<use x="232" y="216" xlink:href="#p" />
<use x="232" y="224" xlink:href="#p" />
<use x="232" y="256" xlink:href="#p" />
<use x="232" y="280" xlink:href="#p" />
<use x="232" y="288" xlink:href="#p" />
<use x="240" y="32" xlink:href="#p" />
<use x="240" y="40" xlink:href="#p" />
<use x="240" y="48" xlink:href="#p" />
<use x="240" y="56" xlink:href="#p" />
<use x="240" y="64" xlink:href="#p" />
<use x="240" y="72" xlink:href="#p" />
<use x="240" y="80" xlink:href="#p" />
<use x="240" y="96" xlink:href="#p" />
<use x="240" y="104" xlink:href="#p" />
<use x="240" y="112" xlink:href="#p" />
<use x="240" y="120" xlink:href="#p" />
<use x="240" y="128" xlink:href="#p" />
<use x="240" y="136" xlink:href="#p" />
<use x="240" y="152" xlink:href="#p" />
<use x="240" y="160" xlink:href="#p" />
<use x="240" y="168" xlink:href="#p" />
<use x="240" y="192" xlink:href="#p" />
<use x="240" y="200" xlink:href="#p" />
<use x="240" y="208" xlink:href="#p" />
<use x="240" y="216" xlink:href="#p" />
<use x="240" y="224" xlink:href="#p" />
<use x="240" y="240" xlink:href="#p" />
<use x="240" y="256" xlink:href="#p" />
<use x="240" y="280" xlink:href="#p" />
<use x="240" y="288" xlink:href="#p" />
<use x="248" y="32" xlink:href="#p" />
<use x="248" y="80" xlink:href="#p" />
<use x="248" y="104" xlink:href="#p" />
<use x="248" y="112" xlink:href="#p" />
<use x="248" y="144" xlink:href="#p" />
<use x="248" y="168" xlink:href="#p" />
<use x="248" y="184" xlink:href="#p" />
<use x="248" y="192" xlink:href="#p" />
<use x="248" y="208" xlink:href="#p" />
<use x="248" y="216" xlink:href="#p" />
<use x="248" y="224" xlink:href="#p" />
<use x="248" y="256" xlink:href="#p" />
<use x="256" y="32" xlink:href="#p" />
<use x="256" y="48" xlink:href="#p" />
<use x="256" y="56" xlink:href="#p" />
<use x="256" y="64" xlink:href="#p" />
<use x="256" y="80" xlink:href="#p" />
<use x="256" y="96" xlink:href="#p" />
<use x="256" y="120" xlink:href="#p" />
<use x="256" y="184" xlink:href="#p" />
<use x="256" y="192" xlink:href="#p" />
<use x="256" y="224" xlink:href="#p" />
<use x="256" y="232" xlink:href="#p" />
<use x="256" y="240" xlink:href="#p" />
<use x="256" y="248" xlink:href="#p" />
<use x="256" y="256" xlink:href="#p" />
<use x="256" y="264" xlink:href="#p" />
<use x="256" y="272" xlink:href="#p" />
<use x="256" y="280" xlink:href="#p" />
<use x="256" y="288" xlink:href="#p" />
<use x="264" y="32" xlink:href="#p" />
<use x="264" y="48" xlink:href="#p" />
<use x="264" y="56" xlink:href="#p" />
<use x="264" y="64" xlink:href="#p" />
<use x="264" y="80" xlink:href="#p" />
<use x="264" y="96" xlink:href="#p" />
<use x="264" y="128" xlink:href="#p" />
<use x="264" y="144" xlink:href="#p" />
<use x="264" y="160" xlink:href="#p" />
<use x="264" y="192" xlink:href="#p" />
<use x="264" y="208" xlink:href="#p" />
<use x="264" y="224" xlink:href="#p" />
<use x="264" y="232" xlink:href="#p" />
<use x="264" y="256" xlink:href="#p" />
<use x="264" y="264" xlink:href="#p" />
<use x="264" y="288" xlink:href="#p" />
<use x="272" y="32" xlink:href="#p" />
<use x="272" y="48" xlink:href="#p" />
<use x="272" y="56" xlink:href="#p" />
<use x="272" y="64" xlink:href="#p" />
<use x="272" y="80" xlink:href="#p" />
<use x="272" y="96" xlink:href="#p" />
<use x="272" y="112" xlink:href="#p" />
<use x="272" y="136" xlink:href="#p" />
<use x="272" y="160" xlink:href="#p" />
<use x="272" y="176" xlink:href="#p" />
<use x="272" y="224" xlink:href="#p" />
<use x="272" y="240" xlink:href="#p" />
<use x="280" y="32" xlink:href="#p" />
<use x="280" y="80" xlink:href="#p" />
<use x="280" y="96" xlink:href="#p" />
<use x="280" y="104" xlink:href="#p" />
<use x="280" y="112" xlink:href="#p" />
<use x="280" y="128" xlink:href="#p" />
<use x="280" y="144" xlink:href="#p" />
<use x="280" y="152" xlink:href="#p" />
<use x="280" y="200" xlink:href="#p" />
<use x="280" y="208" xlink:href="#p" />
<use x="280" y="240" xlink:href="#p" />
<use x="280" y="256" xlink:href="#p" />
<use x="280" y="264" xlink:href="#p" />
<use x="280" y="280" xlink:href="#p" />
<use x="280" y="288" xlink:href="#p" />
<use x="288" y="32" xlink:href="#p" />
<use x="288" y="40" xlink:href="#p" />
<use x="288" y="48" xlink:href="#p" />
<use x="288" y="56" xlink:href="#p" />
<use x="288" y="64" xlink:href="#p" />
<use x="288" y="72" xlink:href="#p" />
<use x="288" y="80" xlink:href="#p" />
<use x="288" y="96" xlink:href="#p" />
<use x="288" y="104" xlink:href="#p" />
<use x="288" y="112" xlink:href="#p" />
<use x="288" y="120" xlink:href="#p" />
<use x="288" y="128" xlink:href="#p" />
<use x="288" y="136" xlink:href="#p" />
<use x="288" y="144" xlink:href="#p" />
<use x="288" y="168" xlink:href="#p" />
<use x="288" y="176" xlink:href="#p" />
<use x="288" y="184" xlink:href="#p" />
<use x="288" y="192" xlink:href="#p" />
<use x="288" y="200" xlink:href="#p" />
<use x="288" y="208" xlink:href="#p" />
<use x="288" y="216" xlink:href="#p" />
<use x="288" y="224" xlink:href="#p" />
<use x="288" y="232" xlink:href="#p" />
<use x="288" y="240" xlink:href="#p" />
<use x="288" y="256" xlink:href="#p" />
<use x="288" y="264" xlink:href="#p" />
<use x="288" y="272" xlink:href="#p" />
<use x="288" y="288" xlink:href="#p" />
</g>
</svg>
Side by side

Before

Width:  |  Height:  |  Size: 20 KiB

BIN
201/images/nginx-default.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 32 KiB

BIN
201/images/puttygen-password.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 17 KiB

BIN
201/images/puttygen-randomness.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 4.3 KiB

BIN
201/images/puttygen.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 12 KiB

133
201/index.html
View file

@ -1,133 +0,0 @@
<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8' />
<title>Linux 101 • Freeside</title>
</head>
<body>
<main class="js-deck3000">
<section>
<article class="title">
<h1>Linux 201</h1>
</article>
<article>
<h2>Structure</h2>
<ul>
<li>Short introduction</li>
<li>Nginx web server setup!</li>
</ul>
</article>
<article>
<h2>Why?</h2>
<div class="flex horizontal">
<div><img alt="A simple pie chart. Explained below." src="../images/linux-vs-windows-desktop-os.svg" aria-hidden="true" /></div>
<ul>
<li>74.44% Windows</li>
<li>12.22% macOS</li>
<li>9.51% Other</li>
<li>1.58% Linux</li>
</ul>
</div>
<p><small>According to <a href="http://gs.statcounter.com/os-market-share/desktop/worldwide">statcounter GlobalStats</a></small></p>
</article>
<article>
<h2>Why?</h2>
<div class="flex horizontal">
<div><img alt="A simple pie chart. Explained below." src="../images/linux-vs-windows-server-os.svg" aria-hidden="true" /></div>
<ul>
<li>69.4% of webservers use a Unix-based OS</li>
<li>30.6% of webservers use Windows</li>
</ul>
</div>
<p><small>
According to
<a href="https://w3techs.com/technologies/overview/operating_system/all">W<sup>3</sup>Techs</a>
</small></p>
</article>
<article>
<h2>Where?</h2>
<ul>
<li>US Department of Defence</li>
<!-- Largest Single Red Hat user in the world -->
<li>French Parliament</li>
<li>Amazon - AWS</li>
<li>Android</li>
</ul>
<p><small>Sources: <a href="https://www.comparebusinessproducts.com/fyi/50-places-linux-running-you-might-not-expect">1</a></small></p>
</article>
</section>
<section>
<article class="title">
<h1>Setting up a web server</h1>
</article>
<article class="">
<h2>Virtual machines</h2>
<ul>
<li>We'll be using VMs on the DCS cluster</li>
<li>If you have turned up without filling in the registration form, please say something now</li>
</ul>
</article>
<article>
<h2>Lab sheet</h2>
<ul>
<li><a href="https://starbeamrainbowlabs.com/labs/Linux101/201/Lab-Sheet.pdf">https://starbeamrainbowlabs.com/labs/Linux101/201/Lab-Sheet.pdf</a></li>
</ul>
</article>
</section>
<section>
<article class="title">
<h1>Summary</h1>
</article>
<article>
<h2>Summary</h2>
<ul>
<li>We've secured a Linux server</li>
<li>We've installed Nginx</li>
<li>We're serving a static website</li>
</ul>
</article>
<article>
<h2>Where next?</h2>
<ul>
<li>Application server setup</li>
<li>Git hosting</li>
<li>Decentralised Instant Messaging</li>
<li>Containerisation</li>
<li>Embedded systems: Raspberry Pi etc.</li>
<li>Self-hosting (<a href="https://github.com/Kickball/awesome-selfhosted"><code>kickball/awesome-selfhosted</code></a> on GitHub)</li>
</ul>
</article>
<article>
<h2>Future Workshops</h2>
<ul>
<li>301: Deploying your application to a Linux server</li>
<li>Talks</li>
<li>Server administration</li>
</ul>
</article>
<article>
<h2>Thanks for coming!</h2>
<ul>
<li>Bought to you by Freeside</li>
<li><div class="flex flex-align-centre">
<!-- <span>Feedback: <a href="https://forms.gle/CN2Pkm4fnHjGzs889">https://forms.gle/CN2Pkm4fnHjGzs889</a></span>
<img src="images/QR-Feedback.svg" aria-hidden="true" /> -->
<span>Feedback: <a href="https://forms.gle/qwLNUs7oWRsWc8iX8">https://forms.gle/qwLNUs7oWRsWc8iX8</a></span>
<img alt="A QR code of the aforementioned link" src="images/feedback.svg" aria-hidden="true" />
</div></li>
<li>Join us: <a href="https://freeside.co.uk/">https://freeside.co.uk/</a></li>
<li>Discord | Forums | PC Access</li>
<li>Questions?</li>
</ul>
</article>
</section>
</main>
<!---------------->
<link rel="stylesheet" href="../linux101.css" />
<script src="../linux101.js"></script>
</body>
</html>

BIN
Freeside_introduction.odp Normal file
View file

Binary file not shown.

17
Notes.md
View file

@ -1,17 +0,0 @@
# Linux 101
- Ubuntu installation
- Whilst selecting options
- Which are the right options and why?
- Remember they are first-time Linux users
- Whilst installing:
- File system layout - compare with Windows
- Permissions, sudo, not using root
- After installation:
- Terminal basics - tldr-pages?
- Package management basics
- Mono, compiling a C# program
- MonoDevelop / VS Code?
- At the end
- Where can they go to learn more?
- Freeside plug

7
README.md
View file

@ -1,6 +1,3 @@
# Linux-101 # Linux and Git 101 by Freeside
> The Linux 101 tutorial resources I've put together. Original slides by SBRL
## Useful Links
- [Pie Chart Generator](http://ceagon.com/tools/charts)

209
build
View file

@ -1,209 +0,0 @@
#!/usr/bin/env bash
# Make sure the current directory is the location of this script to simplify matters
cd "$(dirname $(readlink -f $0))";
################
### Settings ###
################
# The name of this project
project_name="micro-lanterns";
# The path to the lantern build engine git submodule
lantern_path="./lantern-build-engine";
###
# Custom Settings
###
# Put any custom settings here.
build_output_folder="./dist";
deploy_ssh_user="ci";
deploy_ssh_host="starbeamrainbowlabs.com";
deploy_ssh_port="2403";
###############################################################################
# Check out the lantern git submodule if needed
if [ ! -f "${lantern_path}/lantern.sh" ]; then git submodule update --init "${lantern_path}"; fi
source "${lantern_path}/lantern.sh";
if [[ "$#" -lt 1 ]]; then
echo -e "${FBLE}${project_name}${RS} build script";
echo -e " by Starbeamrainbowlabs";
echo -e "${LC}Powered by the lantern build engine, v${version}${RS}";
echo -e "";
echo -e "${CSECTION}Usage${RS}";
echo -e " ./build ${CTOKEN}{action}${RS} ${CTOKEN}{action}${RS} ${CTOKEN}{action}${RS} ...";
echo -e "";
echo -e "${CSECTION}Available actions${RS}";
echo -e " ${CACTION}setup${RS} - Perform initial setup";
echo -e " ${CACTION}main${RS} - Build the slide deck";
echo -e " ${CACTION}main-watch${RS} - Build the slide deck automatically when something changes";
echo -e " ${CACTION}slides${RS} - Build the slides HTML";
echo -e " ${CACTION}js-css${RS} - Build the javascript / css";
echo -e " ${CACTION}dev-server${RS} - Start a development server";
echo -e " ${CACTION}dev-server-stop${RS} - Stop the currently running development server";
echo -e "";
exit 1;
fi
###############################################################################
task_setup() {
stage_begin "Setting up";
check_command git true;
check_command node true;
check_command npm true;
check_command pandoc true;
check_command weasyprint true;
task_begin "Creating build output directory";
mkdir -p "${build_output_folder}";
subtask_end $? "Error: Failed to create build output directory at ${HC}${build_output_folder}${RS}";
task_begin "Initialising submodules";
git submodule update --init;
task_end $? "Error: Failed to initialise submodules";
task_begin "Installing dependencies";
npm install;
task_end $? "Error: Failed to install dependencies";
stage_end 0;
}
# ██████ ███████ ██ ██ ███████ ███████ ██████ ██ ██ ███████ ██████
# ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
# ██ ██ █████ ██ ██ █████ ███████ █████ ██████ ██ ██ █████ ██████
# ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
# ██████ ███████ ████ ███████ ███████ ██ ██ ████ ███████ ██ ██
task_dev-server() {
task_begin "Starting development server";
php -S [::1]:50678 -t "${build_output_folder}" &
exit_code=$?;
echo $! >/tmp/micro-lantern-dev-server.pid;
task_end $?; # Should be 0 unless php died for some reason
sleep 1;
}
task_dev-server-stop() {
task_begin "Stopping development server";
kill "$(cat /tmp/micro-lantern-dev-server.pid)";
rm /tmp/micro-lantern-dev-server.pid;
task_end $?;
}
task_main-watch() {
set_title "Build Watcher";
echo -e "Watching for changes.";
while :; do # : = infinite loop
# Wait for an update
# inotifywait's non-0 exit code forces an exit for some reason :-/
inotifywait -qr --event modify --format '%:e %f' index.html images css js;
# Rebuild the client code - spawn a sub-process to avoid the hard exit
# This still doesn't work though, which is *really* annoying
stage_begin "Rebuilding";
./build main;
stage_end 0;
done
}
task_main() {
tasks_run js-css;
if [ ! -d "${build_output_folder}/201" ]; then
task_begin "Creating 201 output subdirectory";
mkdir "${build_output_folder}/201";
task_end "$?";
fi
task_begin "Copying html";
cp index.html "${build_output_folder}";
cp 201/index.html "${build_output_folder}/201";
task_end "$?";
task_begin "Copying images";
cp -r images/ "${build_output_folder}";
mkdir "${build_output_folder}/201/images";
cp 201/images/feedback.svg "${build_output_folder}/201/images/";
task_end "$?";
task_begin "Rendering lab sheets: markdown -> html [phase 1/3]";
pandoc 201/Lab-Sheet.md --standalone --output 201/Lab-Sheet.html;
task_end "$?";
task_begin "Rendering lab sheets: html -> pdf [phase 2/3]";
weasyprint 201/Lab-Sheet.html 201/Lab-Sheet.pdf --stylesheet css/lab-sheet.css --format pdf --verbose;
exit_code="$?";
rm 201/Lab-Sheet.html;
task_end "${exit_code}";
task_begin "Rendering lab sheets: archiving [phase 3/3]";
mv 201/Lab-Sheet.pdf "${build_output_folder}/201";
task_end "$?";
}
task_js-css() {
task_begin "Packaging Javascript & CSS";
node_modules/rollup/bin/rollup --sourcemap --config rollup.config.js;
task_end $? "Error: rollup packing failed!";
}
# ██████ ██
# ██ ██
# ██ ██
# ██ ██
# ██████ ██
task_ci() {
task_begin "Environment Information";
execute git --version;
execute node --version;
execute npm --version;
task_end $?;
# Run setup in 'development' mode to get the right dependencies installed
tasks_run setup;
export NODE_ENV=production;
# Run the rest in 'production' mode to create a production build
tasks_run main archive deploy;
}
task_archive() {
task_begin "Archiving";
mv "${build_output_folder}" "Linux101/";
tar cafv "${ARCHIVE}/slides.tar.bz2" "Linux101/";
exit_code=$?;
mv "Linux101/" "${build_output_folder}";
task_end "${exit_code}";
}
task_deploy() {
task_begin "Deploying to ${deploy_ssh_host}....";
if [ "${SSH_KEY_PATH}" == "" ]; then
task_end 1 "Error: Can't find the SSH key as the environment variable SSH_KEY_PATH isn't set.";
fi
# TODO: If we experience issues, we need to somehow figure out how to recursively delete the contents of the directory before uploading. We may have to install lftp and use that instead
sftp -i "${SSH_KEY_PATH}" -P "${deploy_ssh_port}" -o PasswordAuthentication=no "${deploy_ssh_user}@${deploy_ssh_host}" << SFTPCOMMANDS
put -r ${build_output_folder}/* Linux101
bye
SFTPCOMMANDS
task_end $?;
}
###############################################################################
tasks_run $@;

119
css/lab-sheet.css
View file

@ -1,119 +0,0 @@
/* Base CSS */
/*
* This CSS file contains (for me) logical style defaults that are easy to read.
*
* This file is quite often used as a starting point for other projects.
*
* Todo:
* <button>
* <inputs>
* <progress>
* <meter>
*/
/* rem is relative to the html element, and em is relative to the current element. */
html { font-size:100%; }
body
{
font-family: sans-serif; /* Serif is awful :( */
background: #f3f3f3; /* Don't forget to update the @page one too for paged media */
color: #232323;
}
title { string-set: page-title content(text); }
/* Special tweaks for paged media (e.g. PDFs) */
@page {
font-family: sans-serif;
background: #f3f3f3; /* Set the background colour to cover the whole page */
@top-left {
content: "Freeside Linux 201 - Web Server Setup";
opacity: 0.6;
}
@top-right {
content: "By Starbeamrainbowlabs and @closebracket";
opacity: 0.6;
}
@bottom-right {
content: "Page " counter(page) " of " counter(pages);
opacity: 0.6;
}
}
/* A small tweak to things more responsive */
iframe, object, embed, img, video, table {
max-width: 100%;
}
/* Turn the user's cursor into a hand when over things they can click */
button, summary {
cursor: pointer;
}
th, td {
margin: 4px 6px;
padding: 4px 6px;
}
pre { page-break-inside: avoid; break-inside: avoid; }
pre, code {
white-space: pre-wrap;
-moz-tab-size: 4;
tab-size: 4;
}
/* todo add the rest of the textbox like inputs here */
input[type=text], input[type=number], textarea {
margin: 3px 5px;
padding: 5px 8px;
background: white;
border: 0;
border-radius: 5px;
}
/* Utility / layout aids */
.float.left { float: left; }
.float.right { float: right; }
.flex { display: flex; }
.flex-1 { flex: 1; }
.flex-2 { flex: 2; }
.flex-3 { flex: 3; }
.flex-4 { flex: 4; }
.flex-5 { flex: 5; }
.flex-6 { flex: 6; }
.small-spacing { margin: 2px 4px; padding: 2px 4px; }
.med-spacing { margin: 5px 8px; padding: 5px 8px; }
.high-spacing { margin: 8px 10px; padding: 8px 10px; }
.text-left { text-align: left; }
.text-centre { text-align: center; }
.text-right { text-align: right; }
.small-text { font-size: 0.8rem; }
.medium-text { font-size: 1rem; }
.large-text { font-size: 1.3rem; }
.bold-text { font-weight: bolder; }
.block { display: block; }
.inline { display: inline; }
.inline.block { display: inline-block; }
.invisilink { text-decoration: none; color: inherit; }
.invisilist { list-style-type: none; margin: 5px; padding: 5px; }
.tiny-image { max-width: 100px; max-height: 100px; }
.small-image { max-width: 250px; max-height: 250px; }
.medium-image { max-width: 450px; max-height: 450px; }
.large-image { max-width: 650px; max-height: 650px; }
.img-text-middle{ vertical-align: middle; }

79
css/theme.css
View file

@ -1,79 +0,0 @@
@import "../node_modules/deck3000/dist/deck3000.css";
:root {
--accent-main: #FE6431;
--bg-dark-trans: hsla(0, 0%, 19%, 0.5);
--bg-dark: #323232;
--bg-light: white;
}
html, body { font-size: 175%; }
body {
font-family: sans-serif;
}
article {
width: 100vw !important; height: 100vh !important;
display: flex;
flex-direction: column;
box-sizing: border-box;
}
article.title {
background: url(images/freeside.svg) no-repeat center 4em / 9em;
}
article:not(.title) {
align-items: center;
padding: 0.75em 3em;
background: content-box url("./images/freeside.svg") bottom right / 15% no-repeat;
}
h1, h2, h3, h4, h5, h6 {
color: var(--accent-main);
text-align: center;
margin: 0.5em 0;
}
h1 {
margin: 0; padding: 0.5em 0;
background: var(--bg-dark);
font-size: 150%;
}
h2 { font-size: 125%; margin: 0.1em 0; }
p:first-of-type { margin: 0; }
small { font-size: 50%; }
img {
box-sizing: border-box;
padding: 0.25em;
max-width: fit-content;
max-height: fit-content;
}
table { border-collapse: collapse; }
td, th {
border: 0.075em solid var(--bg-dark-trans);
vertical-align: top;
}
.bg-light { background: var(--bg-light); }
.centre-content { text-align: center; }
.flex { display: flex; }
.flex.horizontal { flex-direction: row; }
.flex.vertical { flex-direction: column; }
.flex-1 { flex: 1; }
.flex-2 { flex: 2; }
.flex-3 { flex: 3; }
.flex-4 { flex: 4; }
.flex-5 { flex: 5; }
.flex-6 { flex: 6; }
.flex-align-centre { align-items: center; }
.image-container {
max-height: 100%;
max-width: 100%;
}

BIN
images/Logos/alpine.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 24 KiB

BIN
images/Logos/archlinux.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 100 KiB

BIN
images/Logos/debian.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 25 KiB

BIN
images/Logos/devuan.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 8.6 KiB

BIN
images/Logos/fedora.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 20 KiB

BIN
images/Logos/gentoo.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 106 KiB

BIN
images/Logos/ubuntu.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 31 KiB

577
images/QR-Feedback.svg
View file

@ -1,577 +0,0 @@
<?xml version="1.0" encoding="utf-8"?>
<svg version="1.1" baseProfile="full" width="328" height="328" viewBox="0 0 328 328"
xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ev="http://www.w3.org/2001/xml-events">
<desc></desc>
<rect width="328" height="328" fill="#ffffff" cx="0" cy="0" />
<defs>
<rect id="p" width="8" height="8" />
</defs>
<g fill="#000000">
<use x="32" y="32" xlink:href="#p" />
<use x="32" y="40" xlink:href="#p" />
<use x="32" y="48" xlink:href="#p" />
<use x="32" y="56" xlink:href="#p" />
<use x="32" y="64" xlink:href="#p" />
<use x="32" y="72" xlink:href="#p" />
<use x="32" y="80" xlink:href="#p" />
<use x="32" y="104" xlink:href="#p" />
<use x="32" y="120" xlink:href="#p" />
<use x="32" y="144" xlink:href="#p" />
<use x="32" y="168" xlink:href="#p" />
<use x="32" y="176" xlink:href="#p" />
<use x="32" y="192" xlink:href="#p" />
<use x="32" y="240" xlink:href="#p" />
<use x="32" y="248" xlink:href="#p" />
<use x="32" y="256" xlink:href="#p" />
<use x="32" y="264" xlink:href="#p" />
<use x="32" y="272" xlink:href="#p" />
<use x="32" y="280" xlink:href="#p" />
<use x="32" y="288" xlink:href="#p" />
<use x="40" y="32" xlink:href="#p" />
<use x="40" y="80" xlink:href="#p" />
<use x="40" y="96" xlink:href="#p" />
<use x="40" y="104" xlink:href="#p" />
<use x="40" y="152" xlink:href="#p" />
<use x="40" y="160" xlink:href="#p" />
<use x="40" y="184" xlink:href="#p" />
<use x="40" y="208" xlink:href="#p" />
<use x="40" y="216" xlink:href="#p" />
<use x="40" y="224" xlink:href="#p" />
<use x="40" y="240" xlink:href="#p" />
<use x="40" y="288" xlink:href="#p" />
<use x="48" y="32" xlink:href="#p" />
<use x="48" y="48" xlink:href="#p" />
<use x="48" y="56" xlink:href="#p" />
<use x="48" y="64" xlink:href="#p" />
<use x="48" y="80" xlink:href="#p" />
<use x="48" y="96" xlink:href="#p" />
<use x="48" y="104" xlink:href="#p" />
<use x="48" y="112" xlink:href="#p" />
<use x="48" y="128" xlink:href="#p" />
<use x="48" y="136" xlink:href="#p" />
<use x="48" y="144" xlink:href="#p" />
<use x="48" y="152" xlink:href="#p" />
<use x="48" y="168" xlink:href="#p" />
<use x="48" y="208" xlink:href="#p" />
<use x="48" y="224" xlink:href="#p" />
<use x="48" y="240" xlink:href="#p" />
<use x="48" y="256" xlink:href="#p" />
<use x="48" y="264" xlink:href="#p" />
<use x="48" y="272" xlink:href="#p" />
<use x="48" y="288" xlink:href="#p" />
<use x="56" y="32" xlink:href="#p" />
<use x="56" y="48" xlink:href="#p" />
<use x="56" y="56" xlink:href="#p" />
<use x="56" y="64" xlink:href="#p" />
<use x="56" y="80" xlink:href="#p" />
<use x="56" y="96" xlink:href="#p" />
<use x="56" y="144" xlink:href="#p" />
<use x="56" y="152" xlink:href="#p" />
<use x="56" y="168" xlink:href="#p" />
<use x="56" y="176" xlink:href="#p" />
<use x="56" y="184" xlink:href="#p" />
<use x="56" y="192" xlink:href="#p" />
<use x="56" y="200" xlink:href="#p" />
<use x="56" y="208" xlink:href="#p" />
<use x="56" y="240" xlink:href="#p" />
<use x="56" y="256" xlink:href="#p" />
<use x="56" y="264" xlink:href="#p" />
<use x="56" y="272" xlink:href="#p" />
<use x="56" y="288" xlink:href="#p" />
<use x="64" y="32" xlink:href="#p" />
<use x="64" y="48" xlink:href="#p" />
<use x="64" y="56" xlink:href="#p" />
<use x="64" y="64" xlink:href="#p" />
<use x="64" y="80" xlink:href="#p" />
<use x="64" y="96" xlink:href="#p" />
<use x="64" y="104" xlink:href="#p" />
<use x="64" y="120" xlink:href="#p" />
<use x="64" y="128" xlink:href="#p" />
<use x="64" y="136" xlink:href="#p" />
<use x="64" y="152" xlink:href="#p" />
<use x="64" y="168" xlink:href="#p" />
<use x="64" y="184" xlink:href="#p" />
<use x="64" y="200" xlink:href="#p" />
<use x="64" y="224" xlink:href="#p" />
<use x="64" y="240" xlink:href="#p" />
<use x="64" y="256" xlink:href="#p" />
<use x="64" y="264" xlink:href="#p" />
<use x="64" y="272" xlink:href="#p" />
<use x="64" y="288" xlink:href="#p" />
<use x="72" y="32" xlink:href="#p" />
<use x="72" y="80" xlink:href="#p" />
<use x="72" y="96" xlink:href="#p" />
<use x="72" y="112" xlink:href="#p" />
<use x="72" y="128" xlink:href="#p" />
<use x="72" y="184" xlink:href="#p" />
<use x="72" y="208" xlink:href="#p" />
<use x="72" y="224" xlink:href="#p" />
<use x="72" y="240" xlink:href="#p" />
<use x="72" y="288" xlink:href="#p" />
<use x="80" y="32" xlink:href="#p" />
<use x="80" y="40" xlink:href="#p" />
<use x="80" y="48" xlink:href="#p" />
<use x="80" y="56" xlink:href="#p" />
<use x="80" y="64" xlink:href="#p" />
<use x="80" y="72" xlink:href="#p" />
<use x="80" y="80" xlink:href="#p" />
<use x="80" y="96" xlink:href="#p" />
<use x="80" y="112" xlink:href="#p" />
<use x="80" y="128" xlink:href="#p" />
<use x="80" y="144" xlink:href="#p" />
<use x="80" y="160" xlink:href="#p" />
<use x="80" y="176" xlink:href="#p" />
<use x="80" y="192" xlink:href="#p" />
<use x="80" y="208" xlink:href="#p" />
<use x="80" y="224" xlink:href="#p" />
<use x="80" y="240" xlink:href="#p" />
<use x="80" y="248" xlink:href="#p" />
<use x="80" y="256" xlink:href="#p" />
<use x="80" y="264" xlink:href="#p" />
<use x="80" y="272" xlink:href="#p" />
<use x="80" y="280" xlink:href="#p" />
<use x="80" y="288" xlink:href="#p" />
<use x="88" y="96" xlink:href="#p" />
<use x="88" y="104" xlink:href="#p" />
<use x="88" y="112" xlink:href="#p" />
<use x="88" y="120" xlink:href="#p" />
<use x="88" y="128" xlink:href="#p" />
<use x="88" y="160" xlink:href="#p" />
<use x="88" y="176" xlink:href="#p" />
<use x="96" y="32" xlink:href="#p" />
<use x="96" y="64" xlink:href="#p" />
<use x="96" y="72" xlink:href="#p" />
<use x="96" y="80" xlink:href="#p" />
<use x="96" y="104" xlink:href="#p" />
<use x="96" y="120" xlink:href="#p" />
<use x="96" y="128" xlink:href="#p" />
<use x="96" y="136" xlink:href="#p" />
<use x="96" y="144" xlink:href="#p" />
<use x="96" y="152" xlink:href="#p" />
<use x="96" y="160" xlink:href="#p" />
<use x="96" y="168" xlink:href="#p" />
<use x="96" y="176" xlink:href="#p" />
<use x="96" y="184" xlink:href="#p" />
<use x="96" y="192" xlink:href="#p" />
<use x="96" y="224" xlink:href="#p" />
<use x="96" y="232" xlink:href="#p" />
<use x="96" y="240" xlink:href="#p" />
<use x="96" y="248" xlink:href="#p" />
<use x="96" y="256" xlink:href="#p" />
<use x="96" y="264" xlink:href="#p" />
<use x="96" y="272" xlink:href="#p" />
<use x="96" y="280" xlink:href="#p" />
<use x="104" y="32" xlink:href="#p" />
<use x="104" y="72" xlink:href="#p" />
<use x="104" y="104" xlink:href="#p" />
<use x="104" y="120" xlink:href="#p" />
<use x="104" y="136" xlink:href="#p" />
<use x="104" y="152" xlink:href="#p" />
<use x="104" y="168" xlink:href="#p" />
<use x="104" y="176" xlink:href="#p" />
<use x="104" y="200" xlink:href="#p" />
<use x="104" y="208" xlink:href="#p" />
<use x="104" y="216" xlink:href="#p" />
<use x="104" y="224" xlink:href="#p" />
<use x="112" y="56" xlink:href="#p" />
<use x="112" y="64" xlink:href="#p" />
<use x="112" y="80" xlink:href="#p" />
<use x="112" y="96" xlink:href="#p" />
<use x="112" y="112" xlink:href="#p" />
<use x="112" y="136" xlink:href="#p" />
<use x="112" y="184" xlink:href="#p" />
<use x="112" y="192" xlink:href="#p" />
<use x="112" y="200" xlink:href="#p" />
<use x="112" y="216" xlink:href="#p" />
<use x="112" y="224" xlink:href="#p" />
<use x="112" y="248" xlink:href="#p" />
<use x="112" y="256" xlink:href="#p" />
<use x="112" y="264" xlink:href="#p" />
<use x="112" y="280" xlink:href="#p" />
<use x="112" y="288" xlink:href="#p" />
<use x="120" y="56" xlink:href="#p" />
<use x="120" y="64" xlink:href="#p" />
<use x="120" y="104" xlink:href="#p" />
<use x="120" y="112" xlink:href="#p" />
<use x="120" y="128" xlink:href="#p" />
<use x="120" y="176" xlink:href="#p" />
<use x="120" y="184" xlink:href="#p" />
<use x="120" y="208" xlink:href="#p" />
<use x="120" y="224" xlink:href="#p" />
<use x="120" y="240" xlink:href="#p" />
<use x="120" y="256" xlink:href="#p" />
<use x="120" y="280" xlink:href="#p" />
<use x="120" y="288" xlink:href="#p" />
<use x="128" y="56" xlink:href="#p" />
<use x="128" y="64" xlink:href="#p" />
<use x="128" y="72" xlink:href="#p" />
<use x="128" y="80" xlink:href="#p" />
<use x="128" y="112" xlink:href="#p" />
<use x="128" y="120" xlink:href="#p" />
<use x="128" y="128" xlink:href="#p" />
<use x="128" y="136" xlink:href="#p" />
<use x="128" y="144" xlink:href="#p" />
<use x="128" y="152" xlink:href="#p" />
<use x="128" y="168" xlink:href="#p" />
<use x="128" y="192" xlink:href="#p" />
<use x="128" y="208" xlink:href="#p" />
<use x="128" y="240" xlink:href="#p" />
<use x="128" y="256" xlink:href="#p" />
<use x="128" y="264" xlink:href="#p" />
<use x="128" y="272" xlink:href="#p" />
<use x="128" y="288" xlink:href="#p" />
<use x="136" y="64" xlink:href="#p" />
<use x="136" y="72" xlink:href="#p" />
<use x="136" y="88" xlink:href="#p" />
<use x="136" y="96" xlink:href="#p" />
<use x="136" y="120" xlink:href="#p" />
<use x="136" y="128" xlink:href="#p" />
<use x="136" y="144" xlink:href="#p" />
<use x="136" y="152" xlink:href="#p" />
<use x="136" y="160" xlink:href="#p" />
<use x="136" y="168" xlink:href="#p" />
<use x="136" y="176" xlink:href="#p" />
<use x="136" y="184" xlink:href="#p" />
<use x="136" y="208" xlink:href="#p" />
<use x="136" y="216" xlink:href="#p" />
<use x="136" y="224" xlink:href="#p" />
<use x="136" y="256" xlink:href="#p" />
<use x="136" y="264" xlink:href="#p" />
<use x="136" y="272" xlink:href="#p" />
<use x="136" y="280" xlink:href="#p" />
<use x="144" y="32" xlink:href="#p" />
<use x="144" y="48" xlink:href="#p" />
<use x="144" y="56" xlink:href="#p" />
<use x="144" y="72" xlink:href="#p" />
<use x="144" y="80" xlink:href="#p" />
<use x="144" y="112" xlink:href="#p" />
<use x="144" y="128" xlink:href="#p" />
<use x="144" y="144" xlink:href="#p" />
<use x="144" y="176" xlink:href="#p" />
<use x="144" y="200" xlink:href="#p" />
<use x="144" y="216" xlink:href="#p" />
<use x="144" y="240" xlink:href="#p" />
<use x="144" y="272" xlink:href="#p" />
<use x="144" y="288" xlink:href="#p" />
<use x="152" y="32" xlink:href="#p" />
<use x="152" y="64" xlink:href="#p" />
<use x="152" y="104" xlink:href="#p" />
<use x="152" y="112" xlink:href="#p" />
<use x="152" y="120" xlink:href="#p" />
<use x="152" y="144" xlink:href="#p" />
<use x="152" y="168" xlink:href="#p" />
<use x="152" y="184" xlink:href="#p" />
<use x="152" y="192" xlink:href="#p" />
<use x="152" y="224" xlink:href="#p" />
<use x="152" y="248" xlink:href="#p" />
<use x="152" y="256" xlink:href="#p" />
<use x="152" y="264" xlink:href="#p" />
<use x="152" y="272" xlink:href="#p" />
<use x="152" y="280" xlink:href="#p" />
<use x="160" y="32" xlink:href="#p" />
<use x="160" y="40" xlink:href="#p" />
<use x="160" y="48" xlink:href="#p" />
<use x="160" y="56" xlink:href="#p" />
<use x="160" y="64" xlink:href="#p" />
<use x="160" y="72" xlink:href="#p" />
<use x="160" y="80" xlink:href="#p" />
<use x="160" y="88" xlink:href="#p" />
<use x="160" y="96" xlink:href="#p" />
<use x="160" y="152" xlink:href="#p" />
<use x="160" y="160" xlink:href="#p" />
<use x="160" y="184" xlink:href="#p" />
<use x="160" y="192" xlink:href="#p" />
<use x="160" y="208" xlink:href="#p" />
<use x="160" y="224" xlink:href="#p" />
<use x="160" y="232" xlink:href="#p" />
<use x="160" y="240" xlink:href="#p" />
<use x="160" y="248" xlink:href="#p" />
<use x="160" y="264" xlink:href="#p" />
<use x="160" y="288" xlink:href="#p" />
<use x="168" y="64" xlink:href="#p" />
<use x="168" y="72" xlink:href="#p" />
<use x="168" y="96" xlink:href="#p" />
<use x="168" y="104" xlink:href="#p" />
<use x="168" y="112" xlink:href="#p" />
<use x="168" y="120" xlink:href="#p" />
<use x="168" y="136" xlink:href="#p" />
<use x="168" y="152" xlink:href="#p" />
<use x="168" y="160" xlink:href="#p" />
<use x="168" y="168" xlink:href="#p" />
<use x="168" y="192" xlink:href="#p" />
<use x="168" y="200" xlink:href="#p" />
<use x="168" y="208" xlink:href="#p" />
<use x="168" y="224" xlink:href="#p" />
<use x="168" y="240" xlink:href="#p" />
<use x="168" y="248" xlink:href="#p" />
<use x="168" y="288" xlink:href="#p" />
<use x="176" y="32" xlink:href="#p" />
<use x="176" y="40" xlink:href="#p" />
<use x="176" y="56" xlink:href="#p" />
<use x="176" y="72" xlink:href="#p" />
<use x="176" y="80" xlink:href="#p" />
<use x="176" y="104" xlink:href="#p" />
<use x="176" y="120" xlink:href="#p" />
<use x="176" y="136" xlink:href="#p" />
<use x="176" y="144" xlink:href="#p" />
<use x="176" y="184" xlink:href="#p" />
<use x="176" y="200" xlink:href="#p" />
<use x="176" y="208" xlink:href="#p" />
<use x="176" y="224" xlink:href="#p" />
<use x="176" y="232" xlink:href="#p" />
<use x="176" y="256" xlink:href="#p" />
<use x="176" y="264" xlink:href="#p" />
<use x="184" y="48" xlink:href="#p" />
<use x="184" y="72" xlink:href="#p" />
<use x="184" y="88" xlink:href="#p" />
<use x="184" y="96" xlink:href="#p" />
<use x="184" y="120" xlink:href="#p" />
<use x="184" y="168" xlink:href="#p" />
<use x="184" y="184" xlink:href="#p" />
<use x="184" y="208" xlink:href="#p" />
<use x="184" y="216" xlink:href="#p" />
<use x="184" y="224" xlink:href="#p" />
<use x="184" y="232" xlink:href="#p" />
<use x="184" y="248" xlink:href="#p" />
<use x="184" y="256" xlink:href="#p" />
<use x="192" y="32" xlink:href="#p" />
<use x="192" y="40" xlink:href="#p" />
<use x="192" y="48" xlink:href="#p" />
<use x="192" y="64" xlink:href="#p" />
<use x="192" y="80" xlink:href="#p" />
<use x="192" y="88" xlink:href="#p" />
<use x="192" y="96" xlink:href="#p" />
<use x="192" y="104" xlink:href="#p" />
<use x="192" y="128" xlink:href="#p" />
<use x="192" y="144" xlink:href="#p" />
<use x="192" y="168" xlink:href="#p" />
<use x="192" y="176" xlink:href="#p" />
<use x="192" y="200" xlink:href="#p" />
<use x="192" y="216" xlink:href="#p" />
<use x="192" y="232" xlink:href="#p" />
<use x="192" y="240" xlink:href="#p" />
<use x="192" y="248" xlink:href="#p" />
<use x="192" y="256" xlink:href="#p" />
<use x="192" y="272" xlink:href="#p" />
<use x="200" y="32" xlink:href="#p" />
<use x="200" y="40" xlink:href="#p" />
<use x="200" y="48" xlink:href="#p" />
<use x="200" y="56" xlink:href="#p" />
<use x="200" y="88" xlink:href="#p" />
<use x="200" y="128" xlink:href="#p" />
<use x="200" y="136" xlink:href="#p" />
<use x="200" y="152" xlink:href="#p" />
<use x="200" y="168" xlink:href="#p" />
<use x="200" y="176" xlink:href="#p" />
<use x="200" y="184" xlink:href="#p" />
<use x="200" y="192" xlink:href="#p" />
<use x="200" y="208" xlink:href="#p" />
<use x="200" y="216" xlink:href="#p" />
<use x="200" y="256" xlink:href="#p" />
<use x="200" y="264" xlink:href="#p" />
<use x="200" y="272" xlink:href="#p" />
<use x="200" y="280" xlink:href="#p" />
<use x="208" y="48" xlink:href="#p" />
<use x="208" y="64" xlink:href="#p" />
<use x="208" y="72" xlink:href="#p" />
<use x="208" y="80" xlink:href="#p" />
<use x="208" y="96" xlink:href="#p" />
<use x="208" y="112" xlink:href="#p" />
<use x="208" y="128" xlink:href="#p" />
<use x="208" y="144" xlink:href="#p" />
<use x="208" y="152" xlink:href="#p" />
<use x="208" y="160" xlink:href="#p" />
<use x="208" y="184" xlink:href="#p" />
<use x="208" y="200" xlink:href="#p" />
<use x="208" y="208" xlink:href="#p" />
<use x="208" y="224" xlink:href="#p" />
<use x="208" y="240" xlink:href="#p" />
<use x="208" y="256" xlink:href="#p" />
<use x="208" y="272" xlink:href="#p" />
<use x="208" y="280" xlink:href="#p" />
<use x="216" y="32" xlink:href="#p" />
<use x="216" y="48" xlink:href="#p" />
<use x="216" y="72" xlink:href="#p" />
<use x="216" y="88" xlink:href="#p" />
<use x="216" y="96" xlink:href="#p" />
<use x="216" y="104" xlink:href="#p" />
<use x="216" y="128" xlink:href="#p" />
<use x="216" y="160" xlink:href="#p" />
<use x="216" y="168" xlink:href="#p" />
<use x="216" y="184" xlink:href="#p" />
<use x="216" y="200" xlink:href="#p" />
<use x="216" y="224" xlink:href="#p" />
<use x="216" y="232" xlink:href="#p" />
<use x="216" y="240" xlink:href="#p" />
<use x="216" y="248" xlink:href="#p" />
<use x="216" y="264" xlink:href="#p" />
<use x="216" y="272" xlink:href="#p" />
<use x="216" y="280" xlink:href="#p" />
<use x="216" y="288" xlink:href="#p" />
<use x="224" y="32" xlink:href="#p" />
<use x="224" y="48" xlink:href="#p" />
<use x="224" y="56" xlink:href="#p" />
<use x="224" y="72" xlink:href="#p" />
<use x="224" y="80" xlink:href="#p" />
<use x="224" y="128" xlink:href="#p" />
<use x="224" y="136" xlink:href="#p" />
<use x="224" y="144" xlink:href="#p" />
<use x="224" y="152" xlink:href="#p" />
<use x="224" y="160" xlink:href="#p" />
<use x="224" y="176" xlink:href="#p" />
<use x="224" y="184" xlink:href="#p" />
<use x="224" y="200" xlink:href="#p" />
<use x="224" y="216" xlink:href="#p" />
<use x="224" y="224" xlink:href="#p" />
<use x="224" y="232" xlink:href="#p" />
<use x="224" y="240" xlink:href="#p" />
<use x="224" y="248" xlink:href="#p" />
<use x="224" y="256" xlink:href="#p" />
<use x="224" y="288" xlink:href="#p" />
<use x="232" y="120" xlink:href="#p" />
<use x="232" y="136" xlink:href="#p" />
<use x="232" y="144" xlink:href="#p" />
<use x="232" y="152" xlink:href="#p" />
<use x="232" y="160" xlink:href="#p" />
<use x="232" y="192" xlink:href="#p" />
<use x="232" y="200" xlink:href="#p" />
<use x="232" y="208" xlink:href="#p" />
<use x="232" y="224" xlink:href="#p" />
<use x="232" y="256" xlink:href="#p" />
<use x="232" y="264" xlink:href="#p" />
<use x="240" y="32" xlink:href="#p" />
<use x="240" y="40" xlink:href="#p" />
<use x="240" y="48" xlink:href="#p" />
<use x="240" y="56" xlink:href="#p" />
<use x="240" y="64" xlink:href="#p" />
<use x="240" y="72" xlink:href="#p" />
<use x="240" y="80" xlink:href="#p" />
<use x="240" y="104" xlink:href="#p" />
<use x="240" y="112" xlink:href="#p" />
<use x="240" y="136" xlink:href="#p" />
<use x="240" y="144" xlink:href="#p" />
<use x="240" y="152" xlink:href="#p" />
<use x="240" y="168" xlink:href="#p" />
<use x="240" y="176" xlink:href="#p" />
<use x="240" y="200" xlink:href="#p" />
<use x="240" y="216" xlink:href="#p" />
<use x="240" y="224" xlink:href="#p" />
<use x="240" y="240" xlink:href="#p" />
<use x="240" y="256" xlink:href="#p" />
<use x="240" y="272" xlink:href="#p" />
<use x="240" y="288" xlink:href="#p" />
<use x="248" y="32" xlink:href="#p" />
<use x="248" y="80" xlink:href="#p" />
<use x="248" y="96" xlink:href="#p" />
<use x="248" y="104" xlink:href="#p" />
<use x="248" y="128" xlink:href="#p" />
<use x="248" y="144" xlink:href="#p" />
<use x="248" y="152" xlink:href="#p" />
<use x="248" y="160" xlink:href="#p" />
<use x="248" y="168" xlink:href="#p" />
<use x="248" y="176" xlink:href="#p" />
<use x="248" y="184" xlink:href="#p" />
<use x="248" y="224" xlink:href="#p" />
<use x="248" y="256" xlink:href="#p" />
<use x="248" y="272" xlink:href="#p" />
<use x="248" y="288" xlink:href="#p" />
<use x="256" y="32" xlink:href="#p" />
<use x="256" y="48" xlink:href="#p" />
<use x="256" y="56" xlink:href="#p" />
<use x="256" y="64" xlink:href="#p" />
<use x="256" y="80" xlink:href="#p" />
<use x="256" y="96" xlink:href="#p" />
<use x="256" y="112" xlink:href="#p" />
<use x="256" y="120" xlink:href="#p" />
<use x="256" y="128" xlink:href="#p" />
<use x="256" y="152" xlink:href="#p" />
<use x="256" y="160" xlink:href="#p" />
<use x="256" y="176" xlink:href="#p" />
<use x="256" y="184" xlink:href="#p" />
<use x="256" y="192" xlink:href="#p" />
<use x="256" y="224" xlink:href="#p" />
<use x="256" y="232" xlink:href="#p" />
<use x="256" y="240" xlink:href="#p" />
<use x="256" y="248" xlink:href="#p" />
<use x="256" y="256" xlink:href="#p" />
<use x="256" y="264" xlink:href="#p" />
<use x="256" y="280" xlink:href="#p" />
<use x="264" y="32" xlink:href="#p" />
<use x="264" y="48" xlink:href="#p" />
<use x="264" y="56" xlink:href="#p" />
<use x="264" y="64" xlink:href="#p" />
<use x="264" y="80" xlink:href="#p" />
<use x="264" y="104" xlink:href="#p" />
<use x="264" y="120" xlink:href="#p" />
<use x="264" y="128" xlink:href="#p" />
<use x="264" y="136" xlink:href="#p" />
<use x="264" y="160" xlink:href="#p" />
<use x="264" y="168" xlink:href="#p" />
<use x="264" y="184" xlink:href="#p" />
<use x="264" y="192" xlink:href="#p" />
<use x="264" y="200" xlink:href="#p" />
<use x="264" y="208" xlink:href="#p" />
<use x="264" y="224" xlink:href="#p" />
<use x="264" y="248" xlink:href="#p" />
<use x="264" y="256" xlink:href="#p" />
<use x="264" y="264" xlink:href="#p" />
<use x="264" y="272" xlink:href="#p" />
<use x="264" y="280" xlink:href="#p" />
<use x="272" y="32" xlink:href="#p" />
<use x="272" y="48" xlink:href="#p" />
<use x="272" y="56" xlink:href="#p" />
<use x="272" y="64" xlink:href="#p" />
<use x="272" y="80" xlink:href="#p" />
<use x="272" y="104" xlink:href="#p" />
<use x="272" y="112" xlink:href="#p" />
<use x="272" y="120" xlink:href="#p" />
<use x="272" y="136" xlink:href="#p" />
<use x="272" y="152" xlink:href="#p" />
<use x="272" y="168" xlink:href="#p" />
<use x="272" y="176" xlink:href="#p" />
<use x="272" y="184" xlink:href="#p" />
<use x="272" y="200" xlink:href="#p" />
<use x="272" y="216" xlink:href="#p" />
<use x="272" y="232" xlink:href="#p" />
<use x="272" y="240" xlink:href="#p" />
<use x="272" y="248" xlink:href="#p" />
<use x="272" y="264" xlink:href="#p" />
<use x="272" y="272" xlink:href="#p" />
<use x="272" y="280" xlink:href="#p" />
<use x="272" y="288" xlink:href="#p" />
<use x="280" y="32" xlink:href="#p" />
<use x="280" y="80" xlink:href="#p" />
<use x="280" y="112" xlink:href="#p" />
<use x="280" y="136" xlink:href="#p" />
<use x="280" y="144" xlink:href="#p" />
<use x="280" y="168" xlink:href="#p" />
<use x="280" y="176" xlink:href="#p" />
<use x="280" y="184" xlink:href="#p" />
<use x="280" y="192" xlink:href="#p" />
<use x="280" y="208" xlink:href="#p" />
<use x="280" y="216" xlink:href="#p" />
<use x="280" y="232" xlink:href="#p" />
<use x="280" y="240" xlink:href="#p" />
<use x="280" y="256" xlink:href="#p" />
<use x="280" y="288" xlink:href="#p" />
<use x="288" y="32" xlink:href="#p" />
<use x="288" y="40" xlink:href="#p" />
<use x="288" y="48" xlink:href="#p" />
<use x="288" y="56" xlink:href="#p" />
<use x="288" y="64" xlink:href="#p" />
<use x="288" y="72" xlink:href="#p" />
<use x="288" y="80" xlink:href="#p" />
<use x="288" y="96" xlink:href="#p" />
<use x="288" y="104" xlink:href="#p" />
<use x="288" y="120" xlink:href="#p" />
<use x="288" y="136" xlink:href="#p" />
<use x="288" y="160" xlink:href="#p" />
<use x="288" y="168" xlink:href="#p" />
<use x="288" y="200" xlink:href="#p" />
<use x="288" y="216" xlink:href="#p" />
<use x="288" y="232" xlink:href="#p" />
<use x="288" y="248" xlink:href="#p" />
<use x="288" y="256" xlink:href="#p" />
<use x="288" y="264" xlink:href="#p" />
</g>
</svg>
Side by side

Before

Width:  |  Height:  |  Size: 22 KiB

BIN
images/VM-Install/0.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 7.7 KiB

BIN
images/VM-Install/1.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 4.7 KiB

BIN
images/VM-Install/10.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 188 KiB

BIN
images/VM-Install/11.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 172 KiB

BIN
images/VM-Install/12.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 188 KiB

BIN
images/VM-Install/13.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 102 KiB

BIN
images/VM-Install/14.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 225 KiB

BIN
images/VM-Install/15.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 230 KiB

BIN
images/VM-Install/16.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 150 KiB

BIN
images/VM-Install/17.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 66 KiB

BIN
images/VM-Install/18.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 74 KiB

BIN
images/VM-Install/19.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 154 KiB

BIN
images/VM-Install/2.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 72 KiB

BIN
images/VM-Install/20.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 165 KiB

BIN
images/VM-Install/21.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 221 KiB

BIN
images/VM-Install/3.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 98 KiB

BIN
images/VM-Install/4.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 87 KiB

BIN
images/VM-Install/5.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 87 KiB

BIN
images/VM-Install/6.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 87 KiB

BIN
images/VM-Install/7.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 87 KiB

BIN
images/VM-Install/8.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 182 KiB

BIN
images/VM-Install/9.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 79 KiB

149
images/freeside.svg
View file

@ -1,149 +0,0 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="664.67126mm"
height="544.39447mm"
viewBox="0 0 664.67127 544.39446"
version="1.1"
id="svg8"
inkscape:version="0.92.4 5da689c313, 2019-01-14"
sodipodi:docname="freeside.svg">
<defs
id="defs2" />
<sodipodi:namedview
id="base"
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1.0"
inkscape:pageopacity="0.0"
inkscape:pageshadow="2"
inkscape:zoom="0.49497475"
inkscape:cx="963.81097"
inkscape:cy="1106.9227"
inkscape:document-units="mm"
inkscape:current-layer="layer1"
showgrid="false"
inkscape:window-width="1920"
inkscape:window-height="1015"
inkscape:window-x="0"
inkscape:window-y="41"
inkscape:window-maximized="1"
fit-margin-top="0"
fit-margin-left="0"
fit-margin-right="0"
fit-margin-bottom="0" />
<metadata
id="metadata5">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<g
inkscape:groupmode="layer"
id="layer2"
inkscape:label="Layer 2"
transform="translate(262.42217,214.9351)" />
<g
inkscape:label="Layer 1"
inkscape:groupmode="layer"
id="layer1"
transform="translate(256.32013,188.07742)">
<g
id="g3839"
transform="matrix(4.7535285,0,0,4.7535285,-285.32638,-40.308905)" />
<path
style="fill:#555555;stroke-width:1.25770438"
d="m -158.44572,346.4293 c -68.48033,-57.20044 -105.18725,-145.90342 -96.6563,-233.57165 4.49773,-46.22103 22.10939,-95.337619 48.67067,-135.736102 13.43656,-20.436413 23.022,-32.248623 41.72158,-51.413832 56.65584,-58.066606 129.103872,-95.352766 212.772015,-109.505396 15.906252,-2.69058 48.692822,-5.55804 41.996388,-3.67295 -1.383476,0.38946 -10.712361,3.53628 -20.730841,6.99293 -134.959974,46.56487 -238.062832,156.22792 -265.826882,282.74082 -4.37155,19.91985 -5.93327,31.43937 -6.90914,50.96265 -2.18096,43.63224 3.97845,86.28589 17.99143,124.58972 6.44203,17.60902 21.60663,47.79934 32.04515,63.79687 4.87762,7.47517 8.8684,13.84232 8.8684,14.14916 0,1.75919 -3.34162,-0.47749 -13.94247,-9.33222 z"
id="path3841"
inkscape:connector-curvature="0"
sodipodi:nodetypes="csssscsssscsc" />
<g
aria-label="FREE"
transform="matrix(5.0597708,0,0,4.4658216,-285.32638,-315.74614)"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:9.71103096px;line-height:1.25;font-family:'RobotoMono NF';-inkscape-font-specification:'RobotoMono NF';letter-spacing:0px;word-spacing:0px;fill:#525252;fill-opacity:1;stroke:none;stroke-width:0.24277578"
id="text3864">
<path
d="M 57.566433,83.218887 H 50.624562 V 49.94343 h 19.073074 v 5.781098 H 57.566433 v 8.580607 h 11.289074 v 5.758339 H 57.566433 Z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:46.61295319px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-5.05837488px;word-spacing:0px;fill:#525252;fill-opacity:1;stroke-width:0.24277578"
id="path4783"
inkscape:connector-curvature="0" />
<path
d="m 78.20436,64.714819 h 2.276023 q 3.345754,0 4.93897,-1.115251 1.593216,-1.115251 1.593216,-3.505075 0,-2.367064 -1.638736,-3.368515 -1.615977,-1.00145 -5.030011,-1.00145 H 78.20436 Z m 0,5.735579 V 83.218887 H 71.148688 V 49.94343 h 9.695859 q 6.782549,0 10.037262,2.480865 3.254713,2.458105 3.254713,7.488116 0,2.93607 -1.615977,5.234853 -1.615976,2.276023 -4.574806,3.573356 7.510876,11.220794 9.786899,14.498267 H 89.903119 L 81.959798,70.450398 Z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:46.61295319px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-5.05837488px;word-spacing:0px;fill:#525252;fill-opacity:1;stroke-width:0.24277578"
id="path4785"
inkscape:connector-curvature="0" />
<path
d="M 116.02626,83.218887 H 96.862146 V 49.94343 h 19.164114 v 5.781098 h -12.10844 v 7.306034 h 11.26631 v 5.781099 h -11.26631 v 8.580607 h 12.10844 z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:46.61295319px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-5.05837488px;word-spacing:0px;fill:#525252;fill-opacity:1;stroke-width:0.24277578"
id="path4787"
inkscape:connector-curvature="0" />
<path
d="M 137.09663,83.218887 H 117.93252 V 49.94343 h 19.16411 v 5.781098 h -12.10844 v 7.306034 h 11.26631 v 5.781099 h -11.26631 v 8.580607 h 12.10844 z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:46.61295319px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-5.05837488px;word-spacing:0px;fill:#525252;fill-opacity:1;stroke-width:0.24277578"
id="path4789"
inkscape:connector-curvature="0" />
</g>
<text
xml:space="preserve"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:50.30817795px;line-height:1.25;font-family:'RobotoMono NF';-inkscape-font-specification:'RobotoMono NF';letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1.25770438"
x="474.68643"
y="106.05875"
id="text4684"><tspan
sodipodi:role="line"
id="tspan4682"
x="474.68643"
y="150.56969"
style="stroke-width:1.25770438" /></text>
<g
aria-label="SIDE"
transform="matrix(4.9474906,0,0,4.5671707,-285.32638,-315.74614)"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:12.54906654px;line-height:1.25;font-family:'RobotoMono NF';-inkscape-font-specification:'RobotoMono NF';letter-spacing:0px;word-spacing:0px;fill:#fe6431;fill-opacity:1;stroke:none;stroke-width:0.31372666"
id="text3864-3">
<path
d="m 60.192619,114.0496 q 0,5.82355 -4.205899,9.17651 -4.176486,3.35295 -11.647104,3.35295 -6.882379,0 -12.176517,-2.58825 v -8.47062 q 4.352958,1.94119 7.352969,2.73531 3.029424,0.79412 5.529434,0.79412 3.000011,0 4.588253,-1.14706 1.617653,-1.14707 1.617653,-3.41178 0,-1.26471 -0.705885,-2.23531 -0.705885,-1 -2.088244,-1.91177 -1.352946,-0.91177 -5.558845,-2.91177 -3.941191,-1.85295 -5.911787,-3.55884 -1.970596,-1.70589 -3.147071,-3.970604 -1.176475,-2.264715 -1.176475,-5.294138 0,-5.705905 3.852956,-8.970623 3.882368,-3.264719 10.705924,-3.264719 3.352954,0 6.382377,0.794121 3.058835,0.794121 6.382378,2.235303 l -2.941188,7.088262 q -3.44119,-1.41177 -5.705904,-1.970596 -2.235303,-0.558825 -4.411782,-0.558825 -2.588246,0 -3.970604,1.205887 -1.382358,1.205887 -1.382358,3.147071 0,1.205887 0.558826,2.117655 0.558825,0.882356 1.764712,1.735301 1.235299,0.823532 5.79414,3.000015 6.029435,2.88236 8.264738,5.79414 2.235303,2.88236 2.235303,7.08826 z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:60.23552704px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-6.39080191px;word-spacing:0px;fill:#fe6431;fill-opacity:1;stroke-width:0.31372666"
id="path4774"
inkscape:connector-curvature="0" />
<path
d="M 61.595963,125.99082 V 82.990656 h 9.117682 v 43.000164 z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:60.23552704px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-6.39080191px;word-spacing:0px;fill:#fe6431;fill-opacity:1;stroke-width:0.31372666"
id="path4776"
inkscape:connector-curvature="0" />
<path
d="m 110.88185,104.07897 q 0,10.61769 -6.05885,16.26477 -6.029433,5.64708 -17.441242,5.64708 H 75.205241 V 82.990656 h 13.500052 q 10.529452,0 16.353007,5.558845 5.82355,5.558845 5.82355,15.529469 z m -9.47063,0.2353 q 0,-13.852997 -12.235337,-13.852997 h -4.85296 v 28.000107 h 3.91178 q 13.176517,0 13.176517,-14.14711 z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:60.23552704px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-6.39080191px;word-spacing:0px;fill:#fe6431;fill-opacity:1;stroke-width:0.31372666"
id="path4778"
inkscape:connector-curvature="0" />
<path
d="m 138.16765,125.99082 h -24.7648 V 82.990656 h 24.7648 v 7.470617 h -15.64712 v 9.441213 h 14.55888 v 7.470614 h -14.55888 v 11.08828 h 15.64712 z"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:60.23552704px;line-height:1;font-family:'Open Sans';-inkscape-font-specification:'Open Sans Bold';letter-spacing:-6.39080191px;word-spacing:0px;fill:#fe6431;fill-opacity:1;stroke-width:0.31372666"
id="path4780"
inkscape:connector-curvature="0" />
</g>
<flowRoot
xml:space="preserve"
id="flowRoot4569"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:40px;line-height:1.25;font-family:'RobotoMono NF';-inkscape-font-specification:'RobotoMono NF';letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none"
transform="matrix(4.7535285,0,0,4.7535285,-285.32638,-315.74614)"><flowRegion
id="flowRegion4571"><rect
id="rect4573"
width="299.00516"
height="52.527931"
x="166.67517"
y="221.72583" /></flowRegion><flowPara
id="flowPara4575" /></flowRoot> </g>
</svg>
Side by side

Before

Width:  |  Height:  |  Size: 10 KiB

BIN
images/linux-logos.png
View file

Binary file not shown.
Side by side

Before

Width:  |  Height:  |  Size: 753 KiB

8649
images/linux-timeline-17.10.svg
View file

File diff suppressed because one or more lines are too long
Side by side

Before

Width:  |  Height:  |  Size: 618 KiB

4
images/linux-vs-windows-desktop-os.svg
View file

@ -1,4 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN"
"http://www.w3.org/TR/2001/
REC-SVG-20010904/DTD/svg10.dtd"><svg xmlns="http://www.w3.org/2000/svg" width="300" height="300" style="overflow: hidden;" aria-label="A chart."><defs id="defs"/><rect x="0" y="0" width="300" height="300" stroke="none" stroke-width="0" fill="#ffffff"/><g><path d="M150,150L150,15A135,135,0,0,1,163.6869640295794,15.695618032571247L150,150A0,0,0,0,0,150,150" stroke="#ffffff" stroke-width="1" fill="#fe6431"/></g><g><path d="M150,150L72.52078697320243,39.44697404074314A135,135,0,0,1,150,15L150,150A0,0,0,0,0,150,150" stroke="#ffffff" stroke-width="1" fill="#fcf532"/></g><g><path d="M150,150L17.039250092938886,126.6239656025247A135,135,0,0,1,72.52078697320243,39.44697404074314L150,150A0,0,0,0,0,150,150" stroke="#ffffff" stroke-width="1" fill="#adadad"/></g><g><path d="M150,150L163.6869640295794,15.695618032571247A135,135,0,1,1,17.039250092938886,126.6239656025247L150,150A0,0,0,1,0,150,150" stroke="#ffffff" stroke-width="1" fill="#3164fe"/></g><g/><circle cx="422" cy="150" r="120" fill="#FFFFFF" stroke="none" stroke-width="0"/></svg>
Side by side

Before

Width:  |  Height:  |  Size: 1.1 KiB

4
images/linux-vs-windows-server-os.svg
View file

@ -1,4 +0,0 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN"
"http://www.w3.org/TR/2001/
REC-SVG-20010904/DTD/svg10.dtd"><svg xmlns="http://www.w3.org/2000/svg" width="300" height="300" style="overflow: hidden;" aria-label="A chart."><defs id="defs"/><rect x="0" y="0" width="300" height="300" stroke="none" stroke-width="0" fill="#ffffff"/><g><path d="M150,150L23.27092921672697,196.52679462855974A135,135,0,0,1,150,15L150,150A0,0,0,0,0,150,150" stroke="#ffffff" stroke-width="1" fill="#3164fe"/></g><g><path d="M150,150L150,15A135,135,0,1,1,23.27092921672697,196.52679462855974L150,150A0,0,0,1,0,150,150" stroke="#ffffff" stroke-width="1" fill="#fe6431"/></g><g/><circle cx="422" cy="150" r="120" fill="#FFFFFF" stroke="none" stroke-width="0"/></svg>
Side by side

Before

Width:  |  Height:  |  Size: 796 B

374
index.html
View file

@ -1,374 +0,0 @@
<!DOCTYPE html>
<html>
<head>
<meta charset='utf-8' />
<title>Linux 101 • Freeside</title>
</head>
<body>
<main class="js-deck3000">
<section>
<article class="title">
<h1>Linux 101</h1>
</article>
<article>
<h2>Structure</h2>
<ul>
<li>Introduction - why and where</li>
<li>Installation of Ubuntu</li>
<li>Writing and compiling a simple C&sharp; program</li>
</ul>
</article>
<article>
<h2>Why?</h2>
<div class="flex horizontal">
<div><img alt="A simple pie chart. Explained below." src="./images/linux-vs-windows-desktop-os.svg" aria-hidden="true" /></div>
<ul>
<li>74.44% Windows</li>
<li>12.22% macOS</li>
<li>9.51% Other</li>
<li>1.58% Linux</li>
</ul>
</div>
<p><small>According to <a href="http://gs.statcounter.com/os-market-share/desktop/worldwide">statcounter GlobalStats</a></small></p>
</article>
<article>
<h2>Why?</h2>
<div class="flex horizontal">
<div><img alt="A simple pie chart. Explained below." src="./images/linux-vs-windows-server-os.svg" aria-hidden="true" /></div>
<ul>
<li>69.4% of webservers use a Unix-based OS</li>
<li>30.6% of webservers use Windows</li>
</ul>
</div>
<p><small>
According to
<a href="https://w3techs.com/technologies/overview/operating_system/all">W<sup>3</sup>Techs</a>
</small></p>
</article>
<article>
<h2>Where?</h2>
<ul>
<li>US Department of Defence</li>
<!-- Largest Single Red Hat user in the world -->
<li>French Parliament</li>
<li>Amazon</li>
<li>Android</li>
</ul>
<p><small>Sources: <a href="https://www.comparebusinessproducts.com/fyi/50-places-linux-running-you-might-not-expect">1</a></small></p>
</article>
</section>
<section>
<article class="title">
<h1>Installing Ubuntu</h1>
</article>
<article>
<h2>What's Ubuntu?</h2>
<ul>
<li>A distribution of Linux</li>
<li>Others are available, but Ubuntu is great for beginners</li>
<li>Lots of help available online if you get stuck</li>
</ul>
</article>
<article>
<img src="./images/linux-logos.png" alt="The logos of a number of different linux distributions.">
</article>
<article>
<img src="./images/linux-timeline-17.10.svg" alt="A timeline of different linux distributions.">
</article>
<article>
<h2>Let's Get Started!</h2>
<ul>
<li>Open Hyper-V to access the VM</li>
</ul>
<!-- <ul>
<li>Visit here to access the VMs:</li>
<li><a href="http://www2.dcs.hull.ac.uk/people/cssaph/FreesideLinux101/">http://www2.dcs.hull.ac.uk/people/cssaph/FreesideLinux101/</a> (short link: <a href="https://tinyurl.com/freesidelinux101">https://tinyurl.com/freesidelinux101</a>)</li>
</ul> -->
</article>
<article>
<h2>Choosing the language</h2>
<img alt="Install step 0: Choosing the language" src="./images/VM-Install/0.png" />
</article>
<article>
<h2>Boot menu</h2>
<img alt="Install step 1: Boot menu" src="./images/VM-Install/1.png" />
</article>
<article>
<h2>Welcome</h2>
<img alt="Install step 2" src="./images/VM-Install/2.png" />
</article>
<article>
<h2>Keyboard Layout</h2>
<img alt="Install step 3: keyboard layout" src="./images/VM-Install/3.png" />
</article>
<article>
<h2>Initial Software and Updates</h2>
<img alt="Install step 4" src="./images/VM-Install/4.png" />
</article>
<article>
<h2>Partitioning</h2>
<img alt="Install step 5" src="./images/VM-Install/5.png" />
</article>
<article>
<h2>Dual Booting</h2>
<img alt="Install step 6" src="./images/VM-Install/6.png" />
</article>
<article>
<h2>I'm sure it's fine.....</h2>
<img alt="Install step 7" src="./images/VM-Install/7.png" />
</article>
<article>
<h2>Location</h2>
<img alt="Install step 8" src="./images/VM-Install/8.png" />
</article>
<article>
<h2>Credentials</h2>
<img alt="Install step 9" src="./images/VM-Install/9.png" />
</article>
<article>
<h2>Now we wait!</h2>
<img alt="Install step 10" src="./images/VM-Install/10.png" />
</article>
<article>
<h2>and wait</h2>
<img alt="Install step 12" src="./images/VM-Install/12.png" />
</article>
<article>
<h2>Complete!</h2>
<img alt="Install step 13" src="./images/VM-Install/13.png" />
</article>
<article>
<h2>Logging in</h2>
<img alt="Install step 14" src="./images/VM-Install/14.png" />
</article>
<article>
<h2>Type your password</h2>
<img alt="Install step 15" src="./images/VM-Install/15.png" />
</article>
<article>
<img alt="Install step 16" src="./images/VM-Install/16.png" />
</article>
<article>
<img alt="Install step 17" src="./images/VM-Install/17.png" />
</article>
<article>
<img alt="Install step 18" src="./images/VM-Install/18.png" />
</article>
<article>
<h2>The amazing <code>apt</code></h2>
<img alt="Install step 20" src="./images/VM-Install/20.png" />
</article>
<article>
<h2>Doing it manually</h2>
<img alt="Install step 21" src="./images/VM-Install/21.png" />
</article>
<article>
<h2>Done!</h2>
<ul>
<li>Installation complete!</li>
<li>What next?</li>
<li>Linux basics</li>
<li>Let's write some C&sharp;</li>
</ul>
</article>
</section>
<section>
<article class="title">
<h1>Linux Basics</h1>
</article>
<article>
<h2>Things to talk about</h2>
<ul>
<li>Similarities and differences to Windows</li>
<li>Filesystem structure</li>
<li>Typing your password with <code>sudo</code></li>
</ul>
</article>
<article>
<h2>Similarities and Differences</h2>
<ul>
<li>Command line → Terminal</li>
<li>Package management - more on this later</li>
<li>File system: ext4, not NTFS</li>
</ul>
</article>
<article>
<h2>Filesystem Structure</h2>
<ul>
<li>Everything starts with <code>/</code></li>
<li>...and everything is a file</li>
</ul>
</article>
<article>
<h2>Places to remember</h2>
<table>
<tr>
<td><code>/etc</code></td>
<td>Configuration files</td>
</tr>
<tr>
<td><code>/home</code></td>
<td>User home folders</td>
</tr>
<tr>
<td><code>/usr/bin</code></td>
<td>Program binaries (also other places; some are symlinks)</td>
</tr>
<tr>
<td><code>/var/log</code></td>
<td>Log files</td>
</tr>
<tr>
<td><code>/dev</code></td>
<td>Hardware devices</td>
</tr>
</table>
</article>
<article class="">
<h2>Typing your password</h2>
<ul>
<li>On Linux, typing your password is a key security mechanism</li>
<li>
Ask yourself:
<ul>
<li>"Why am I typing my password?"</li>
<li>"Do I understand what it's going to do?"</li>
<li>"Do I trust the program?"</li>
</ul>
</li>
<li>Ask for help / an explanation if unsure</li>
</ul>
</article>
</section>
<section>
<article class="title">
<h1>Let's Compile some C&sharp;!</h1>
</article>
<article>
<h2>Package Management</h2>
<ul>
<li>Most Linux distributions use a <em>package manager</em></li>
<li><em>Everything</em> is a package - from your kernel to the software that you use</li>
<li>Debian-based distributions use <code>apt</code></li>
<li>GUIs do exist - Synaptic</li>
</ul>
</article>
<article>
<h2>Mono</h2>
<ul>
<li><em>Mono</em> is the .NET runtime on Linux</li>
<li>Mono isn't available in the default <code>apt</code> repositories on Ubuntu</li>
<li>...so we need to add a new apt repository!</li>
<li><a href="https://www.mono-project.com/download/stable/">https://www.mono-project.com/download/stable/</a></li>
</ul>
</article>
<article>
<h2>Installation</h2>
<ul>
<li>We have the <code>apt</code> repository</li>
<li>Now we can install <code>Mono</code></li>
<li><code>sudo apt install mono-devel</code></li>
</ul>
</article>
<article>
<h2>Usage</h2>
<ul>
<li>The Linux terminal is similar to the Windows command prompt</li>
<li>Download a <em>Visual Studio</em> solution now if possible</li>
<li>Use a text editor to write a quick program otherwise</li>
</ul>
</article>
<article>
<h2>Usage (cont.)</h2>
<ul>
<li>We can use <code>csc</code> and <code>msbuild</code> to compile just like we do on Windows</li>
<li><code>csc MyFile.cs</code></li>
<li><code>msbuild</code></li>
</ul>
</article>
</section>
<section>
<article class="title">
<h1>Monodevelop</h1>
</article>
<article>
<h2>What's Monodevelop?</h2>
<ul>
<li>Writing C&sharp; code in a text editor is old-school</li>
<li>Like <em>Visual Studio</em>, but on Linux</li>
<li>Actually the base of <em>Visual Studio for Mac</em></li>
</ul>
</article>
<article>
<h2>Installing</h2>
<ul>
<li>Same prodecure as with Mono</li>
<li>Challenge: Can you install Monodevelop using what you've learnt?</li>
<li><a href="https://www.monodevelop.com/download/">https://www.monodevelop.com/download/</a></li>
</ul>
</article>
</section>
<section>
<article class="title">
<h1>Summary</h1>
</article>
<article>
<h2>Summary</h2>
<ul>
<li>We've installed Ubuntu</li>
<li>We've installed Mono</li>
<li>We've compiled some C&sharp;</li>
<li>We've looked at Monodevelop</li>
</ul>
</article>
<article>
<h2>Where next?</h2>
<ul>
<li>Web server setup</li>
<li>Application server setup</li>
<li>Git hosting</li>
<li><s>Email hosting</s></li>
<li>Decentralised Instant Messaging</li>
</ul>
</article>
<article>
<h2>Future Workshops</h2>
<ul>
<li>201: Securing a Linux server & hosting a static website</li>
<li>301: Deploying your application to a Linux server</li>
<li>Talks</li>
</ul>
</article>
<article>
<h2>Thanks for coming!</h2>
<ul>
<li>Bought to you by Freeside</li>
<li><div class="flex flex-align-centre">
<!-- <span>Feedback: <a href="https://forms.gle/CN2Pkm4fnHjGzs889">https://forms.gle/CN2Pkm4fnHjGzs889</a></span>
<img src="images/QR-Feedback.svg" aria-hidden="true" /> -->
<span>Feedback: <a href="https://forms.gle/cbWKnurf75Exi8ry8">https://forms.gle/cbWKnurf75Exi8ry8</a></span>
<img alt="A QR code of the aforementioned link" src="images/QR-Feedback.svg" aria-hidden="true" />
</div></li>
<li>Join us: <a href="https://freeside.co.uk/">https://freeside.co.uk/</a></li>
<li>Discord | Forums | PC Access</li>
<li>Questions?</li>
</ul>
</article>
</section>
</main>
<!---------------->
<link rel="stylesheet" href="linux101.css" />
<script src="linux101.js"></script>
</body>
</html>

19
js/index.mjs
View file

@ -1,19 +0,0 @@
import "../css/theme.css";
import Deck3000 from 'deck3000';
window.addEventListener("load", function(_event) {
console.log("[main] Built on ", new Date("__BUILD_DATE__"));
const Slideshow = new Deck3000({
slideSelector: "article",
resetSlides: true,
keyboardEvents: true,
updateURL: false // FUTURE: Is there a way of doing this with #THING instead of /THING?
});
Slideshow.emitter.on("navigate", (event) => {
console.debug(event);
})
});

1
lantern-build-engine

@ -1 +0,0 @@
Subproject commit 411df752dd800490dd4a627f5ef6df9bace5341a

3176
package-lock.json generated
View file

File diff suppressed because it is too large Load diff

29
package.json
View file

@ -1,29 +0,0 @@
{
"private": true,
"name": "linux-101",
"version": "1.0.0",
"description": "The slide desk for the Linux 101 workshop.",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"repository": {
"type": "git",
"url": "https://git.starbeamrainbowlabs.com/sbrl/Linux101"
},
"author": "Starbeamrainbowlabs",
"license": "MPL-2.0",
"dependencies": {
"deck3000": "^1.0.12"
},
"devDependencies": {
"postcss-copy": "^7.1.0",
"postcss-import": "^12.0.1",
"rollup": "^1.6.0",
"rollup-plugin-commonjs": "^9.2.1",
"rollup-plugin-node-resolve": "^4.0.1",
"rollup-plugin-postcss": "^2.0.3",
"rollup-plugin-replace": "^2.1.0",
"rollup-plugin-terser": "^4.0.4"
}
}

93
rollup.config.js
View file

@ -1,93 +0,0 @@
import os from 'os';
import path from 'path';
import fs from 'fs';
import resolve from 'rollup-plugin-node-resolve';
import commonjs from 'rollup-plugin-commonjs';
import postcss from 'rollup-plugin-postcss';
import { terser } from "rollup-plugin-terser";
import replace from 'rollup-plugin-replace';
import postcss_import from 'postcss-import';
import postcss_copy from 'postcss-copy';
let is_production = process.env.NODE_ENV == "production";
let plugins = [
resolve({
// use "module" field for ES6 module if possible
module: true, // Default: true
// use "jsnext:main" if possible
// – see https://github.com/rollup/rollup/wiki/jsnext:main
jsnext: true, // Default: false
// use "main" field or index.js, even if it's not an ES6 module
// (needs to be converted from CommonJS to ES6
// – see https://github.com/rollup/rollup-plugin-commonjs
main: true, // Default: true
// some package.json files have a `browser` field which
// specifies alternative files to load for people bundling
// for the browser. If that's you, use this option, otherwise
// pkg.browser will be ignored
browser: true, // Default: false
// not all files you want to resolve are .js files
extensions: ['.mjs', '.js', '.jsx', '.json'], // Default: [ '.mjs', '.js', '.json', '.node' ]
}),
replace({
exclude: 'node_modules/**',
values: {
"__BUILD_DATE__": () => new Date().toISOString(),
// "__VERSION__": fs.readFileSync("version", "utf8").trim()
}
}),
commonjs({
}),
postcss({
plugins: [
postcss_import({}),
postcss_copy({
dest: "app",
template: "resources/[name].[ext]"
})
// postcss_url(),
// postcss_url({
// url: "copy",
// basePath: path.resolve("."),
// assetPath: "resources"
// })
],
// Save it to a .css file - we'll reference it ourselves thank you
// very much
extract: true,
sourceMap: true,
minimize: is_production, // Causes an error at the moment for some reason
})
];
if(is_production) {
console.log("[config] In production environment - minifying JS");
plugins.push(terser({
numWorkers: os.cpus().length,
compress: {
ecma: 6
}
}));
}
export default {
input: 'js/index.mjs',
output: {
file: 'dist/linux101.js',
format: 'esm'
},
plugins
};