From 9e87407200e56ef69efeb928dcbf4d94e08da800 Mon Sep 17 00:00:00 2001 From: Paul van Tilburg Date: Fri, 1 May 2020 15:14:22 +0200 Subject: [PATCH] Textual/Markdown lint fixes --- about.md | 5 +- contact.md | 5 +- links.md | 27 ++++++---- services.md | 17 +++--- services/email.md | 107 ++++++++++++++++++++++++++----------- services/git.md | 51 +++++++++++++----- services/jitsi-meet.md | 67 +++++++++++++++++------ services/matrix.md | 53 +++++++++++++----- services/nextcloud.md | 118 +++++++++++++++++++++++++++++++---------- services/ssh.md | 31 ++++++++--- services/webhosting.md | 44 ++++++++++----- services/xmpp.md | 27 +++++++--- 12 files changed, 404 insertions(+), 148 deletions(-) diff --git a/about.md b/about.md index ac6dde7..f59a5be 100644 --- a/about.md +++ b/about.md @@ -31,7 +31,7 @@ bigger one, which is the one this website still runs on, and we switched from [Slackware](http://slackware.com/) to [Debian](http://debian.org/). The network gained about 30 users, some websites and projects found their home on the server and we obtained an extra server for the core services. By -then the domain @luon.net@ was registered and the Luon Network was born. +then the domain `luon.net` was registered and the Luon Network was born. Due to issues with the place our servers were located, everything had to be temporarily moved to the student society [Odin](http://odin.tte.ele.tue.nl/) @@ -52,4 +52,5 @@ had to be removed from the premises. All servers were virtualized and hosted on a rented, dedicated server, paid for by our members. Many services got restructed and moved around. Some got dropped, and some got added, but the scope of the network remained the same: providing internet services in a -private, trusted setting. \ No newline at end of file +private, trusted setting. + diff --git a/contact.md b/contact.md index 5ce197f..8761b54 100644 --- a/contact.md +++ b/contact.md @@ -6,7 +6,7 @@ sidebar_link: true # Luon Network Contact Info; -Per [service](services.html) there can be a different person who manages it. +Per [service](services.html) there can be a different person who manages it. The following addresses can be used to contact the maintainer of a service, provided it's glued in front of `@luon.net`. @@ -21,4 +21,5 @@ provided it's glued in front of `@luon.net`. * `sysops`: **main/default contact address!** * `usermanager`: user account creation/deletion/problems * `webmaster`: web services -* `xmppadmin`: XMPP (Jabber) accounts and server \ No newline at end of file +* `xmppadmin`: XMPP (Jabber) accounts and server + diff --git a/links.md b/links.md index 24801ae..9dd1e7b 100644 --- a/links.md +++ b/links.md @@ -11,21 +11,30 @@ Below are some links to pages/sites of our running services that expose information or a user interface to the web: * **[Banaan!](http://banaan.luon.net/)**: friendly test page -* **[Gitea](https://git.luon.net)**: hosted [Git](services/git.html) accounts and repositories -* **[Jitsi Meet](https://meet.luon.net/)**: web-based [audio/video conferencing](services/jitsi-meet.html) service -* **[Nextcloud](https://cloud.luon.net/)**: complete [cloud](services/nextcloud.html) service -* **[Riot Web](https://chat.luon.net/)**: preconfigured fully-featured [Matrix](services/matrix.html) web client -* **[Roundcube](https://webmail.luon.net/)**: your [e-mail](services/email.html) accessed via the web -* **[Web statistics](http://luon.net/webstats)**: our [web](services/web.html) usage statistics +* **[Gitea](https://git.luon.net)**: hosted [Git](services/git.html) accounts + and repositories +* **[Jitsi Meet](https://meet.luon.net/)**: web-based + [audio/video conferencing](services/jitsi-meet.html) service +* **[Nextcloud](https://cloud.luon.net/)**: complete + [cloud](services/nextcloud.html) service +* **[Riot Web](https://chat.luon.net/)**: preconfigured fully-featured + [Matrix](services/matrix.html) web client +* **[Roundcube](https://webmail.luon.net/)**: your + [e-mail](services/email.html) accessed via the web +* **[Web statistics](http://luon.net/webstats)**: our [web](services/web.html) + usage statistics * **[Wiki](https://wiki.luon.net/)**: main web wiki Additionally, some links to projects hosted on our network: -* **[Feeding Frenzy!](http://ffrenzy.luon.net/)**: game developed during a study project +* **[Feeding Frenzy!](http://ffrenzy.luon.net/)**: game developed during a + study project * **[Team Onbekend](http://luon.net/~onbekend/)**: Createch'99 team home page -* **[Utopia MOO](http://utopiamoo.net)**: virtual text-based on-line multi-user world +* **[Utopia MOO](http://utopiamoo.net)**: virtual text-based on-line multi-user + world and blogs/journals/homepages by some of our users: * **[Paul van Tilburg](http://paul.luon.net/)** -* **[Sjoerd Simons](http://sjoerd.luon.net/)** \ No newline at end of file +* **[Sjoerd Simons](http://sjoerd.luon.net/)** + diff --git a/services.md b/services.md index 108c29f..a4b9f73 100644 --- a/services.md +++ b/services.md @@ -7,9 +7,9 @@ weight: 20 # Luon Network Services; -We provide ([Debian](http://debian.org)) GNU/Linux-based internet services to -ex-students at the [Eindhoven University of Technology](http://tue.nl) and -their friends & family (whoever is interested). +We provide ([Debian](http://debian.org)) GNU/Linux-based internet services to a +group of ex-students at the [Eindhoven University of Technology](http://tue.nl) +and their friends & family (whoever is interested). A rough overview of what is available for a Luon user: @@ -18,6 +18,9 @@ A rough overview of what is available for a Luon user: * server-side (spam) filtering * mail submission * [Git](services/git.html) account +* [Jitsi Meet](services/jitsi-meet.html) access +* Mailing list(s) +* [Matrix](services/matrix.html) account * [Nextcloud](services/nextcloud.html) account * personal/shared calendars * personal/shared contacts @@ -25,9 +28,6 @@ A rough overview of what is available for a Luon user: * polls * Kanban boards * *much more…* -* [Jitsi Meet](services/jitsi-meet.html) access -* Mailing list(s) -* [Matrix](services/matrix.html) account * [Shell/SSH](services/ssh.html) account * [Web](services/webhosting.html) space (and/or wiki) * [XMPP (Jabber)](services/xmpp.html) account @@ -40,6 +40,7 @@ We also do: * DNS/domain hosting * E-mail hosting -* Hosting of Git repositories +* Hosting of organization Git repositories * Web hosting -* Web usage statistics \ No newline at end of file +* Web usage statistics + diff --git a/services/email.md b/services/email.md index a277163..37e1563 100644 --- a/services/email.md +++ b/services/email.md @@ -3,18 +3,27 @@ title: E-mail Service; layout: page --- -For accessing mail via IMAP, webmail, or for changing the server-side filters, you will need to use the same login credentials, namely your Luon user name and password. As user name use the name of your Luon account without any domain, so `user` and not `user@luon.net` . +For accessing mail via IMAP, webmail, or for changing the server-side filters, +you will need to use the same login credentials, namely your Luon username and +password. As username use the name of your Luon account without any domain, so +`user` and not `user@luon.net`. -We also support virtual mail accounts. In this case the user name that shlould be used *does* include the domain, so `virtualuser@yourdomain.tld`. -If you would like to have (more) virtual mail boxes/addresses, just let [our postmaster](mailto:postmaster@luon.net) know! +We also support virtual mail accounts. In this case the username that should +be used *does* include the domain, so `virtualuser@yourdomain.tld`. If you +would like to have (more) virtual mail boxes/addresses, just let +[our postmaster](mailto:postmaster@luon.net) know! ## Accessing mail ### Retrieving mail -If you have not specified a forwarding e-mail address in `~/.forward`, arriving e-mail will be stored in `~/Mail` of your (UNIX) account. Under this directory there is a nested tree of directories where `cur`, `new` and `tmp` are special [Maildir format specific](http://cr.yp.to/proto/maildir.html) directories. +If you have not specified a forwarding e-mail address in `~/.forward`, arriving +e-mail will be stored in `~/Mail` of your (UNIX) account. Under this directory +there is a nested tree of directories where `cur`, `new` and `tmp` are special +[Maildir format specific](http://cr.yp.to/proto/maildir.html) directories. -The _preferred_ way to access the e-mail, even on the shell host itself, is via IMAP. Use the following settings: +The _preferred_ way to access the e-mail, even on the shell host itself, is via +IMAP. Use the following settings: * **server:** `imap.luon.net` * **port:** 143 (imap2) @@ -24,40 +33,62 @@ Optionally, IMAP via SSL (using port 993) is also supported but not preferred. ### Sending e-mail -E-mail can be sent using our mail server wherever your are (especially useful for mobile devices). Use the following settings: +E-mail can be sent using our mail server wherever your are (especially useful +for mobile devices). Use the following settings: * **server:** `smtp.luon.net` * **port:** 587 (submission) or 25 (smtp) * **security:** (START)TLS -The Submission port (587) is preferred as it is usually not blocked by the firewall of your internet provider, while the SMTP port (25) often is. +The Submission port (587) is preferred as it is usually not blocked by the +firewall of your internet provider, while the SMTP port (25) often is. -The same remarks concerning the Luon and virtual e-mail accounts hold as written above. +The same remarks concerning the Luon and virtual e-mail accounts hold as +written above. ## Webmail -The Luon Webmail service is available at: [https://webmail.luon.net/](https://webmail.luon.net). +The Luon Webmail service is available at: +[webmail.luon.net](https://webmail.luon.net). For the login details, see above. ## Spam-filtering -We support server-side spam filtering by default; this is done using [Rspamd](https://rspamd.com) on our mail gateway host. -Note that it requires some initial training before it starts working properly. -Incoming mail is stored in the _Inbox_ (i.e. `~/Mail`) unless Rspamd thinks it is spam (or junk, as it is often called) based on a score. Either, this score is very high (≥ 15) and the mail is plainly rejected on arrival, or the score is just high (≥ 6 and < 15) and it will be stored in the _Junk_ folder (i.e. `~/Mail/Junk`). +We support server-side spam filtering by default; this is done using +[Rspamd](https://rspamd.com) on our mail gateway host. Note that it requires +some initial training before it starts working properly. Incoming mail is +stored in the _Inbox_ (i.e. `~/Mail`) unless Rspamd thinks it is spam (or junk, +as it is often called) based on a score. Either, this score is very high (≥ 15) +and the mail is plainly rejected on arrival, or the score is just high +(≥ 6 and < 15) and it will be stored in the _Junk_ folder (i.e. `~/Mail/Junk`). -Spam training is done by moving spam e-mails to the Junk mail folder (which must be called like this for it to work) and moving ham e-mails from the Junk mail folder to another folder. For the training to have effect, this *has to be done via IMAP*. Our IMAP server tracks your actions of moving mail in and out the Junk mail folder and trains accordingly. Moving them from maildir to maildir on the system will have no effect. +Spam training is done by moving spam e-mails to the Junk mail folder (which +must be called like this for it to work) and moving ham e-mails from the Junk +mail folder to another folder. For the training to have effect, this *has to +be done via IMAP*. Our IMAP server tracks your actions of moving mail in and +out the Junk mail folder and trains accordingly. Moving them from maildir to +maildir on the system will have no effect. ## Server-side mail filtering -Server-side filtering is done using [Sieve](http://en.wikipedia.org/wiki/Sieve_%28mail_filtering_language%29). Some [e-mail clients](http://sieve.info/clients) support configuring the sieve. The Luon Webmail is such a client, but there is also an [add-on](https://addons.mozilla.org/en-us/thunderbird/addon/sieve/) for Thunderbird. Evolution unfortunately has no support at all. +Server-side filtering is done using +[Sieve](http://en.wikipedia.org/wiki/Sieve_%28mail_filtering_language%29). +Some [e-mail clients](http://sieve.info/clients) support configuring the sieve. +The Luon Webmail is such a client, but there is also an +[add-on](https://addons.mozilla.org/en-us/thunderbird/addon/sieve/) for +Thunderbird. Evolution unfortunately has no support at all. -Configuring sieve can be done using our Webmail or via the [manage-sieve protocol](http://tools.ietf.org/html/rfc5804). +Configuring sieve can be done using our Webmail or via the +[manage-sieve protocol](http://tools.ietf.org/html/rfc5804). ### ... via webmail -Login on the [Luon Webmail](https://webmail.luon.net/), go to "Personal Settings" and then select the tab "Filters". -On the left side you can add, remove and reorder rules, on the right side you can edit or temporarily disable the rules. -By default there should already be a "Spam Filter" rule, ensure that you keep it and keep it at the top. +Login on the [Luon Webmail](https://webmail.luon.net/), go to "Personal +Settings" and then select the tab "Filters". +On the left side you can add, remove and reorder rules, on the right side you +can edit or temporarily disable the rules. +By default there should already be a "Spam Filter" rule, ensure that you keep +it and keep it at the top. ### ... via a manage-sieve client @@ -68,29 +99,38 @@ Use the following settings for a manage-sieve client: * **security:** (START)TLS * **login:** e-mail account user/password -The filters are stored in `~/.sieves` and the active filter is linked from `~/.dovecot.sieve`. So, it is also possible to edit the filters via shell and an editor. However, be sure to make no syntax errors ;) +The filters are stored in `~/.sieves` and the active filter is linked from +`~/.dovecot.sieve`. So, it is also possible to edit the filters via shell and +an editor. However, be sure to make no syntax errors ;) -Warning! When manually editing filters, the default system filter will be overridden, thus losing spam filter support. There are two solutions: +*Warning!* When manually editing filters, the default system filter will be +overridden, thus losing spam filter support. There are two solutions: 1. Add the following to your sieve: require ["include"]; - + include :global "spam_filter"; -2. Copy the contents of `/etc/dovecot/sieve.default`, as not all clients support the "include" module yet. +2. Copy the contents of `/etc/dovecot/sieve.default`, as not all clients + support the "include" module yet. -If you prefer procmail, exim filter, or to forward your e-mail, you can always create a `~/.procmailrc` or `~/.forward`, thus overriding the system filtering, including sieve. +If you prefer procmail, exim filter, or to forward your e-mail, you can always +create a `~/.procmailrc` or `~/.forward`, thus overriding the system filtering, +including sieve. ## Virtual domains -Besides the `luon.net` mail domain, we also host other virtual domains and virtual mail accounts. Setting up or tearing down virtual domains or accounts has to be done by the [postmaster](mailto:postmaster@luon.net). +Besides the `luon.net` mail domain, we also host other virtual domains and +virtual mail accounts. Setting up or tearing down virtual domains or accounts +has to be done by the [postmaster](mailto:postmaster@luon.net). ### Managing virtual domains -Once a virtual domain is created, you can manage it by editing the aliases file `/srv/mail/aliases/mydomain.tld`. An example aliases file: +Once a virtual domain is created, you can manage it by editing the aliases file +`/srv/mail/aliases/mydomain.tld`. An example aliases file: -``` +```config # Aliases for mydomain.tld abuse: hostmaster hostmaster: hostmaster@localhost @@ -102,8 +142,15 @@ webmaster: virtualuser someuser: someuser@localhost ``` -In the above virtual mail domain, mail to `abuse@mydomain.tld` and `hostmaster@mydomain.tld` is redirected to the hostmaster listed by the system aliases (in `/etc/aliases`). -Mail to `info@mymaildomain.tld` and `webmaster@mydomain.tld` is redirected to the virtual mail account `virtualuser@mydomain.tld` (if it exists). -Finally, mail to `someuser@mydomain.tld` is redirected to the (UNIX) account `someuser` if it exists and is not an alias in the system aliases. +In the above virtual mail domain, mail to `abuse@mydomain.tld` and +`hostmaster@mydomain.tld` is redirected to the hostmaster listed by the system +aliases (in `/etc/aliases`). Mail to `info@mymaildomain.tld` and +`webmaster@mydomain.tld` is redirected to the virtual mail account +`virtualuser@mydomain.tld` (if it exists). +Finally, mail to `someuser@mydomain.tld` is redirected to the (UNIX) account +`someuser` if it exists and is not an alias in the system aliases. + +Note that adding `@localhost` is required to redirect mail to UNIX accounts, +possibly via system aliases. Leaving the domain suffix out signifies that the +mail needs to go to a virtual mail account, if not aliased first. -Note that adding `@localhost` is required to redirect mail to UNIX accounts, possibly via system aliases. Leaving the domain suffix out signifies that the mail needs to go to a virtual mail account, if not aliased first. \ No newline at end of file diff --git a/services/git.md b/services/git.md index 9dd8e25..4adfa2d 100644 --- a/services/git.md +++ b/services/git.md @@ -3,35 +3,62 @@ title: Git Service; layout: page --- -Everything related to the Luon Git service can be managed by the Gitea web interace available at: [https://git.luon.net](https://git.luon.net). -Every Luon user can log in using their account user name and password without requesting an account explicitly. +Everything related to the Luon Git service can be managed by the Gitea web +interace available at: [git.luon.net](https://git.luon.net). Every +Luon user can log in using their account username and password without +requesting an account explicitly. -For more information about Git, see: [https://git-scm.com/](https://git-scm.com/), and for more about Gitea, see: [https://gitea.io](https://gitea.io). +For more information about Git, see: [git-scm.com](https://git-scm.com/), and +for more about Gitea, see: [gitea.io](https://gitea.io). ## Repository access -### Non-authenticated/anonymous: -All of your public user and organisation repositories can be cloned anonymously by everyone via HTTP(S) using the URLs like `https://git.luon.net/user/repo.git`. + +### Non-authenticated/anonymous + +All of your public user and organisation repositories can be cloned anonymously +by everyone via HTTP(S) using the URLs like +`https://git.luon.net/user/repo.git`. ### Authenticated -It is also possible to go via HTTPS for accessing private repositories or for pushing commits, but it is more convenient to use SSH for this. -To be able to use the SSH URLs like `git@git.luon.net:user/repo.git` for cloning and pushing, you will have to register your SSH key(s). You can find the place to do this under the profile menu (top-right menu with your avatar), "Settings" and then the "SSH / GPG keys" tab. -If you want to use shorter versions of the URLs on the command-line, add the following to your SSH configuration at `~/.ssh/config`: -``` +It is also possible to go via HTTPS for accessing private repositories or for +pushing commits, but it is more convenient to use SSH for this. To be able to +use the SSH URLs like `git@git.luon.net:user/repo.git` for cloning and pushing, +you will have to register your SSH key(s). You can find the place to do this +under the profile menu (top-right menu with your avatar), "Settings" and then +the "SSH / GPG keys" tab. + +If you want to use shorter versions of the URLs on the command-line, add the +following to your SSH configuration at `~/.ssh/config`: + +```config Host git.luon.net User git ``` + Then, you can use URLs such as `git.luon.net:user/repo.git` when cloning. -Even more convenient could be to tell Git about this instance. Add the following to `~/.gitconfig`: +Even more convenient could be to tell Git about this instance. Add the +following to `~/.gitconfig`: + ```ini [url "git@git.luon.net:"] insteadOf = luon: ``` + Then, you can just clone using URLs such as `luon:user/repo.git`! ## Repository creation -You can find this under the create menu (the "+" next to the top-right menu with your avatar). Note that it also possible via this menu to create a repository from an existing Github/GitLab or any HTTP-clonable Git repository by migrating the repository and related data to Luon Git. + +You can find this under the create menu (the "+" next to the top-right menu +with your avatar). Note that it also possible via this menu to create a +repository from an existing Github/GitLab or any HTTP-clonable Git repository +by migrating the repository and related data to Luon Git. ## Organisation creation -You can find this under the create menu (the "+" next to the top-right menu with your avatar). Any Luon user is allowed to create as many organisations as they want. We do ask you to give them sensible names and not to go completely crazy with them. \ No newline at end of file + +You can find this under the create menu (the "+" next to the top-right menu +with your avatar). Any Luon user is allowed to create as many organisations as +they want. We do ask you to give them sensible names and not to go completely +crazy with them. + diff --git a/services/jitsi-meet.md b/services/jitsi-meet.md index c673081..6ad158a 100644 --- a/services/jitsi-meet.md +++ b/services/jitsi-meet.md @@ -3,29 +3,64 @@ title: Jitsi Meet Service; layout: page --- -Jisti Meet is a web-based audio/video conferencing service that can be used by any Luon users as well as any other person you would like to have a one-on-one or multiparty conference with. +Jisti Meet is a web-based audio/video conferencing service that can be used by +any Luon users as well as any other person you would like to have a one-on-one +or multiparty conference with. -For more information about Jitsi Meet, see: [https://jitsi.org/jitsi-meet/](https://jitsi.org/jitsi-meet/). +For more information about Jitsi Meet, see: +[jitsi.org/jitsi-meet](https://jitsi.org/jitsi-meet/). ## Conferences/rooms -To start a conference, go to landing page at [https://meet.luon.net](https://meet.luon.net), pick a random or specific room name and press "Go". When pressed, the browser will redirect to an URL like `https://meet.luon.net/roomname` where the conference will be held. This URL can be provided to anyone you'd like to invite. It is also possible to start a conference immediately by going to an URL like `https://meet.luon.net/JustInTime`. -Because we have no authentication system hooked up yet, the first user that enteres the conference will be the moderator. The moderator can mute and kick other people, set the room password and can also direct who all the participants see if desired. -If the moderator leaves the conference, the second user to enter the room will become the moderator, etc. +To start a conference, go to landing page at +[meet.luon.net](https://meet.luon.net), pick a random or specific room +name and press "Go". When pressed, the browser will redirect to an URL like +`https://meet.luon.net/roomname` where the conference will be held. This URL +can be provided to anyone you'd like to invite. It is also possible to start a +conference immediately by going to an URL like +`https://meet.luon.net/JustInTime`. -When everyone leaves the room, the conference and room will stop to exist. All settings such as passwords will be lost. +Because we have no authentication system hooked up yet, the first user that +enteres the conference will be the moderator. The moderator can mute and kick +other people, set the room password and can also direct who all the +participants see if desired. If the moderator leaves the conference, the +second user to enter the room will become the moderator, etc. + +When everyone leaves the room, the conference and room will stop to exist. All +settings such as passwords will be lost. ## Notes -* When using this with only two participants in a room, the audio and/or video traffic is peer-to-peer, it will not go via the server. With more participants, it will go via the server. Traffic is still secure in both cases! -* Jitsi Meet works best on the desktop using a recent version of the Firefox or Chrome/Chromium. -* There is a mobile app available for Android and iOS called "Jitsi Meet". It has better performance and provides the same functionality. + +* When using this with only two participants in a room, the audio and/or video + traffic is peer-to-peer, it will not go via the server. With more + participants, it will go via the server. Traffic is still secure in both + cases! +* Jitsi Meet works best on the desktop using a recent version of the Firefox or + Chrome/Chromium. +* There is a mobile app available for Android and iOS called "Jitsi Meet". It + has better performance and provides the same functionality. ## Features -Jisti Meet is quite user-friendly. Feel free to try out all the buttons 🙂. -Below are some features that are less obvious/discoverable and might be nice to know: -* **Push-to-talk**. Sometimes your surroundings are noisy and you want to use push to talk to only send your sound when you want to. Just press *Space* to enable this. You will be muted and are only unmuted when you press Space. Unmute yourself to disable push-to-talk. -* **YouTube**: You can stream a YouTube video to all participants that will see it in sync. Use the more menu in the lower-right corner. To stop/remove the video, again use the more menu. -* **Screen sharing**: This works fine on Windows and Linux on X11. With Linux on Wayland there is a caveat: you can only share your entire browser or a browser tab, not your entire screen or another application. -* **Privacy**: To prevent random people from entering the conference, you can set a password using the more menu in the lower-right corner. Participants that go to the URL to enter the conference will need to use that password to continue from now on. -* **Participant volume**: Sometimes, one person is louder than the rest, you can go to the top-right corner and use the participants more menu to adjust the relative volume. +Jisti Meet is quite user-friendly. Feel free to try out all the buttons 🙂. + +Below are some features that are less obvious/discoverable and might be nice to +know: + +* **Push-to-talk**. Sometimes your surroundings are noisy and you want to use + push to talk to only send your sound when you want to. Just press *Space* + to enable this. You will be muted and are only unmuted when you press + *Space*. Unmute yourself to disable push-to-talk. +* **YouTube**: You can stream a YouTube video to all participants that will see + it in sync. Use the more menu in the lower-right corner. To stop/remove the + video, again use the more menu. +* **Screen sharing**: This works fine on Windows and Linux on X11. With Linux + on Wayland there is a caveat: you can only share your entire browser or a + browser tab, not your entire screen or another application. +* **Privacy**: To prevent random people from entering the conference, you can + set a password using the more menu in the lower-right corner. Participants + that go to the URL to enter the conference will need to use that password + to continue from now on. +* **Participant volume**: Sometimes, one person is louder than the rest, you + can go to the top-right corner and use the participants more menu to adjust + the relative volume. diff --git a/services/matrix.md b/services/matrix.md index 9ceacef..5f09aa4 100644 --- a/services/matrix.md +++ b/services/matrix.md @@ -3,36 +3,65 @@ title: Matrix Service; layout: page --- -Luon Matrix is a Matrix homeserver that can be used by any Luon user without requesting an account explicitly. The Matrix homeserver will store the conversation history of all rooms that any Luon user is participating in securely. +Luon Matrix is a Matrix homeserver that can be used by any Luon user without +requesting an account explicitly. The Matrix homeserver will store the +conversation history of all rooms that any Luon user is participating in +securely. -For more information about Matrix, see: [https://matrix.org/](https://matrix.org). +For more information about Matrix, see: [matrix.org](https://matrix.org). ## Clients -Given that Matrix is open protocol, there are many clients available. For a full overview, see the [client page at matrix.org](https://matrix.org/clients/). Below follows a selection of the most relevant clients. + +Given that Matrix is open protocol, there are many clients available. For a +full overview, see the +[clients page at matrix.org](https://matrix.org/clients/). Below follows a +selection of the most relevant clients. ### Riot Web -We have a instance of [Riot Web](https://riot.im) which is a web-based, fully featured client for Matrix. It is preconfigured to use the Luon Matrix homeserver. It can be found at: [https://chat.luon.net](https://chat.luon.net). You can log in using your Luon account user name and password. + +We have a instance of [Riot Web](https://riot.im) which is a web-based, fully +featured client for Matrix. It is preconfigured to use the Luon Matrix +homeserver. It can be found at: [chat.luon.net](https://chat.luon.net). +You can log in using your Luon account username and password. ### Fractal -On GNOME, there is the *Fractal* Matrix client. It does not support all the features of Matrix just yet, but has a clean interface that fits well into the desktop. You can install it via Flatpak using [Flathub](https://flathub.org/apps/details/org.gnome.Fractal). + +On GNOME, there is the *Fractal* Matrix client. It does not support all the +features of Matrix just yet, but has a clean interface that fits well into the +desktop. You can install it via Flatpak using +[Flathub](https://flathub.org/apps/details/org.gnome.Fractal). ### Android/iOS -There are various kinds of mobile clients available, but the most well-known and fully featured are: *Riot Android*/*Riot iOS*. -For Android there is not also the new client *RiotX* that is a more lean rewritten version of *Riot Android* but it still in beta. + +There are various kinds of mobile clients available, but the most well-known +and fully featured are: +[Riot Android](https://matrix.org/docs/projects/client/riot-android) / +[Riot iOS](https://matrix.org/docs/projects/client/riot-ios). +For Android there is also the new client +[RiotX](https://matrix.org/docs/projects/client/riot-ios) that is +a rewrite of *Riot Android*, is more lean and has a better user interface. ## Credentials & IDs -Depending on the client, for logging in it might either your user name and homeserver URL or Matrix ID (mxid) to log in. So, you can use the following: -* User name: `user` + +Depending on the client, for logging in it might either your username and +homeserver URL or Matrix ID (mxid) to log in. So, you can use the following: + +* Username: `user` * Homeserver URL: `https://matrix.luon.net` or: + * Matrix ID: `@user:luon.net` and of course the password of your Luon account. -Other users on the Luon homeserver as well as any other Matrix homeserver can use your Matrix ID to contact you. It is fully federated. +Other users on the Luon homeserver as well as any other Matrix homeserver can +use your Matrix ID to contact you. It is fully federated. ## Rooms -Luon users are invited to join the room `#users:luon.net` where participants will be notified of Luon news and Luon things can be discussed. -Feel free to create your own public, or private, rooms! \ No newline at end of file +Luon users are invited to join the room `#users:luon.net` where participants +will be notified of Luon news and Luon things can be discussed. + +Feel free to create your own public, or private, rooms! + diff --git a/services/nextcloud.md b/services/nextcloud.md index f583a79..d786ef7 100644 --- a/services/nextcloud.md +++ b/services/nextcloud.md @@ -3,62 +3,124 @@ title: Nextcloud Service; layout: page --- -Luon Cloud is our cloud service which is a Nextcloud instance that is hosted at: [https://cloud.luon.net](https://cloud.luon.net). Every Luon user can log in using their account user name and password without requesting an account explicitly. +Luon Cloud is our cloud service which is a Nextcloud instance that is hosted +at: [cloud.luon.net](https://cloud.luon.net). Every Luon user can log in using +their account username and password without requesting an account explicitly. -The web interface of Nextcloud is used to access/visualize all the data you put in the cloud service, but there are many clients that can work on top of this on your PC or mobile phone. +The web interface of Nextcloud is used to access/visualize all the data you put +in the cloud service, but there are many clients that can work on top of this +on your PC or mobile phone. -For more information about Nextcloud, see: [https://nextcloud.com](https://nextcloud.com). +For more information about Nextcloud, see: +[nextcloud.com](https://nextcloud.com). ## Sharing -It is a core feature of Nextcloud to either share things within the instance (i.e. with other Luon users), with other instances (i.e. with other Nextcloud users) or publicly via a special link so that only those whom you give the link, can access it. -If you want to share within the instance with another Luon user, this user has to have logged into the instance at least once before, otherwise they will not exist (yet). +It is a core feature of Nextcloud to either share things within the instance +(i.e. with other Luon users), with other instances (i.e. with other Nextcloud +users) or publicly via a special link so that only those whom you give the +link, can access it. -When people on other Nextcloud instances want to share files/calendars/contact/etc. with you, they can use your cloud ID which is of the form `user@cloud.luon.net`. +If you want to share within the instance with another Luon user, this user has +to have logged into the instance at least once before, otherwise they will not +exist (yet). + +When people on other Nextcloud instances want to share +files/calendars/contact/etc. with you, they can use your cloud ID which is of +the form `user@cloud.luon.net`. ## Clients -GNOME has native support for Nextcloud via GNOME Online accounts. You can find it in the settings. It will automatically hook up a remote location `user@cloud.luon.net` in Nautilus and add your calendars and contacts to Evolution. Also GNOME Calendar, Documents and Notes are aware of NextCloud. -The Nextcloud desktop client can also be installed, it will physically sync (a subset) of a local folder (`~/Nextcloud` by default) with Nextcloud. There is integration in Nautilus for it as well, so you can share/create links/etc. without going to the Nextcloud web interface. +GNOME has native support for Nextcloud via GNOME Online accounts. You can find +it in the settings. It will automatically hook up a remote location +`user@cloud.luon.net` in Nautilus and add your calendars and contacts to +Evolution. Also GNOME Calendar, Documents and Notes are aware of NextCloud. -With respect to mobile: There are similar clients for Android and iOS: for syncing files, performing automated backup uploads of the pictures you take, as well as apps that integrate with Nextcloud Notes or Talk. See also: https://nextcloud.com/install/#install-clients. Sailfish OS also has recently received account integration with Nextcloud. +The Nextcloud desktop client can also be installed, it will physically sync (a +subset) of a local folder (`~/Nextcloud` by default) with Nextcloud. There is +integration in Nautilus for it as well, so you can share/create links/etc. +without going to the Nextcloud web interface. + +With respect to mobile: There are similar clients for Android and iOS: for +syncing files, performing automated backup uploads of the pictures you take, as +well as apps that integrate with Nextcloud Notes or Talk. See also the +[clients page at nexcloud.com](https://nextcloud.com/install/#install-clients). +Sailfish OS also has recently received account integration with Nextcloud. ## Apps -In Nextcloud, functionality is split up in apps of which the most common ones are discussed below. + +In Nextcloud, functionality is split up in apps of which the most common ones +are discussed below. ### Files -The main application for managing your files in the cloud. It can be access via WebDAV via the URL `https://cloud.luon.net/remote.php/dav/files/user/`. -We are currently not enforcing any quotes on the amount of data your store here. We might in the future, so we ask you to not store hundreds of gigabytes. +The main application for managing your files in the cloud. It can be access +via WebDAV via the URL `https://cloud.luon.net/remote.php/dav/files/user/`. -For more information, see: [https://nextcloud.com/files/](https://nextcloud.com/files/). +We are currently not enforcing any quotes on the amount of data your store +here. We might in the future, so we ask you to not store hundreds of gigabytes. + +For more information, see: [nextcloud.com/files](https://nextcloud.com/files/). ### Activity -This app shows a timeline of all the items that got added/changed/removed in all the other apps. This is only available via the web interface or native Nextcloud client. + +This app shows a timeline of all the items that got added/changed/removed in +all the other apps. This is only available via the web interface or native +Nextcloud client. ### Gallery -A photo gallery view on your folders with pictures. It will create (nested) albums with thumbnails of all your pictures. The sharing option is often used to provide other people a link to a certain photo album of some event. + +A photo gallery view on your folders with pictures. It will create (nested) +albums with thumbnails of all your pictures. The sharing option is often used +to provide other people a link to a certain photo album of some event. ### Talk -This app can be used to have a short chat or audio/video conference. This can also be set up as a scheduled event or used to discuss a certain file. -It currently supports up to 4 participants in case of an audio/video conference and it can even be shared via a public link to invite users that are not on the Luon Cloud. -For more information, see: [https://nextcloud.com/talk/](https://nextcloud.com/talk/). +This app can be used to have a short chat or audio/video conference. This can +also be set up as a scheduled event or used to discuss a certain file. It +currently supports up to 4 participants in case of an audio/video conference +and it can even be shared via a public link to invite users that are not on the +Luon Cloud. + +For more information, see: [nextcloud.com/talk](https://nextcloud.com/talk/). ### Groupware: Calendar/Contacts/Mails -These apps can be used to maintain any number of calendars and contacts. It also has a mail client (still in a development phase, not as full-features as our [Luon Webmail](https://webmail.luon.net). Note that you can share calendars not only with each other, but also publicly! -For more information, see: [https://nextcloud.com/groupware/](https://nextcloud.com/groupware/). +These apps can be used to maintain any number of calendars and contacts. It +also has a mail client (still in a development phase, not as full-features as +our [Luon Webmail](https://webmail.luon.net). Note that you can share +calendars not only with each other, but also publicly! + +For more information, see: +[nextcloud.com/groupware](https://nextcloud.com/groupware/). ### Office -Our Nextcloud instance includes an installation of Collabora Online which means that it is possible to edit (also collaboratively) office documents within your browser using a web version of Libre Office! This ensures that Luon Cloud is not only useful for text/markdown documents but also fully fledged spreadsheets/presentations/documents. + +Our Nextcloud instance includes an installation of Collabora Online which means +that it is possible to edit (also collaboratively) office documents within your +browser using a web version of Libre Office! This ensures that Luon Cloud is +not only useful for text/markdown documents but also fully fledged +spreadsheets/presentations/documents. ### Other + There are some other apps installed: -* **Deck**: Kanban style boards app for organizing your actions/To Do items/etc. -* **Maps**: alternative app for Google Maps, Bing Maps, etc.; no routing available just yet (*alpha version!*) -* **Notes**: note taking app that uses note text files under the hood that are also accessible via Files -* **Passwords**: password management app; particularly useful in combination with a specific client for it -* **Polls**: polling app for polls either within the instance or for public polls, for example to pick a date with a group of people for a certain event -* **Social**: microblogging app that accesses the [Fediverse](https://fediverse.party/) using the [ActivityPub](https://www.w3.org/TR/activitypub/) protocol (similar to [Mastodon](https://joinmastodon.org/), etc.) (*beta version!*) -* **Tasks**: task management app; tasks are accessible by clients that use the calendars and supports these items (e.g. Evolution) \ No newline at end of file + +* **Deck**: Kanban style boards app for organizing your actions/To Do + items/etc. +* **Maps**: alternative app for Google Maps, Bing Maps, etc.; no routing + available just yet (*alpha version!*) +* **Notes**: note taking app that uses note text files under the hood that are + also accessible via Files +* **Passwords**: password management app; particularly useful in combination + with a specific client for it +* **Polls**: polling app for polls either within the instance or for public + polls, for example to pick a date with a group of people for a certain + event +* **Social**: microblogging app that accesses the + [Fediverse](https://fediverse.party/) using the + [ActivityPub](https://www.w3.org/TR/activitypub/) protocol (similar to + [Mastodon](https://joinmastodon.org/), etc.) (*beta version!*) +* **Tasks**: task management app; tasks are accessible by clients that use the + calendars and supports these items (e.g. Evolution) + diff --git a/services/ssh.md b/services/ssh.md index d630671..38f011c 100644 --- a/services/ssh.md +++ b/services/ssh.md @@ -3,27 +3,44 @@ title: Shell/SSH Service; layout: page --- -Luon has several servers, but only one server provides shell/SSH access for its users: Target. +Luon has several servers, but only one server provides shell/SSH access for its +users: Target. To access the shell, use: `ssh user@target.luon.net`. -Note that there are some servers that have `luon.net` in their hostname -- such as `void.luon.net` -- and that you might have an account there, but it has nothing to do with your Luon account. +Note that there are some servers that have `luon.net` in their hostname -- such +as `void.luon.net` -- and that you might have an account there, but it has +nothing to do with your Luon account. ## Shell + Target currently has several shells installed: + * [Bash](https://www.gnu.org/software/bash/) * [Fish](https://fishshell.com/) * [Zsh](http://zsh.org) To change your shell, log in via SSH and run: -``` + +```console $ chsh +Password: ... +Changing the login shell for ... +Enter the new value, or press ENTER for the default + Login Shell [...]: ``` -To keep your session running past loggin out, Target both has `screen` and `tmux` installed. +To keep your session running past loggin out, Target both has `screen` and +`tmux` installed. ## Password -The shell on Target is currently the only way to change your password. To change it, log in via SSH and run: -``` + +The shell on Target is currently the only way to change your password. +To change it, log in via SSH and run: + +```console $ passwd -``` \ No newline at end of file +Changing password for .... +Current password: ... +``` + diff --git a/services/webhosting.md b/services/webhosting.md index 6e85182..ad7f01a 100644 --- a/services/webhosting.md +++ b/services/webhosting.md @@ -3,28 +3,44 @@ title: Web Hosting Service; layout: page --- -Luon runs many services that also have a web frontend. See the [links page](links.html) for an overview of these web services/sites. -With Luon you can also run your personal web page or request web hosting, for more information see below. +Luon runs many services that also have a web frontend. See the +[links page](links.html) for an overview of these web services/sites. With +Luon you can also run your personal web page or request web hosting, for more +information see below. + +For personal websites as well as web hosting we currently do support PHP, but +this might me dropped in the future. Static sites are preferred and there are +many tools such as +[Jekyll](https://jekyllrb.com/)/[Hugo](https://gohugo.io/)/[Zola](https://www.getzola.org/)/etc. +to build them. -For personal websites as well as web hosting we currently do support PHP, but this might me dropped in the future. -Static sites are preferred and there are many tools such as [Jekyll](https://jekyllrb.com/)/[Hugo](https://gohugo.io/)/[Zola](https://www.getzola.org/)/etc. to build them. ## Personal website -To host your own website, put the files in the directory `public_html` in your home directory on Target (i.e. `~/public_html`). -You can do this via any client that supports SSH/SFTP. -Once the files are there, you can view the website at `https://luon.net/~user` where `user` is your Luon user name. + +To host your own website, put the files in the directory `public_html` in your +home directory on Target (i.e. `~/public_html`). You can do this via any +client that supports SSH/SFTP. Once the files are there, you can view the +website at `https://luon.net/~user` where `user` is your Luon username. ## Web hosting -If you want to host a website for a specific domain, like what we also do for `luon.net`, send a request to `webmaster@luon.net`. -Let us know what the domain is and what the hostnames and aliases are that you want to use for this website. -Below we use the domain and hostname `mijndomein.nl` with alias `www.mijndomein.nl` as an example. -If you manage your own DNS, first configure the following for the domain `@` and the alias `www`: -``` +If you want to host a website for a specific domain, like what we also do for +`luon.net`, send a request to `webmaster@luon.net`. Let us know what the +domain is and what the hostnames and aliases are that you want to use for this +website. Below we use the domain and hostname `mijndomein.nl` with alias +`www.mijndomein.nl` as an example. + +If you manage your own DNS, first configure the following for the domain `@` +and the alias `www`: + +```bind @ 86400 IN A 37.72.100.21 @ 86400 IN AAAA 2a00:8240:5:10::21 www 86400 IN CNAME @ ``` -Then, upload the website files using SSH/SFTP to `/srv/www/mijndomein.nl` on Target and visit `https://mijndomein.nl` to see the result +Then, upload the website files using SSH/SFTP to `/srv/www/mijndomein.nl` on +Target and visit `https://mijndomein.nl` to see the result + +We will arrange the certificates for HTTPS and make certain that they stay +up-to-date. -We will arrange the certificates for HTTPS and make certain that they stay up-to-date. \ No newline at end of file diff --git a/services/xmpp.md b/services/xmpp.md index 965f5f3..ac652a7 100644 --- a/services/xmpp.md +++ b/services/xmpp.md @@ -3,23 +3,34 @@ title: XMPP (Jabber) Service; layout: page --- -Our Luon XMPP service is one of the oldest service we have. It is unfortunately not connected to your Luon account and there has a different password; this might change in the future. +Our Luon XMPP service is one of the oldest service we have. It is unfortunately +not connected to your Luon account and there has a different password; this +might change in the future. -For more information about XMPP, see: [https://xmpp.org/](https://xmpp.org/). +For more information about XMPP, see: [xmpp.org](https://xmpp.org/). ## Credentials & IDs -When using XMPP you get assigned an ID, the Jabber ID, which is of the form `user@luon.net` where `user` is your Luon user name. -To log in using an XMPP client such as Empathy or Pidget, you need to enter this ID and the configured password. +When using XMPP you get assigned an ID, the Jabber ID, which is of the form +`user@luon.net` where `user` is your Luon username. + +To log in using an XMPP client such as Empathy or Pidget, you need to enter +this ID and the configured password. ## Features -Our XMPP service has the following features enabled on top of the basic sending and receiving of messages: + +Our XMPP service has the following features enabled on top of the basic sending +and receiving of messages: + * **Blocklists**: block users that are annoying -* **Carbons**: send carbon copies of sent/received messages to other devices so the chat history is also present there +* **Carbons**: send carbon copies of sent/received messages to other devices so + the chat history is also present there * **Cloud notification**: get push notification of new messages on mobile * **HTTP uploads**: upload/attach pictures and videos to your messages * **Message archive**: get/synchronize messages history between logins and clients -* **Mobile improvements**: don't keep your phone awake with trivial status messages that will drain the battery +* **Mobile improvements**: don't keep your phone awake with trivial status + messages that will drain the battery * **Multi-user chat**: chatrooms with multiple participants * **SOCKS proxy**: enables file transfers from/to clients behind NAT -* **Stream acknowledgements**: know if your message arrived \ No newline at end of file +* **Stream acknowledgements**: know if your message arrived +