Browse Source

Textual/Markdown lint fixes

master
Paul van Tilburg 12 months ago
parent
commit
9e87407200
Signed by: paul GPG Key ID: C6DE073EDA9EEC4D
12 changed files with 406 additions and 150 deletions
  1. +3
    -2
      about.md
  2. +3
    -2
      contact.md
  3. +18
    -9
      links.md
  4. +9
    -8
      services.md
  5. +78
    -31
      services/email.md
  6. +39
    -12
      services/git.md
  7. +52
    -17
      services/jitsi-meet.md
  8. +41
    -12
      services/matrix.md
  9. +90
    -28
      services/nextcloud.md
  10. +24
    -7
      services/ssh.md
  11. +30
    -14
      services/webhosting.md
  12. +19
    -8
      services/xmpp.md

+ 3
- 2
about.md View File

@ -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.
private, trusted setting.

+ 3
- 2
contact.md View File

@ -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
* `xmppadmin`: XMPP (Jabber) accounts and server

+ 18
- 9
links.md View File

@ -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/)**
* **[Sjoerd Simons](http://sjoerd.luon.net/)**

+ 9
- 8
services.md View File

@ -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
* Web usage statistics

+ 78
- 31
services/email.md View File

@ -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`).
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.
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.
## 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.

+ 39
- 12
services/git.md View File

@ -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.
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.

+ 52
- 17
services/jitsi-meet.md View File

@ -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.

+ 41
- 12
services/matrix.md View File

@ -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!
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!

+ 90
- 28
services/nextcloud.md View File

@ -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.
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: https://nextcloud.com/install/#install-clients. Sailfish OS also has recently received account integration with 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 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)
* **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)

+ 24
- 7
services/ssh.md View File

@ -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
```
Changing password for ....
Current password: ...
```

+ 30
- 14
services/webhosting.md View File

@ -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.

+ 19
- 8
services/xmpp.md View File

@ -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
* **Stream acknowledgements**: know if your message arrived

Loading…
Cancel
Save