Compare commits
No commits in common. "main" and "#29-nix_nixos-assignment" have entirely different histories.
main
...
#29-nix_ni
8 changed files with 19 additions and 121 deletions
|
@ -10,7 +10,6 @@ on:
|
|||
- .forgejo/**/*
|
||||
- mkdocs.yml
|
||||
|
||||
|
||||
jobs:
|
||||
# Build it locally, this helps caching for later
|
||||
build:
|
||||
|
|
|
@ -10,7 +10,7 @@ Uses [mkdocs][2] to generate the site.
|
|||
|
||||
|
||||
## Hooks
|
||||
Run this command to set up the hooks properly so the git information can be stored within the repo
|
||||
Run this command to set up the hooks properly so teh git information can be stored within the repo
|
||||
|
||||
```bash
|
||||
git config --local core.hooksPath .githooks/
|
||||
|
|
BIN
_git.tar.gz
(Stored with Git LFS)
BIN
_git.tar.gz
(Stored with Git LFS)
Binary file not shown.
|
@ -23,49 +23,11 @@ This work is being done with Rust.
|
|||
|
||||
Use your Skynet ``username@skynet.ie`` and ``password`` to login.
|
||||
|
||||
### IMAP / SMTP settings
|
||||
|
||||
Use your full Skynet email ``username@skynet.ie`` and ``password``.
|
||||
|
||||
#### SMTP
|
||||
Server: ``mail.skynet.ie``
|
||||
Port: ``993``
|
||||
Authentication Method: ``Normal Password``
|
||||
Connection Security: ``SSL/TLS``
|
||||
|
||||
#### IMAP
|
||||
Server: ``mail.skynet.ie``
|
||||
Port: ``465``
|
||||
Authentication Method: ``Normal Password``
|
||||
Connection Security: ``SSL/TLS``
|
||||
|
||||
## Sieve Scripts
|
||||
Sieve scripts allow you to sort and manage yer email in a programmatic way.
|
||||
|
||||
Recommended tool: <https://github.com/thsmi/sieve>
|
||||
|
||||
* Download and open the tool.
|
||||
* Enter settings for skynet.
|
||||
- Hostname: ``mail.skynet.ie``
|
||||
- Port: ``4190``
|
||||
- Username: ``username@skynet.ie``
|
||||
* Hit Create.
|
||||
* Hit Connect and enter your ``password``.
|
||||
|
||||
### ``.forwards`` replacement
|
||||
Since we no longer support ``.forwards`` this is the sieve script counterpart.
|
||||
It copies all incoming mail to the target address.
|
||||
|
||||
* Continuing from above
|
||||
* Hit Create new script, enter a name and press edit.
|
||||
* Enter code below. (You may also use the gui drag and drop builder to create the script)
|
||||
```sieve
|
||||
require "copy";
|
||||
|
||||
redirect :copy "sending_mail_to@example.ie";
|
||||
```
|
||||
* Save the script.
|
||||
* Go back to the home tab and press activate on your newly created script. This will enable the forwarding
|
||||
Small tutorial will follow later.
|
||||
|
||||
### Committee/Admins
|
||||
There is an inbuilt sieve script that passes mail from committee/admin addresses into a folder in their Skynet inbox.
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
|
||||
Forgejo is an online git repo host.
|
||||
Like [Gitlab](./gitlab.md) it is self hostable meaning that Skynet has its own instance of it.
|
||||
Structure wise it has more in common with Github with the flatter ``owner/repo`` structure as well as being compatible with Github Actions
|
||||
Structure wise it has more in common with Github with teh flatter ``owner/repo`` structure as well as being compatible with Github Actions
|
||||
|
||||
Honestly I (@silver) just love the slogan of Forgejo:
|
||||
> Beyond coding. We Forge.
|
||||
|
|
|
@ -8,7 +8,7 @@
|
|||
3. Enter the same email used for UL Wolves.
|
||||
* This is the ``Preferred Contact Email`` on your [profile page][profile].
|
||||
4. You will get an email to verify your address, follow the link in the email.
|
||||
* You may need to check the spam folder.
|
||||
* You may need to check teh spam folder.
|
||||
* It may also take up to 15 min to be delivered.
|
||||
5. Choose a ``username`` and ``password``.
|
||||
|
||||
|
|
|
@ -4,10 +4,7 @@ To be able to gain remote access to the Skynet.
|
|||
|
||||
``$USERNAME`` Refers to your Skynet username, for example I would replace ``$USERNAME`` with ``silver``
|
||||
|
||||
## Windows
|
||||
If you are using Windows then you should use PowerShell, not ``cmd``.
|
||||
|
||||
## Prep
|
||||
## Create Key
|
||||
First we set up the ssh folder and create a skynet folder within it for neatness
|
||||
|
||||
```bash
|
||||
|
@ -15,22 +12,13 @@ mkdir -f -p ~/.ssh/skynet
|
|||
cd ~/.ssh/skynet
|
||||
```
|
||||
|
||||
## Create Key
|
||||
Now we will create the ssh key itself.
|
||||
Now we will create the ssh key itself.
|
||||
Location: ``$USERNAME``, your skynet username.
|
||||
Password: Press Enter twice for no password on the key.
|
||||
|
||||
```bash
|
||||
ssh-keygen -t ed25519 -C "<comment>"
|
||||
```
|
||||
|
||||
* ``<comment>``: this is a comment to yerself about what the key is for
|
||||
* I often use ``username@host``, ``silver@skynet``.
|
||||
* Location: ``./$USERNAME``, your skynet username.
|
||||
* ``./silver`` for example.
|
||||
* **Password: Press Enter twice for no password on the key.**
|
||||
|
||||
If you are creating this key for a CI/CD pipeline (``user_deploy*``) then adding a password will cause it to fail.
|
||||
|
||||
|
||||
It will create two files: ``$USERNAME`` and ``$USERNAME.pub`` inside ``~/.ssh/skynet``
|
||||
|
||||
### Linux Only
|
||||
|
@ -79,7 +67,7 @@ nano config
|
|||
Or open up in a text editor.
|
||||
|
||||
### Windows/Linux
|
||||
This is what we want to have in the file.
|
||||
This is what we want to have in teh file.
|
||||
```
|
||||
Host *.skynet.ie
|
||||
User $USERNAME
|
||||
|
@ -91,7 +79,7 @@ Host *.skynet.ie
|
|||
|
||||
|
||||
## Add key to account
|
||||
Go to [the modify SSH page](https://account.skynet.ie/modify_ssh) and paste in the contents of ``$USERNAME.pub``.
|
||||
Go to [the modify SSH page](https://account.skynet.ie/modify_ssh) and paste in teh contents of ``$USERNAME.pub``.
|
||||
|
||||
You will now be able to SSH into Skynet like so:
|
||||
|
||||
|
|
|
@ -1,42 +1,11 @@
|
|||
# Create your own website on Skynet
|
||||
|
||||
One of the services that Skynet provides is access to a Linux server which also has a webserver.
|
||||
Additionally each member gets their own domain:
|
||||
|
||||
* ``$USERNAME.users.skynet.ie``
|
||||
* This is the core web address
|
||||
* <https://silver.users.skynet.ie>
|
||||
* ``skynet.ie/~$USERNAME``
|
||||
* This is backwards compatible to help avoid link rot
|
||||
* Redirects to the core address above
|
||||
* <https://skynet.ie/~silver>
|
||||
|
||||
## Website
|
||||
There are two ways to create a website on Skynet, Modern and Manual.
|
||||
Modern is using Source Control (git), pipelines (CI/CD) and pinch of magic.
|
||||
Manual gets you hands on with the process.
|
||||
|
||||
|
||||
### Skynet Account requirement
|
||||
No matter if you choose Modern or Manual you will need a Skynet account.
|
||||
Instructions to do so can be found [on the Create Skynet Account page](./create_account.md).
|
||||
|
||||
### Modern
|
||||
Modern involves using source control to version your site.
|
||||
This is then leveraged to automatically deploy to your Skynet account/website.
|
||||
|
||||
The core repo for this is [here][deploy_user], it contains all the required info to get it working.
|
||||
If this does not suit your needs you can take a look at the [forks which cover different tools][deploy_user_forks].
|
||||
|
||||
[deploy_user]: https://forgejo.skynet.ie/Skynet/deploy_user
|
||||
[deploy_user_forks]: https://forgejo.skynet.ie/Skynet/deploy_user/forks
|
||||
|
||||
### Manual
|
||||
#### Login
|
||||
## Login
|
||||
Once ye have [logged in](./create_ssh.md) you will be able to create a website on Skynet.
|
||||
|
||||
## Website
|
||||
### Manually
|
||||
|
||||
#### Create Files
|
||||
In your home folder follow these commands to create the folder that can be used to host a website
|
||||
|
||||
```bash
|
||||
|
@ -46,32 +15,12 @@ chmod -R 755 ~/public_html
|
|||
cd ~/public_html
|
||||
```
|
||||
|
||||
In this directory you can create all the relevant files using ``nano`` or ``vim``.
|
||||
|
||||
```bash
|
||||
# create/edit index.html usign nano
|
||||
# this opens up a termial based text editor.
|
||||
nano index.html
|
||||
```
|
||||
|
||||
To exit ``nano`` you need to use ``[ctrl]+[x]`` keys.
|
||||
|
||||
#### Transfer files
|
||||
If you already have the files locally you can copy them over using ``scp``, although it is recommended to do it graphically.
|
||||
|
||||
To transfer files graphically you can use these programs:
|
||||
* WinSCP
|
||||
* FileZilla
|
||||
|
||||
* [WinSCP][download_winscp]
|
||||
* Windows
|
||||
* [FileZilla][download_filezilla]
|
||||
* Windows
|
||||
* Mac
|
||||
* Linux
|
||||
|
||||
[download_winscp]: https://winscp.net
|
||||
[download_filezilla]: https://filezilla-project.org/download.php?type=client
|
||||
|
||||
Anything put there will be accessible under ``https://$USERNAME.users.skynet.ie``.
|
||||
Anything put there will be accessible under ``https://$USERNAME.users.skynet.ie``.
|
||||
For backwards compatability ``https://skynet.ie/~$USERNAME`` will redirect to ``https://$USERNAME.users.skynet.ie``.
|
||||
|
||||
## More info
|
||||
There is a slideshow that might be of use to you: <https://public.skynet.ie/slides/skynet/1_setup.html>
|
Loading…
Add table
Reference in a new issue