ULYSSIS documentation - User contributions [en]

Getting Apache logs

2024-12-30T01:02:09Z

Bert: /* Using the command line */

You can find all your Apache logs (like <code>access.log</code> and <code>error.log</code>) on all of our shell servers in the directory <code>/var/log/apache_user/''username''</code>. For more information on how to access your files, please visit [[Accessing your files]].

==Using Cyberduck (graphical interface)==

You can access the log files using an SFTP client like Cyberduck. After logging in to one of our shell servers as per [[Accessing your files]], click on "Go" on the top bar and then click "Go to Folder...":

[[File:Getting Apache Logs - Cyberduck 1.png]]

Then enter <code>/var/log/apache_user/''username''</code> as path name (replace ''username'' with your own username):

[[File:Getting Apache Logs - Cyberduck 2.png]]

After pressing "Go", you will see a directory for each of your websites, containing their Apache logs.

[[File:Getting Apache Logs - Cyberduck 3.png]]

You can view a log file by selecting it and pressing the "Edit" button.

[[File:Getting Apache Logs - Cyberduck Edit button.png]]

After a few days, logs will be compressed into a <code>bz2</code> file. You can download such a file and open it with [https://www.7-zip.org/ 7-Zip].

==Using the command line==

You can also access your logs by [[Accessing shell servers over SSH|logging in to one of our shell servers over SSH]] and navigating to the correct directory:
username@ssh1:~$ cd /var/log/apache_user/username

username@ssh1:/var/log/apache_user/username$ ls
username.ulyssis.be

username@ssh1:/var/log/apache_user/username$ cd username.ulyssis.be

username@ssh1:/var/log/apache_user/username/username.ulyssis.be$ ls
access-2014-05-07.log error-2014-05-07.log

username@ssh1:/var/log/apache_user/username/username.ulyssis.be$ tail error-2014-05-07.log
[Wed May 07 01:27:14 2014] [error] [client 10.0.0.1] File does not exist: /home/user/username/www/favicon.ico

If you can't find your username inside of <code>/var/log/apache_user</code>, don't worry. If you enter it with <code>cd username</code>, it will automatically appear.

Older logs will be compressed with bzip2 but can be easily browsed from the command line using <code>bzless</code>. Other tools like <code>bzcat</code> and <code>bzgrep</code> might also come in handy.

[[Category:Webserver]]

Getting Apache logs

2024-12-30T01:01:33Z

Bert: /* Using the command line */

You can find all your Apache logs (like <code>access.log</code> and <code>error.log</code>) on all of our shell servers in the directory <code>/var/log/apache_user/''username''</code>. For more information on how to access your files, please visit [[Accessing your files]].

==Using Cyberduck (graphical interface)==

You can access the log files using an SFTP client like Cyberduck. After logging in to one of our shell servers as per [[Accessing your files]], click on "Go" on the top bar and then click "Go to Folder...":

[[File:Getting Apache Logs - Cyberduck 1.png]]

Then enter <code>/var/log/apache_user/''username''</code> as path name (replace ''username'' with your own username):

[[File:Getting Apache Logs - Cyberduck 2.png]]

After pressing "Go", you will see a directory for each of your websites, containing their Apache logs.

[[File:Getting Apache Logs - Cyberduck 3.png]]

You can view a log file by selecting it and pressing the "Edit" button.

[[File:Getting Apache Logs - Cyberduck Edit button.png]]

After a few days, logs will be compressed into a <code>bz2</code> file. You can download such a file and open it with [https://www.7-zip.org/ 7-Zip].

==Using the command line==

You can also access your logs by [[Accessing shell servers over SSH|logging in to one of our shell servers over SSH]] and navigating to the correct directory:
username@ssh1:~$ cd /var/log/apache_user/username

username@ssh1:/var/log/apache_user/username$ ls
username.ulyssis.be

username@ssh1:/var/log/apache_user/username$ cd username.ulyssis.be

username@ssh1:/var/log/apache_user/username/username.ulyssis.be$ ls
access-2014-05-07.log error-2014-05-07.log

username@ssh1:/var/log/apache_user/username/username.ulyssis.be$ tail error-2014-05-07.log
[Wed May 07 01:27:14 2014] [error] [client 10.0.0.1] File does not exist: /home/user/username/www/favicon.ico

If you can't find your username inside of <code>/var/log/apache_user</code>, don't worry. If you enter it with <code>cd username</code>, it will automatically appear.

Older logs will be compressed with bzip2 but can be easily browsed from the command line using bzless. Other tools like bzcat and bzgrep might also come in handy.

[[Category:Webserver]]

Add an alias in Thunderbird

2024-10-14T00:06:29Z

Bert: /* Adding the KU Leuven SMTP server in Thunderbird */

{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this. The KU Leuven provides an SMTP server which you can use as a student. Make sure the give your KU Leuven account access to this SMTP server using our tool on https://ulyssis.org/smtp before configuring Thunderbird.

== Add a mailbox to Thuderbird ==

Before you can add an alias to send mails, you should set up a mailbox in Thunderbird. Most commonly you will want to set up the mailbox in which you receive the emails you want to reply to. If you are for example trying to configure pr@mystudentunion.be in Thunderbird, and this email address forwards to johndoe@student.kuleuven.be, then you will want to configure johndoe@student.kuleuven.be inside Thunderbird before continuing.

In most cases (for example Gmail, Google, Hotmail and Outlook.com) Thunderbird will autodetect the right configuration once you enter your email address and password. Otherwise you may need to look at the documentation provided by your email provider. For your KU Leuven mailbox you can always check their [https://admin.kuleuven.be/icts/services/email/m365/configuratie-in-thunderbird-via-imap official documentation]. If you want to add your @ulyssis.org mailbox, you can use our [[Mailbox in Thunderbird]] documentation page. For other mail providers refer to their documentation or the documentation of Thunderbird.

== Adding the KU Leuven SMTP server in Thunderbird ==

If you already have the KU Leuven SMTP server configured in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below. You may have already added the KU Leuven SMTP server in Thunderbird when you created another alias or if you added your @ulyssis.org mailbox using our [[Mailbox in Thunderbird]] docs. Keep in mind that if you added your KU Leuven email address this '''no longer''' uses the KU Leuven SMTP, so you will still need to add it.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, in the left sidebar, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the KU Leuven SMTP server as '''Outgoing Server'''. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Add an alias in Thunderbird

2024-10-14T00:04:07Z

Bert: /* Add a mailbox to Thuderbird */

{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this. The KU Leuven provides an SMTP server which you can use as a student. Make sure the give your KU Leuven account access to this SMTP server using our tool on https://ulyssis.org/smtp before configuring Thunderbird.

== Add a mailbox to Thuderbird ==

Before you can add an alias to send mails, you should set up a mailbox in Thunderbird. Most commonly you will want to set up the mailbox in which you receive the emails you want to reply to. If you are for example trying to configure pr@mystudentunion.be in Thunderbird, and this email address forwards to johndoe@student.kuleuven.be, then you will want to configure johndoe@student.kuleuven.be inside Thunderbird before continuing.

In most cases (for example Gmail, Google, Hotmail and Outlook.com) Thunderbird will autodetect the right configuration once you enter your email address and password. Otherwise you may need to look at the documentation provided by your email provider. For your KU Leuven mailbox you can always check their [https://admin.kuleuven.be/icts/services/email/m365/configuratie-in-thunderbird-via-imap official documentation]. If you want to add your @ulyssis.org mailbox, you can use our [[Mailbox in Thunderbird]] documentation page. For other mail providers refer to their documentation or the documentation of Thunderbird.

== Adding the KU Leuven SMTP server in Thunderbird ==

If you already have the KU Leuven SMTP server configured in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below. You may have already added the KU Leuven SMTP server in Thunderbird when you created another alias or if you added your @ulyssis.org mailbox using our [[Mailbox in Thunderbird]] docs.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, in the left sidebar, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the KU Leuven SMTP server as '''Outgoing Server'''. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Add an alias in Thunderbird

2024-10-14T00:03:34Z

Bert: /* Add a mailbox to Thuderbird */

{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this. The KU Leuven provides an SMTP server which you can use as a student. Make sure the give your KU Leuven account access to this SMTP server using our tool on https://ulyssis.org/smtp before configuring Thunderbird.

== Add a mailbox to Thuderbird ==

Before you can add an alias to send mails, you should set up a mailbox in Thunderbird. Most commonly you will want to set up the mailbox in which you receive the emails you want to reply to. If you are for example trying to configure pr@mystudentunion.be in Thunderbird, and this email address forwards to johndoe@student.kuleuven.be, then you will want to configure johndoe@student.kuleuven.be inside Thunderbird before continuing.

In most cases (for example Gmail, Google, Hotmail and Outlook.com) Thunderbird will autodetect the right configuration once you enter your email address and password. Otherwise you may need to look at the documentation provided by your email provider. For your KU Leuven mailbox you can always check their [https://admin.kuleuven.be/icts/services/email/m365/configuratie-in-thunderbird-via-imap official documentation]. If you want to add your @ulyssis.org mailbox, you can use our [[Mailbox in Thunderbird]] docs. For other mail providers refer to their documentation or the documentation of Thunderbird.

== Adding the KU Leuven SMTP server in Thunderbird ==

If you already have the KU Leuven SMTP server configured in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below. You may have already added the KU Leuven SMTP server in Thunderbird when you created another alias or if you added your @ulyssis.org mailbox using our [[Mailbox in Thunderbird]] docs.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, in the left sidebar, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the KU Leuven SMTP server as '''Outgoing Server'''. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Add an alias in Thunderbird

2024-10-14T00:02:43Z

Bert: /* Add a mailbox to Thuderbird */

{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this. The KU Leuven provides an SMTP server which you can use as a student. Make sure the give your KU Leuven account access to this SMTP server using our tool on https://ulyssis.org/smtp before configuring Thunderbird.

== Add a mailbox to Thuderbird ==

Before you can add an alias to send mails, you should set up a mailbox in Thunderbird. Most commonly you will want to set up the mailbox in which you receive the emails you want to reply to. If you are for example trying to configure pr@mystudentunion.be in Thunderbird, and this email address forwards to johndoe@student.kuleuven.be, then you will want to configure johndoe@student.kuleuven.be inside Thunderbird before continuing.

If you want to add your @ulyssis.org mailbox, you can use our [[Mailbox in Thunderbird]] docs. For other mail providers refer to their documentation or the documentation of Thunderbird. In most cases (for example Gmail, Google, Hotmail and Outlook.com) Thunderbird will autodetect the right configuration once you enter your email address and password. Otherwise you may need to look at the documentation provided by your email provider. For your KU Leuven mailbox you can always check their [https://admin.kuleuven.be/icts/services/email/m365/configuratie-in-thunderbird-via-imap official documentation].

== Adding the KU Leuven SMTP server in Thunderbird ==

If you already have the KU Leuven SMTP server configured in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below. You may have already added the KU Leuven SMTP server in Thunderbird when you created another alias or if you added your @ulyssis.org mailbox using our [[Mailbox in Thunderbird]] docs.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, in the left sidebar, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the KU Leuven SMTP server as '''Outgoing Server'''. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Add an alias in Thunderbird

2024-10-14T00:02:13Z

Bert: /* Add a mailbox to Thuderbird */

{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this. The KU Leuven provides an SMTP server which you can use as a student. Make sure the give your KU Leuven account access to this SMTP server using our tool on https://ulyssis.org/smtp before configuring Thunderbird.

== Add a mailbox to Thuderbird ==

Before you can add an alias to send mails, you should set up a mailbox in Thunderbird. Most commonly you will want to set up the mailbox in which you receive the emails you want to reply to. If you are for example wanting to configure pr@mystudentunion.be in Thunderbird, and this email address forwards to johndoe@student.kuleuven.be, then you will want to configure johndoe@student.kuleuven.be inside Thunderbird before continuing.

If you want to add your @ulyssis.org mailbox, you can use our [[Mailbox in Thunderbird]] docs. For other mail providers refer to their documentation or the documentation of Thunderbird. In most cases (for example Gmail, Google, Hotmail and Outlook.com) Thunderbird will autodetect the right configuration once you enter your email address and password. Otherwise you may need to look at the documentation provided by your email provider. For your KU Leuven mailbox you can always check their [https://admin.kuleuven.be/icts/services/email/m365/configuratie-in-thunderbird-via-imap official documentation].

== Adding the KU Leuven SMTP server in Thunderbird ==

If you already have the KU Leuven SMTP server configured in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below. You may have already added the KU Leuven SMTP server in Thunderbird when you created another alias or if you added your @ulyssis.org mailbox using our [[Mailbox in Thunderbird]] docs.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, in the left sidebar, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the KU Leuven SMTP server as '''Outgoing Server'''. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Add an alias in Hotmail/Outlook

2024-10-13T22:36:46Z

Bert:

{{warning|Ongoing issues for Hotmail/Outlook|Recently, several users have been unable to send email through aliases using Hotmail/Outlook due to a bug on the side of Microsoft. For now it's unclear if this issue will be fixed or if this functionality is permanently broken.}}

{{notice|Adding an alias to Hotmail/Outlook is not advised|Hotmail/Outlook does not use a relevant SMTP server, for example the one of the KU Leuven, to send emails as an alias. This may cause recipients to automatically reject your email or mark it as spam. You can circumvent this issue by using Thunderbird or another email provider. Please refer to [[Using a forwarder as an alias]] for some potential alternatives.}}
You may want to send e-mail from Outlook.com using your @ulyssis.org address, or another domain name that you use for your account. Outlook.com allows you to do this by configuring a few settings. Because you should only be able to send mails from an e-mail address you actually own, make sure that you configured receiving mails before starting this process. Outlook.com will send a confirmation mail to the provided e-mail address to confirm that you own it.

# In Outlook.com, click on your profile image.
# Click '''My Microsoft account''' (Dutch: '''Mijn Microsoft-account''').
# Go to the tab '''Your info''' (Dutch: '''Je gegevens''').
# Under '''Account info''' (Dutch: '''Rekeninggegevens''') click on: '''Sign-in preferences''' (Dutch: '''Aanmeldingsvoorkeuren''').
# You will have to log in again to proceed. Click '''Add email''' (Dutch: '''E-mailadres toevoegen''').
# Select '''Add an existing email address as a Microsoft account alias''' (Dutch: '''Een bestaand e-mailadres als een Microsoft-accountalias toevoegen''') and fill in the email address you want to send from.
# Click '''Add alias''' (Dutch: '''Alias toevoegen''').
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Outlook.com from this address:

# In Outlook.com, click '''New message''' (Dutch: '''Nieuw bericht''').
# Click on '''From''' (Dutch: '''Van''') and select the email address.

[[Category:Mail]]

Running multiple websites

2024-08-28T16:42:51Z

Bert:

It's definitely possible to run multiple websites on a single ULYSSIS account. So you do not need to buy a new account to run a secondary website on. Very often this is used for running a wiki installation together with a WordPress installation, but in fact you can combine almost any CMS (like WordPress, Drupal or Joomla) or software. This is also called 'running multiple instances'.

As an example: You have a primary WordPress installation on youroganization.be, but beside that you would also like a blog that runs on Joomla. By following this guide, you can have a main WordPress installation while also having a separate blog on blog.yourorganization.be . The "blog." of this URL is also called a subdomain. If you would like more information regarding subdomains and what they can be used for, you can find more details on [https://en.wikipedia.org/wiki/Subdomain Wikipedia].

So to run multiple installations on your website, you will need to follow a few steps:

First of all, you will need access to one of our shell servers. If you need more information on how to do this, you can visit the following page: [[Accessing your files]].

Continuing, we need to make a new directory in your home folder, preferably next to the <code>www</code> folder where you installed the software that is running on your main website. It is also possible to install the new software to a new directory inside your <code>www</code>, but we do not recommend this for most users because it will be very confusing for later maintenance and updates. We also recommend to name the new directory to something obvious (e.g. a directory named <code>wiki</code> for a wiki installation), this will help future maintainers of your account.

Next, you will need to send us an email at ulyssis@ulyssis.org to connect the newly made directory to your subdomain. The information you need to send us is: the '''path''' to the new directory (often this will look something like this: /home/user/<your_username>/<name_of_the_directory>), and the '''subdomain''' you want this website to run on (e.g. blog.yourorganization.be).

When you receive a reply back from us that everything is in order, you will need to follow the steps from https://docs.ulyssis.org/Setting_up_WordPress, https://docs.ulyssis.org/Setting_up_Joomla, https://docs.ulyssis.org/Setting_up_Drupal or something else. This depends on what software you are planning to install on the new subdomain. While running the setup for your software, make sure to you install it to the '''right directory''', and adjust the configurations where needed.

If you have made edits to the .htaccess file for your website in the past, be cautious as it may interfere with your new installation on the subdomain.

When everything is complete, you should now have another website running at e.g. <chosen_subdomain>.yourorganization.be .

If you have further questions or problems regarding the guide above, do not hesitate to contact us.

Secure file permissions

2024-06-11T00:47:00Z

Bert:

PHP code is run with PHP-FPM as your ULYSSIS user. This means you can tighten up you website's security by denying other users the permission to read your PHP files. However, due to the way the Apache webserver works, it must be able to determine the existence of your PHP files. Non-PHP files in your www directory must remain readable by other users, because Apache reads these as its own user.

=== Recommended permissions ===

* www directory (and other directories from where websites are served), including subdirectories: <code>0705/drwx---r-x</code>
* Static website files (css, images, html, ...): <code>0604/-rw----r--</code>
* Configuration files containing secrets/passwords: <code>0600/-rw-------</code>
* Other directories and files that are not part of a website: <code>0600/-rw-------</code> or <code>0700/-rwx------</code>

=== Home directory security ===

For the permissions mentioned above to fully work, it is important for the parent directories to have the correct permissions. Our system already gives your home directory the correct permissions for this. Other users cannot read your files, or even find out what files exist. Even in case you mistakingly give everyone every permission to one of your files, only you can access it, because others do not have permission to go into your home directory.

{{notice|Important|If you have any secret files in your www directory, it may be publicly accessible via your website! Therefore, please make sure any files you want to protect are not in the www directory.}}

=== Securing database login info ===

Suppose you have a file called <code>config.php</code>, containing login information for your database. To secure this information, you can make it readable and writeable by only you, and nobody else using <code>chmod 600 config.php</code>. In Cyberduck, you can do this by right-clicking on the config file, clicking on "Info", clicking on the "Permissions" tab, and changing the permissions according to the following screenshots:

[[File:Config-php-dropdown.png]]

[[File:Config-php-permissions.png]]

=== Securing uploads directory ===

Also, if there are directories that you made writeable by others, e.g. an uploads folder, this is no longer necessary. If this directory is called <code>uploads</code>, you can remove write rights for others with <code>chmod go-w uploads</code>. In Cyberduck, you can do this by right-clicking on the config file, clicking on "Info", clicking on the "Permissions" tab, and changing the permissions according to the following screenshots:

[[File:Uploads-dropdown.png]]

[[File:Uploads-permissions.png]]

[[Category:Files]]

[[Category:Security & anti-spam]]

Using (Fast)CGI for non-PHP websites

2024-04-14T22:53:16Z

Bert: /* CGI */

You're not stuck with PHP if you want to make a dynamic website. You can use all sorts of frameworks and programming languages with ULYSSIS, as long as it has CGI or FastCGI support.

If you want to use a certain programming language or framework, and you can't get it to work, don't hesitate to contact us at [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org]. We will of course not write any code for you, but we can give you some pointers or directions.

==CGI==

CGI is a simple way to create a dynamic website. We use Apache's [http://httpd.apache.org/docs/2.4/mod/mod_cgid.html mod_cgid] to provide support for CGI. Note, however, that CGI is inefficient and
in general we recommend you to use a framework together with FastCGI. There are many frameworks, ranging from very simple and lightweight, to more complex and feature rich.

If, for example, you want Apache to interpret all files with the extension <code>.cgi</code> as CGI scripts, use the following <tt>.htaccess</tt> file (to be placed in your <code>www</code> folder):
<pre>Options +ExecCGI
AddHandler cgi-script .cgi</pre>

Here's an example of a very simple Python CGI script (called <code>hello.cgi</code>):
<pre>#!/usr/bin/env python3

print('Content-Type: text/plain\n')
print('Hello world!')</pre>

CGI scripts need to be executable, otherwise they won't work:
<pre>chmod +x hello.cgi</pre>

==FastCGI==

We use Apache's [http://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html mod_fcgid] to provide support for FastCGI.

In order to use FastCGI, you will generally need a starter script specific to your programming languae, framework or application. Just do a web search for "''keyword'' mod_fcgid", where ''keyword'' is the programming language, framework or application you're planning to use, and you will often find good instructions. We've included some examples below

You'll want to treat this starter script as a <code>mod_fcgid</code> script, and usually, you'll want to redirect everything to this script, so you can use an <code>.htaccess</code> file that looks like this:
<syntaxhighlight lang="apache">Options +ExecCGI
AddHandler fcgid-script .fcgi
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ starter.fcgi/$1 [QSA,L]</syntaxhighlight>
Replace ''starter.fcgi'' with the name of your starter script. Don't forget to make your starter script executable:
<pre>chmod +x starter.fcgi</pre>
The starter script must be located in the same folder as the <code>.htaccess</code> file.

{{warning|Warning!|Do not place sensitive files inside the web accessible folder. Make sure they are located in a folder outside the document root, or they will be downloadable through the webserver.}}
It is adviced to only place the fcgi starter script, <code>.htaccess</code> and static files (images, stylesheets) inside the document root.

=== Startup time and persistency ===

It is important to keep in mind that our Apache webworkers will only run your start script when a request is made. As soon as that first request has been received, it will try and keep a few instances of your application around for future use. This of course affects how you restart your application after changes (see below), but also means that applications with a longer start up time (for example a language such as Python combined with a larger framework) will experience an initial slow request. This slow startup is obviously not a factor for faster languages such as Haskell, C++ or Go.

Sadly, Apache is unable to have FastCGI processes persist beyond a reload or restart. This means in practice that every night around 6h25 when the logs are rotated, which requires Apache to be reloaded, all running fcgi processes will be gracefully terminated. The same thing happens when we make changes to the Apache configuration when a new website or user is added.

For those who have a very high startup time and don't generate enough traffic to not experience issues with this behaviour, it's possible to use a [[Managing_Cron_jobs | cronjob]] to visit the website every night at 6h30 or 7h, or even hourly.

===Restarting your application===

If you've changed your application, you will need to restart it for these changes to take effect. However, because you're editing the application on a different server than where it is running, you do not have access to the running process. You'll have to create some sort of mechanism to restart the process.

In the Django and Go examples below, the starter script has been written so that when it is changed, the application is automatically restarted within 1 second. The same mechanism can be applied to other Python sites. You can change the modification date without actually changing the contents of the starter script by using <code>touch</code>:
<pre>touch starter.fcgi</pre>
Replace <code>starter.fcgi</code> with the name of your starter script.

=== Examples ===
==== Python and Django ====

If you want to make a website using Python and [https://www.djangoproject.com/ Django], we recommend that you use a virtual environment. You can use the following steps to get up and running with Django on your ULYSSIS hosting account.

<ol>
<li>[[Accessing shell servers over SSH|Log in to a shell server]]</li>
<li>Create a new virtualenv, you can create one in <code>~/.venv</code>, for example:
<pre>python3 -m venv ~/.venv</pre>
</li>
<li>Activate this virtualenv:
<pre>. ~/.venv/bin/activate</pre>
</li>
<li>
Install Django and flup for FastCGI inside of this virtualenv:
<pre>pip install django flup6</pre>
</li>
<li>
Create a new Django project:
<pre>django-admin startproject mysite</pre>
Replace ''mysite'' with your project's desired name.
</li>
<li>
Edit the allowed hosts in your Django project's settings, in <code>mysite/mysite/settings.py</code>. Look for the line <code>ALLOWED_HOSTS = []</code> and replace it with:
<pre>
ALLOWED_HOSTS = [ 'username.ulyssis.be', 'username.studentenweb.org' ]
</pre>
Use your ULYSSIS username in place of ''username''.
</li>
<li>
Put an <code>.htaccess</code> file in your site's directory, e.g. the <code>www</code> folder:
<pre>Options +ExecCGI
AddHandler fcgid-script .fcgi
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ mysite.fcgi/$1 [QSA,L]</pre>
</li>
<li>
Create the starter script (replace <code>user</code> with org if you are an organization, and <code>username</code> with your ULYSSIS username):
<syntaxhighlight lang="python">#!/home/user/username/.venv/bin/python

import sys, os, os.path
from threading import Thread

this_file = os.path.realpath(__file__)

site_dir = '/home/user/username/mysite'
sys.path.insert(0, site_dir)
os.chdir(site_dir)

os.environ['DJANGO_SETTINGS_MODULE'] = 'mysite.settings'

def stat_thread():
import time, os, signal
start_mtime = os.stat(this_file).st_mtime
while True:
cur_mtime = os.stat(this_file).st_mtime
if cur_mtime != start_mtime:
os.kill(os.getpid(), signal.SIGTERM)
time.sleep(1)

Thread(target=stat_thread).start()

from django.core.servers.basehttp import get_internal_wsgi_application
from flup.server.fcgi import WSGIServer
WSGIServer(get_internal_wsgi_application(), debug=False).run()
</syntaxhighlight>
Call this script <code>mysite.fcgi</code>.
</li>
<li>
Make the starter script executable:
<pre>chmod +x mysite.fcgi</pre>
</li>
<li>
Go to ''username''.ulyssis.be (or whatever URL you chose to use), and it should show you the default "Welcome to Django" page.
</li>
</ol>

This guide was based on, and you can find more information in the official Django documentation:
* [https://docs.djangoproject.com/en/stable/intro/tutorial01/ The Django tutorial]
* [https://flask.palletsprojects.com/en/1.1.x/deploying/fastcgi/ Flask documentation for FastCGI]

==== Go ====
To make a website or web application in Go and host it on your ULYSSIS hosting account, you can use the standard library ''fcgi'' package.

<ol>
<li> [[Accessing shell servers over SSH|Log in to a shell server]]</li>
<li> Put an <code>.htaccess</code> file in your site's directory (e.g. the <code>www</code> folder) with a reference to your executable. Here we've chosen <code>mysite.fcgi</code>, but you can adapt this to your liking.
<pre>Options +ExecCGI
AddHandler fcgid-script .fcgi
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ mysite.fcgi/$1 [QSA,L]</pre>
</li>
<li> Write your code, and compile the binary to <code>mysite.fcgi</code>. Below you can find a basic example of how to register two handlers (of which one is the fallback), then start the FastCGI client, and finally have a function (which is called as a goroutine) to check if the binary has been replaced so old processes don't stick around.
<syntaxhighlight lang="go">package main

import (
"fmt"
"net/http"
"net/http/fcgi"
"os"
"path/filepath"
"time"
)

func uri_interesting(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
fmt.Fprintln(w, "<h1>Oh, seems like this link isn't that interesting after all</h1>")
fmt.Fprintln(w, "<p>Back to the <a href=\"/\">Homepage</a></p>")
}

func uri_default(w http.ResponseWriter, r *http.Request) {
if r.URL.Path != "/" {
w.WriteHeader(http.StatusNotFound)
fmt.Fprintln(w, "<h1>This page doesn't exist</h1>")
fmt.Fprintln(w, "<p>Back to the <a href=\"/\">Homepage</a></p>")
} else {
w.WriteHeader(http.StatusOK)
fmt.Fprintln(w, "<h1>Welcome to this testwebsite!</h1>")
fmt.Fprintln(w, "<p>This website is written in Go but doesn't really do much.")
fmt.Fprintln(w, "Feel free to visit this <a href=\"/interesting/link\">Interesting link</a> or this <a href=\"/non-existent/link\">non-existent link</a>.</p>")
}
}

func main() {
go check_selfreplacement()
http.HandleFunc("/interesting/link", uri_interesting)
http.HandleFunc("/", uri_default)
if err := fcgi.Serve(nil, nil); err != nil {
panic(err)
}
}

func check_selfreplacement() {
fcgi_location, _ := os.Executable()
fcgi_location, _ = filepath.EvalSymlinks(fcgi_location)
start_stat, _ := os.Stat(fcgi_location)
for {
current_stat, _ := os.Stat(fcgi_location)
if start_stat.ModTime() != current_stat.ModTime() {
os.Exit(0)
}
time.Sleep(1 * time.Second)
}
}
</syntaxhighlight>
If you want to give this example a try, save it as <code>mysite.fcgi.go</code> and then use <code>go build mysite.fcgi.go</code> to compile it.
</li>
<li>Visit your website to verify everything works</li>
</ol>

[[Category:Webserver]]

Getting SSL/TLS

2023-09-17T14:55:44Z

Bert: /* Requesting SSL from the KU Leuven */

ULYSSIS does not sell or offer any other SSL certificates than our self-signed certificate. We will however guide requests and install a certificate from the KU Leuven if you are eligible for one, and we will also install certificates you have bought or obtained elsewhere.

==Requesting SSL from the KU Leuven==

The KU Leuven partners with other universities through TERENA/Géant to arrange certificates for its services, organisations and academic structures. We have permission to request free SSL/TLS certificates for student unions (kringen) recognized by LOKO or faculty consultative bodies (facultaire overlegorganen) recognized by Studentenraad KU Leuven as well as organisations (vrije verenigingen) recognized by LOKO or KU Leuven. We are not eligible to request SSL/TLS certificates for individuals with a personal account, nor research groups or staff associations. We suggest those latter groups request certificates from KU Leuven ICTS directly or consider Let's Encrypt or another third party service.

Before sending us a request, the following steps have to be performed:
* Set up the site that needs SSL if that's not already the case
* Make sure our nameservers are being used for the involved domain(s), as explained on [[Adding domain names]]
* Consider all subdomains (whether separate websites or not) you wish to have certificates for
* Make a list of all relevant arguments for your use of SSL/TLS certificates. It's important to consider aspects of your website where important or personal information is exchanged: registration, login pages, newsletter signup, etc. These arguments have to apply to your current site. Future plans are not considered valid arguments.

When '''all''' steps are done, the account holder of the ULYSSIS account can send an email to ulyssis@ulyssis.org containing their name, the name of the organisation, the relevant arguments what you will use SSL for and the domain and if needed a list of subdomains that should be covered by the certificate.

Based on our previous experience and our arrangements with ICTS we will consider whether you are eligible for certificates and whether your request is well-founded. We will then generate the required cryptographic key and request and submit them on the certificate platform supplied by ICTS and its partners. Depending on the situation, the verification and delivery of the certificate can take some time. As soon as the certificate has been issued, we will install it and notify you.

For procedures to request certificates, we follow instructions from ICTS. These instructions have changed several times in the past, so it's possible for a new request or for a renewal, you may have to follow a different procedure or make changes.

{{notice|Limitations|ICTS does not allow SSL requests for historic *.student.kuleuven.be domains. We judge requests for username.ulyssis.be and username.studentenweb.org on an individual basis.}}

==External certificates==
To install external certificates we require the certificate itself, the private key, and possibly the chain. We prefer you also send us (a link to) the documentation of your supplier. As certificate files, especially private keys, are a delicate matter we suggest you just email us the path in your homedirectory you've put them and we will move them over to the webserver safely. For more information concerning this procedure you can always contact us on ulyssis@ulyssis.org

===Let's Encrypt===
We currently do not have an automated system for renewing and deploying certificates such as those supplied by Let's Encrypt. We are however looking into automating this process in the future. Since more of our users are starting to use Let's Encrypt, and all of their certificates need to be renewed frequently, we have a specific procedure now.

When wishing to add a certificate with Let's Encrypt to your website, or renew your existing one, first create a folder <code>letsencrypt</code> in your '''home directory'''. Then add a folder per domain or group of domains:

mkdir -p ~/letsencrypt/mydomain.be

Certificates should be stored in these folders, according to the following file structure:

letsencrypt/
└── mydomain.be/
├── mydomain.be.chain (the CA file)
├── mydomain.be.crt (the cert file; "public key")
└── mydomain.be.key (the key file; "private key")

If you already possess the necessary files, renaming and copying them accordingly is sufficient.
'''You still have to email us to install your certificate.''' More information in the last section on this page.

Otherwise, you can generate or renew your certificates using acme.sh. This is explained in the next section.

==== Generating certificates ====
{{notice|If you use a <code>.htaccess</code> file in the webroot of the domain name, make sure to add the following lines at the top of the file:|<pre><IfModule mod_rewrite.c>
RewriteRule "^.well-known/acme-challenge" - [L]
</IfModule></pre>}}
Because the normal method of generating Let's Encrypt certificates, certbot, requires root access, it's impossible for normal users to do so on our servers. Luckily there are plenty of alternatives which implement the Let's Encrypt protocol. In this tutorial, we'll show how to use the acme.sh program to generate certificates on the ULYSSIS servers. '''If you already followed this section to generate certificates, skip to the next section on renewing certificates.'''

Firstly, execute the following commands to download the acme.sh script in your home directory and make it executable:

curl -o ~/acme.sh https://raw.githubusercontent.com/acmesh-official/acme.sh/master/acme.sh
chmod +x ~/acme.sh

Next, determine for which domains and subdomains you want to generate a certificate. You will need to generate a single certificate for each domain and subdomain which points to the same folder on your account (in most cases this is <code>www</code> in your home directory).

The following example command will generate a certificate for <code>mydomain.be</code> and <code>www.mydomain.be</code> which points to the <code>www</code> folder in the home directory. '''Change the parameters''' as explained below before executing this command!

~/acme.sh --issue --cert-file ~/letsencrypt/mydomain.be/mydomain.be.crt --key-file ~/letsencrypt/mydomain.be/mydomain.be.key --ca-file ~/letsencrypt/mydomain.be/mydomain.be.chain -m "email@mydomain.be" -w ~/www -d mydomain.be -d www.mydomain.be --server letsencrypt

The explanation of these many parameters is as follows:
* <code>--issue</code> tells acme.sh to generate a new certificate.
* <code>--cert-file ~/letsencrypt/mydomain.be/mydomain.be.crt</code> tells acme.sh to store the certificate file in the <code>letsencrypt/mydomain.be</code> folder in your home directory, using the special file name as required by the file structure. '''This folder should already exist''', please refer to the previous section if you have not created this folder yet.
* <code>--key-file ~/letsencrypt/mydomain.be/mydomain.be.key</code> tells acme.sh to store the key file in the <code>letsencrypt/mydomain.be</code> folder in your home directory, using the special file name as required by the file structure.
* <code>--ca-file ~/letsencrypt/mydomain.be/mydomain.be.chain</code> tells acme.sh to store the CA file in the <code>letsencrypt/mydomain.be</code> folder in your home directory, using the special file name as required by the file structure.
* <code>-m "email@mydomain.be"</code> tells acme.sh the email address associated with the certificate. Let's Encrypt will remind this email address (if provided) when the certificate is close to expiring.
* <code>-w ~/www</code> tells acme.sh where the domains in this certificate point to. Make sure to change the <code>www</code> part if the domains point to a different folder in your home directory.
* <code>-d mydomain.be</code> and <code>-d www.mydomain.be</code> tell acme.sh that the certificate should protect <code>mydomain.be</code> and <code>www.mydomain.be</code>. The first domain name will be the "main domain", which is important for renewing. You should '''add all domain names''' pointing to the <code>-w</code> folder.
* <code>--server letsencrypt</code> tells acme.sh to use https://letsencrypt.org/ as Certificate Authority (CA).

After executing this command with the right parameters, your certificate should be generated successfully. When you have to renew the certificate in the future, you should follow the instructions in the next section. '''Don't forget to email us to install your new certificate.''' More information in the last section on this page.

==== Renewing certificates ====
To renew the certificates of <code>mydomain.be</code>, just execute:
~/acme.sh --renew -d mydomain.be

For the <code>-d</code> parameter, you have to provide the '''first''' domain name you provided when generating the certificate (in the previous section, this was <code>mydomain.be</code>.

If you are not sure which domain name to use, you can execute the command:
~/acme.sh --list

This will generate a list of available certificates, which looks a bit like this:
Main_Domain KeyLength SAN_Domains CA Created Renew
mydomain.be "" www.mydomain.be LetsEncrypt.org ... ...
... ... ... ... ... ...

In this example, the main domain is <code>mydomain.be</code>.

The renewed certificates will automatically be copied to the files you provided in the command to generate the certificates (see previous section).

'''After renewing the certificate, you have to email us to install your certificate.''' More information in the next section.

==== Getting your certificates installed ====
Check whether everything is stored correctly by executing the following command:
ulyssis-certificate check mydomain.be

If everything looks good, you should only see lines starting with <code>[ OK ]</code>. Any line starting with <code>[FAIL]</code> or <code>[ABRT]</code> means a check has failed, you must correct this error before asking us to install your certificate.

Once all steps are done and if you are the '''account holder''', '''you can send us an email clearly stating the account name, for which domains we need to add certificates and where the files are stored'''. If you are renewing existing certificates, also clearly state that in your email.

We have largely automated the installation of certificates. If you do not follow these instructions, your request will be denied or you may end up with broken SSL, so make sure you follow this procedure carefully.

[[Category:Webserver]]

Securing MediaWiki using Centrale KU Leuven Login

2023-05-09T21:25:19Z

Bert:

==About==
MediaWikiShibboleth is a MediaWiki extension created by ULYSSIS to allow for login through the Central KU Leuven Login (Shibboleth). The extension disables editing and creating of (talk) pages by anonymous users, and requires Shibboleth authentication for account creation and login.

==Prerequisites==
Before installing, you need to have SSL and Shibboleth (Central KU Leuven Login) enabled on your domain.
* For instructions on how to get SSL/TLS: https://docs.ulyssis.org/Getting_SSL/TLS
* Information about requesting Shibboleth: https://docs.ulyssis.org/Shibboleth
Once you know everything is installed properly, you can proceed to install the extension.

==Installation==
First, download the latest release from [https://github.com/ULYSSIS-KUL/MediaWikiShibboleth/releases/latest/download/MediaWikiShibboleth.zip github]. Unzip the zip file in the <code>extensions/</code> directory in your MediaWiki installation folder. Make sure there is now a <code>MediaWikiShibboleth</code> folder in <code>extensions/</code>. Finally, locate the <code>LocalSettings.php</code> file in your MediaWiki installation folder and add the following lines to it:

wfLoadExtension('MediaWikiShibboleth');
$wgGroupPermissions['*']['createaccount'] = false;
$wgRevokePermissions['Shibboleth']['editmyprivateinfo'] = true;

$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['writeapi'] = false;

If you want to allow anonymous editing, you should <b>not</b> add the last 2 lines of the previous paragraph. This really defeats the purpose of the extension though.

==Configuration==
MediaWikiShibboleth has some configuration options which allow for restricting who can log in to your wiki. These restrictions are cumulative. For example, it is possible to allow only students enrolled in a specific degree or programme to log in. These options work especially well with restricting the access of the wiki to logged-in users only.

=== Restricting access to logged-in users only ===
This option is not an option provided by the extension, but very useful in its context. If you do not want guest visitors to be able to view any page of your wiki, add the following line to your <code>LocalSettings.php</code>:

$wgGroupPermissions['*']['read'] = false;

=== MWSStudentsOnly ===
This option tells MediaWikiShibboleth to only allow students to log in. KU Leuven employees, alumni, doctoral students, teaching assistants etc. will not be able to log in using their employee account. Do keep in mind doctoral students also have a student account, which will still work. Set this option by adding

$wgMWSStudentsOnly = true;

to <code>LocalSettings.php</code>. If you combine this option with "Restricting access to logged-in users only", only students will be able to view, log in and edit your wiki.

=== MWSAllowedKULids ===
This option can be used to only allow specific KUL ids to log in. An example KUL id is "r0653730". If this option is set to "", no KUL id checking will be performed. Set this option by adding

$wgMWSAllowedKULids = "r0653730, r0300342, KUL id 3...";

to <code>LocalSettings.php</code>. You can add as many KUL ids as you like, separated by a comma.

=== MWSAllowedDegrees ===
This option can be used to only allow students enrolled in specific degrees/programmes to log in. An example KUL degree number is "51016742". If this option is set to "", no degree number checking will be performed. Set this option by adding

$wgMWSAllowedDegrees = "51016742, 51016835, 51016753...";

to <code>LocalSettings.php</code>. You can add as many degree numbers as you like, separated by a comma.

=== Translations ===
It's possible to translate and modify all public MediaWikiShibboleth messages. The translations can be found in the <code>extensions/MediaWikiShibboleth/i18n/</code>. Dutch (<code>nl.json</code>) and English (<code>en.json</code>) translations are already provided. Even the provided translations can be customized, and we strongly advise you to do so, in order to match them with your wiki situation.

==Operation==
When the extension is installed successfully, anonymous users will not be able to create an account and the account creation page will be removed from the home page. On the log in page, a new image is added: if you click on this image, you will be logged in using Shibboleth. If you want to log in with an explicit username/password combination, you can click "Login without Central KU Leuven login" to expand a login menu.

The new log in page looks like this with "Login without Central KU Leuven login" expanded:

[[File:Login.png|thumb|none]]

==Creating accounts==
If you want to create password accounts, you can navigate to the CreateAccount special page (make sure you are logged in using an administrator account). This is necessary to create accounts for users without a KU Leuven login. You should select "Use a temporary random password and send it to the specified email address".

[[File:CreateAccount.png|thumb|none]]

[[Category:Security & anti-spam]]
[[Category:CMSs]]

Mailbox in Thunderbird

2023-02-24T11:33:01Z

Bert:

{{SMTPnotice|your mailbox in Thunderbird}}

When you create a ULYSSIS account, you get an email address: <code>''username''@ulyssis.org</code>. Usually, this address gets forwarded to your KU Leuven email address. However, you can choose to use it as your own [[Mailbox|ULYSSIS mailbox]].

It is possible to check this mailbox via https://webmail.ulyssis.org. However, it is far more convenient and efficient to use a standalone email client. This article will explain the process of adding a mailbox to the Thunderbird client.
==Thunderbird==
Thunderbird is a free and open source email client made by Mozilla. It is available for download at https://thunderbird.net. You can then install the downloaded file like you would install any other application. Once installed, launch Thunderbird and configure a mailbox using the steps below.

==Adding a ULYSSIS mailbox to Thunderbird==
If this is the first mailbox being added to Thunderbird, the following pop-up should come up:
[[File:First Open TB.png|left|alt=|thumb|432x432px]]

If the pop-up did not appear, or this is not your first mailbox; click the email button (highlighted in blue in the screenshot below) under the "Set Up Another Account" section:
[[File:New Mailbox.png|left|alt=|thumb|600x600px]]

Once the pop-up is present, proceed by entering the login details for your mailbox. The first step is to fill in your name, email address and password (this email address should be your ULYSSIS username followed by <code>@ulyssis.org</code>):
[[File:Fill in email.png|left|alt=|thumb|432x432px]]

Next, the button "Configure manually..." on the bottom left will become clickable (as seen on the screenshot above). When this button is clicked, the pop-up should look like this:
[[File:Click Configure Manually.png|left|alt=|thumb|479x479px]]

Now, fill in the information as follows:

[[File:Fill advanced.png|left|alt=|thumb|479x479px]]
{| class="wikitable"
|+ Manual settings
|-
|| || INCOMING || OUTGOING
|-
|| Protocol: || IMAP || SMTP
|-
|| Server: || mail.ulyssis.org || smtps.kuleuven.be
|-
|| Port: || 993 || 443
|-
|| SSL: || SSL/TLS || SSL/TLS
|-
| style="padding-right: 10px" | Authentication:
|| Autodetect
|| Autodetect
|-
|| Username:
| style="padding-right: 10px" | ULYSSIS username
|| r/m/s/u number
|-
| colspan="3" |

Notice the ports used to configure a ULYSSIS mailbox are not automatically recognized by Thunderbird. This means they should be entered manually instead of using the drop-down.
|}

The "Re-test" button on the bottom right of the following screenshot is used to validate the settings. When pressed, Thunderbird will try to connect to the mail server. When successful, the pop-up should look like this:

[[File:After Clicking Retest GOOD.png|left|alt=|thumb|479x479px]]

If this test succeeds, the pop-up will close when the "Done" button has been clicked. After the pop-up closes, a mailbox should be added to the left sidebar of the main Thunderbird window. By clicking on the inbox tab, your emails should start showing up (as seen in the last screenshot). After finishing up this setup, your mailbox should synchronize automatically.

[[File:After Clicking GetMessages.png|left|alt=|thumb|600x600px]]

When sending the first email after configuration, Thunderbird might show a pop-up: "Enter your password for r0000000 on smtps.kuleuven.be:". It is really important to enter your KU Leuven password (the password used for central login), otherwise your email will not be sent.

[[Category:Mail]]

Mailbox

2023-02-24T11:32:43Z

Bert:

Your ulyssis account includes an email address: <code>''username''@ulyssis.org</code>. It is important you check your ulyssis mailbox regularly, because all important information will be sent to this address. You can check your e-mail using webmail or an email client of your own. It is also possible to configure your email address in UCC to automatically [[Forwarders|forward]] all correspondence to another address.

==Webmail==
You can access your mail via a webinterface: https://webmail.ulyssis.org. Use your username and password to login.

==POP and IMAP access==
You can access your ulyssis mail with POP or IMAP. The configuration parameters are:

* '''server''': <code>mail.ulyssis.org</code>
* '''port''': 993
* '''username''': ''your ULYSSIS username''
* '''password''': ''your ULYSSIS password''
* '''security''': SSL

==SMTP==
{{SMTPnotice|your mailbox with an external application}}
ULYSSIS doesn't offer SMTP. Instead, you can use KULeuven's SMTP server:

* '''server''': <code>smtps.kuleuven.be</code>
* '''port''': 443
* '''username''': ''your student id''
* '''password''': ''your KULeuven password''
* '''security''': SSL

== Advanced ==
Your emails are stored within your account under ~/Maildir. These files can of course be read with a command line email client such as alpine or mutt.

We support sendmail style local delivery using .forward. More information is available in the official documentation of [https://www.sendmail.org/~ca/email/doc8.9/op-sh-2.html#sh-2.8 Sendmail] and [http://www.postfix.org/local.8.html Postfix]. While it's possible to use .forward to simply forward email to other addresses, we recommend only using it when the same feature is not available through our control panel [https://ucc.ulyssis.org UCC]. Specifically, .forward can be used to pass emails to other applications. In the past, a popular application to pass email through was procmail. However, procmail has not seen development for about 2 decades, and its developer suggests not using it anymore. So while some users may find procmail filters useful, we do not support or suggest its use anymore. A detailed manual for procmail is available on the [https://wiki.archlinux.org/index.php/Procmail ArchWiki].

[[Category:Mail]]

Mailbox in Thunderbird

2023-02-24T11:31:55Z

Bert:

{{SMTPnotice|your mailbox in Thundebird}}

When you create a ULYSSIS account, you get an email address: <code>''username''@ulyssis.org</code>. Usually, this address gets forwarded to your KU Leuven email address. However, you can choose to use it as your own [[Mailbox|ULYSSIS mailbox]].

It is possible to check this mailbox via https://webmail.ulyssis.org. However, it is far more convenient and efficient to use a standalone email client. This article will explain the process of adding a mailbox to the Thunderbird client.
==Thunderbird==
Thunderbird is a free and open source email client made by Mozilla. It is available for download at https://thunderbird.net. You can then install the downloaded file like you would install any other application. Once installed, launch Thunderbird and configure a mailbox using the steps below.

==Adding a ULYSSIS mailbox to Thunderbird==
If this is the first mailbox being added to Thunderbird, the following pop-up should come up:
[[File:First Open TB.png|left|alt=|thumb|432x432px]]

If the pop-up did not appear, or this is not your first mailbox; click the email button (highlighted in blue in the screenshot below) under the "Set Up Another Account" section:
[[File:New Mailbox.png|left|alt=|thumb|600x600px]]

Once the pop-up is present, proceed by entering the login details for your mailbox. The first step is to fill in your name, email address and password (this email address should be your ULYSSIS username followed by <code>@ulyssis.org</code>):
[[File:Fill in email.png|left|alt=|thumb|432x432px]]

Next, the button "Configure manually..." on the bottom left will become clickable (as seen on the screenshot above). When this button is clicked, the pop-up should look like this:
[[File:Click Configure Manually.png|left|alt=|thumb|479x479px]]

Now, fill in the information as follows:

[[File:Fill advanced.png|left|alt=|thumb|479x479px]]
{| class="wikitable"
|+ Manual settings
|-
|| || INCOMING || OUTGOING
|-
|| Protocol: || IMAP || SMTP
|-
|| Server: || mail.ulyssis.org || smtps.kuleuven.be
|-
|| Port: || 993 || 443
|-
|| SSL: || SSL/TLS || SSL/TLS
|-
| style="padding-right: 10px" | Authentication:
|| Autodetect
|| Autodetect
|-
|| Username:
| style="padding-right: 10px" | ULYSSIS username
|| r/m/s/u number
|-
| colspan="3" |

Notice the ports used to configure a ULYSSIS mailbox are not automatically recognized by Thunderbird. This means they should be entered manually instead of using the drop-down.
|}

The "Re-test" button on the bottom right of the following screenshot is used to validate the settings. When pressed, Thunderbird will try to connect to the mail server. When successful, the pop-up should look like this:

[[File:After Clicking Retest GOOD.png|left|alt=|thumb|479x479px]]

If this test succeeds, the pop-up will close when the "Done" button has been clicked. After the pop-up closes, a mailbox should be added to the left sidebar of the main Thunderbird window. By clicking on the inbox tab, your emails should start showing up (as seen in the last screenshot). After finishing up this setup, your mailbox should synchronize automatically.

[[File:After Clicking GetMessages.png|left|alt=|thumb|600x600px]]

When sending the first email after configuration, Thunderbird might show a pop-up: "Enter your password for r0000000 on smtps.kuleuven.be:". It is really important to enter your KU Leuven password (the password used for central login), otherwise your email will not be sent.

[[Category:Mail]]

Add an alias in Thunderbird

2023-02-24T11:31:12Z

Bert:

{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this, but to configure this properly, you should not use your provider's SMTP server. They will add an extra header stating the original e-mail address the e-mail is sent from. Some e-mail clients show this information, which might be unwanted.

The KU Leuven also provides an SMTP server which you can use as a student. It accepts e-mail originating from any e-mail adress, and can therefore be used for this purpose. It should be noted that this is an '''authenticated''' server, so any potential abuse can be tracked back to you. You should '''not''' use this for any malicious purpose.

== Adding the KU Leuven SMTP server in Thunderbird ==
If you already have set up your KU Leuven e-mail in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below based on the [https://admin.kuleuven.be/icts/english/services/email/imap-configuratie-en official ICTS documentation]. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the SMTP server of your KULid. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Add an alias in Hotmail/Outlook

2023-02-24T11:31:07Z

Bert:

{{notice|Adding an alias to Hotmail/Outlook is not advised|Hotmail/Outlook does not use a relevant SMTP server, for example the one of the KU Leuven, to send emails as an alias. This may cause recipients to automatically reject your email or mark it as spam. You can circumvent this issue by using Thunderbird or another email provider. Please refer to [[Using a forwarder as an alias]] for some potential alternatives.}}
{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Outlook.com using your @ulyssis.org address, or another domain name that you use for your account. Outlook.com allows you to do this by configuring a few settings. Because you should only be able to send mails from an e-mail address you actually own, make sure that you configured receiving mails before starting this process. Outlook.com will send a confirmation mail to the provided e-mail address to confirm that you own it.

# In Outlook.com, click on your profile image.
# Click '''My Microsoft account''' (Dutch: '''Mijn Microsoft-account''').
# Go to the tab '''Your info''' (Dutch: '''Je gegevens''').
# Under '''Account info''' (Dutch: '''Rekeninggegevens''') click on: '''Sign-in preferences''' (Dutch: '''Aanmeldingsvoorkeuren''').
# You will have to log in again to proceed. Click '''Add email''' (Dutch: '''E-mailadres toevoegen''').
# Select '''Add an existing email address as a Microsoft account alias''' (Dutch: '''Een bestaand e-mailadres als een Microsoft-accountalias toevoegen''') and fill in the email address you want to send from.
# Click '''Add alias''' (Dutch: '''Alias toevoegen''').
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Outlook.com from this address:

# In Outlook.com, click '''New message''' (Dutch: '''Nieuw bericht''').
# Click on '''From''' (Dutch: '''Van''') and select the email address.

[[Category:Mail]]

Add an alias in Gmail

2023-02-24T11:31:02Z

Bert:

{{SMTPnotice|a forwarder as an alias}}

You may want to send e-mail from Gmail using your @ulyssis.org address, or another domain name that you use for your account. Gmail allows you to do this, but asks for SMTP info. We don't provide SMTP on our own mail server, but you can use the SMTP servers of the KU Leuven.
Because you should only be able to send mails from an email address you actually own, make sure that you configured receiving mails before starting this process. Gmail will send a confirmation mail to the provided email address to confirm that you own it.

# In Gmail, click on the gear icon at the top right.
# Click '''See all settings''' (Dutch: '''Alle instellingen bekijken''').
# Go to the tab '''Accounts and Import''' (Dutch: '''Accounts en import''').
# Under '''Send mail as:''' (Dutch: '''Mail verzenden als:'''), click on: '''Add another email address''' (Dutch: '''Nog een e-mailadres toevoegen''').
# Fill in the email address you want to send from, and check '''Treat as an alias.''' (Dutch: '''Beschouwen als alias.''') More info: https://support.google.com/a/answer/1710338
# Optionally: Enter a '''Name''', the recipient will see this name instead of or next to your email address.
# Click on '''Next step''' (Dutch: '''Volgende stap''').
# Fill in the [https://admin.kuleuven.be/icts/english/services/email/imap-configuratie-en KU Leuven SMTP information] ([https://admin.kuleuven.be/icts/services/email/imap-configuratie Dutch]):
#*'''SMTP server''': '''smtps.kuleuven.be'''
#* '''Port''': '''465'''
#* '''Username''': your KU Leuven intranet userid r or u-number e.g. r0123456
#* '''Password''': your central KU Leuven password
#* '''Secured connection using''': '''SSL'''
# Click on the '''Add Account''' (Dutch: '''Account toevoegen''') button.
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Gmail from this address:

# In Gmail, click '''Compose''' (Dutch: '''Opstellen''').
# Click on the email address next to '''From''' (Dutch: '''Van''').
# Select the email address you want to send from.

[[Category:Mail]]

Using a forwarder as an alias

2023-02-24T11:30:50Z

Bert:

{{SMTPnotice|a forwarder as an alias}}

If you have your own domain, it's very easy to use [[Forwarders]] to forward email from addresses under your own domain to other email addresses at external providers or your ULYSSIS mailbox. While you can always reply with the address of that external provider or the @ulyssis.org address of your mailbox, it's often preferred to also use the address of your own domain when replying to messages or starting conversations. In that case you will want to configure an alias for your forwarder.

While you are free to use whatever provider, email application or webmail application you prefer, we have step-by-step manuals available for some specific case. You can find them listed here:
* [[Add an alias in ULYSSIS webmail]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]

[[Category:Mail]]

Template:SMTPnotice

2023-02-24T11:29:57Z

Bert:

{{notice|To use {{{1}}}, access to the KU Leuven SMTP server is required|Since 24 February 2023, not all students have access to smtps.kuleuven.be by default anymore. If you are unable to send emails after following the instructions outlined in our documentation, then you may have to register on https://ulyssis.org/smtp/ to (re)gain SMTP access.}}

Mailbox in Thunderbird

2023-02-24T11:13:29Z

Bert:

{{SMTPnotice}}

When you create a ULYSSIS account, you get an email address: <code>''username''@ulyssis.org</code>. Usually, this address gets forwarded to your KU Leuven email address. However, you can choose to use it as your own [[Mailbox|ULYSSIS mailbox]].

It is possible to check this mailbox via https://webmail.ulyssis.org. However, it is far more convenient and efficient to use a standalone email client. This article will explain the process of adding a mailbox to the Thunderbird client.
==Thunderbird==
Thunderbird is a free and open source email client made by Mozilla. It is available for download at https://thunderbird.net. You can then install the downloaded file like you would install any other application. Once installed, launch Thunderbird and configure a mailbox using the steps below.

==Adding a ULYSSIS mailbox to Thunderbird==
If this is the first mailbox being added to Thunderbird, the following pop-up should come up:
[[File:First Open TB.png|left|alt=|thumb|432x432px]]

If the pop-up did not appear, or this is not your first mailbox; click the email button (highlighted in blue in the screenshot below) under the "Set Up Another Account" section:
[[File:New Mailbox.png|left|alt=|thumb|600x600px]]

Once the pop-up is present, proceed by entering the login details for your mailbox. The first step is to fill in your name, email address and password (this email address should be your ULYSSIS username followed by <code>@ulyssis.org</code>):
[[File:Fill in email.png|left|alt=|thumb|432x432px]]

Next, the button "Configure manually..." on the bottom left will become clickable (as seen on the screenshot above). When this button is clicked, the pop-up should look like this:
[[File:Click Configure Manually.png|left|alt=|thumb|479x479px]]

Now, fill in the information as follows:

[[File:Fill advanced.png|left|alt=|thumb|479x479px]]
{| class="wikitable"
|+ Manual settings
|-
|| || INCOMING || OUTGOING
|-
|| Protocol: || IMAP || SMTP
|-
|| Server: || mail.ulyssis.org || smtps.kuleuven.be
|-
|| Port: || 993 || 443
|-
|| SSL: || SSL/TLS || SSL/TLS
|-
| style="padding-right: 10px" | Authentication:
|| Autodetect
|| Autodetect
|-
|| Username:
| style="padding-right: 10px" | ULYSSIS username
|| r/m/s/u number
|-
| colspan="3" |

Notice the ports used to configure a ULYSSIS mailbox are not automatically recognized by Thunderbird. This means they should be entered manually instead of using the drop-down.
|}

The "Re-test" button on the bottom right of the following screenshot is used to validate the settings. When pressed, Thunderbird will try to connect to the mail server. When successful, the pop-up should look like this:

[[File:After Clicking Retest GOOD.png|left|alt=|thumb|479x479px]]

If this test succeeds, the pop-up will close when the "Done" button has been clicked. After the pop-up closes, a mailbox should be added to the left sidebar of the main Thunderbird window. By clicking on the inbox tab, your emails should start showing up (as seen in the last screenshot). After finishing up this setup, your mailbox should synchronize automatically.

[[File:After Clicking GetMessages.png|left|alt=|thumb|600x600px]]

When sending the first email after configuration, Thunderbird might show a pop-up: "Enter your password for r0000000 on smtps.kuleuven.be:". It is really important to enter your KU Leuven password (the password used for central login), otherwise your email will not be sent.

[[Category:Mail]]

Mailbox

2023-02-24T11:13:22Z

Bert:

{{SMTPnotice}}

Your ulyssis account includes an email address: <code>''username''@ulyssis.org</code>. It is important you check your ulyssis mailbox regularly, because all important information will be sent to this address. You can check your e-mail using webmail or an email client of your own. It is also possible to configure your email address in UCC to automatically [[Forwarders|forward]] all correspondence to another address.

==Webmail==
You can access your mail via a webinterface: https://webmail.ulyssis.org. Use your username and password to login.

==POP and IMAP access==
You can access your ulyssis mail with POP or IMAP. The configuration parameters are:

* '''server''': <code>mail.ulyssis.org</code>
* '''port''': 993
* '''username''': ''your ULYSSIS username''
* '''password''': ''your ULYSSIS password''
* '''security''': SSL

==SMTP==
ULYSSIS doesn't offer SMTP. Instead, you can use KULeuven's SMTP server:

* '''server''': <code>smtps.kuleuven.be</code>
* '''port''': 443
* '''username''': ''your student id''
* '''password''': ''your KULeuven password''
* '''security''': SSL

== Advanced ==
Your emails are stored within your account under ~/Maildir. These files can of course be read with a command line email client such as alpine or mutt.

We support sendmail style local delivery using .forward. More information is available in the official documentation of [https://www.sendmail.org/~ca/email/doc8.9/op-sh-2.html#sh-2.8 Sendmail] and [http://www.postfix.org/local.8.html Postfix]. While it's possible to use .forward to simply forward email to other addresses, we recommend only using it when the same feature is not available through our control panel [https://ucc.ulyssis.org UCC]. Specifically, .forward can be used to pass emails to other applications. In the past, a popular application to pass email through was procmail. However, procmail has not seen development for about 2 decades, and its developer suggests not using it anymore. So while some users may find procmail filters useful, we do not support or suggest its use anymore. A detailed manual for procmail is available on the [https://wiki.archlinux.org/index.php/Procmail ArchWiki].

[[Category:Mail]]

Add an alias in Hotmail/Outlook

2023-02-24T11:13:02Z

Bert:

{{notice|Adding an alias to Hotmail/Outlook is not advised|Hotmail/Outlook does not use a relevant SMTP server, for example the one of the KU Leuven, to send emails as an alias. This may cause recipients to automatically reject your email or mark it as spam. You can circumvent this issue by using Thunderbird or another email provider. Please refer to [[Using a forwarder as an alias]] for some potential alternatives.}}
{{SMTPnotice}}

You may want to send e-mail from Outlook.com using your @ulyssis.org address, or another domain name that you use for your account. Outlook.com allows you to do this by configuring a few settings. Because you should only be able to send mails from an e-mail address you actually own, make sure that you configured receiving mails before starting this process. Outlook.com will send a confirmation mail to the provided e-mail address to confirm that you own it.

# In Outlook.com, click on your profile image.
# Click '''My Microsoft account''' (Dutch: '''Mijn Microsoft-account''').
# Go to the tab '''Your info''' (Dutch: '''Je gegevens''').
# Under '''Account info''' (Dutch: '''Rekeninggegevens''') click on: '''Sign-in preferences''' (Dutch: '''Aanmeldingsvoorkeuren''').
# You will have to log in again to proceed. Click '''Add email''' (Dutch: '''E-mailadres toevoegen''').
# Select '''Add an existing email address as a Microsoft account alias''' (Dutch: '''Een bestaand e-mailadres als een Microsoft-accountalias toevoegen''') and fill in the email address you want to send from.
# Click '''Add alias''' (Dutch: '''Alias toevoegen''').
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Outlook.com from this address:

# In Outlook.com, click '''New message''' (Dutch: '''Nieuw bericht''').
# Click on '''From''' (Dutch: '''Van''') and select the email address.

[[Category:Mail]]

Add an alias in Gmail

2023-02-24T11:12:57Z

Bert:

{{SMTPnotice}}

You may want to send e-mail from Gmail using your @ulyssis.org address, or another domain name that you use for your account. Gmail allows you to do this, but asks for SMTP info. We don't provide SMTP on our own mail server, but you can use the SMTP servers of the KU Leuven.
Because you should only be able to send mails from an email address you actually own, make sure that you configured receiving mails before starting this process. Gmail will send a confirmation mail to the provided email address to confirm that you own it.

# In Gmail, click on the gear icon at the top right.
# Click '''See all settings''' (Dutch: '''Alle instellingen bekijken''').
# Go to the tab '''Accounts and Import''' (Dutch: '''Accounts en import''').
# Under '''Send mail as:''' (Dutch: '''Mail verzenden als:'''), click on: '''Add another email address''' (Dutch: '''Nog een e-mailadres toevoegen''').
# Fill in the email address you want to send from, and check '''Treat as an alias.''' (Dutch: '''Beschouwen als alias.''') More info: https://support.google.com/a/answer/1710338
# Optionally: Enter a '''Name''', the recipient will see this name instead of or next to your email address.
# Click on '''Next step''' (Dutch: '''Volgende stap''').
# Fill in the [https://admin.kuleuven.be/icts/english/services/email/imap-configuratie-en KU Leuven SMTP information] ([https://admin.kuleuven.be/icts/services/email/imap-configuratie Dutch]):
#*'''SMTP server''': '''smtps.kuleuven.be'''
#* '''Port''': '''465'''
#* '''Username''': your KU Leuven intranet userid r or u-number e.g. r0123456
#* '''Password''': your central KU Leuven password
#* '''Secured connection using''': '''SSL'''
# Click on the '''Add Account''' (Dutch: '''Account toevoegen''') button.
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Gmail from this address:

# In Gmail, click '''Compose''' (Dutch: '''Opstellen''').
# Click on the email address next to '''From''' (Dutch: '''Van''').
# Select the email address you want to send from.

[[Category:Mail]]

Add an alias in Thunderbird

2023-02-24T11:12:49Z

Bert:

{{SMTPnotice}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this, but to configure this properly, you should not use your provider's SMTP server. They will add an extra header stating the original e-mail address the e-mail is sent from. Some e-mail clients show this information, which might be unwanted.

The KU Leuven also provides an SMTP server which you can use as a student. It accepts e-mail originating from any e-mail adress, and can therefore be used for this purpose. It should be noted that this is an '''authenticated''' server, so any potential abuse can be tracked back to you. You should '''not''' use this for any malicious purpose.

== Adding the KU Leuven SMTP server in Thunderbird ==
If you already have set up your KU Leuven e-mail in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below based on the [https://admin.kuleuven.be/icts/english/services/email/imap-configuratie-en official ICTS documentation]. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the SMTP server of your KULid. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Using a forwarder as an alias

2023-02-24T11:12:44Z

Bert:

{{SMTPnotice}}

If you have your own domain, it's very easy to use [[Forwarders]] to forward email from addresses under your own domain to other email addresses at external providers or your ULYSSIS mailbox. While you can always reply with the address of that external provider or the @ulyssis.org address of your mailbox, it's often preferred to also use the address of your own domain when replying to messages or starting conversations. In that case you will want to configure an alias for your forwarder.

While you are free to use whatever provider, email application or webmail application you prefer, we have step-by-step manuals available for some specific case. You can find them listed here:
* [[Add an alias in ULYSSIS webmail]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]

[[Category:Mail]]

Using a forwarder as an alias

2023-02-24T11:12:18Z

Bert:

Template:SMTPnotice

2023-02-24T11:12:01Z

Bert: Created page with "{{notice|To use a forwarder as an alias, access to the KU Leuven SMTP server is required|Since 24 February 2023, not all students have access to smtps.kuleuven.be by default a..."

Using a forwarder as an alias

2023-02-24T11:09:43Z

Bert:

{{notice|To use a forwarder as an alias, access to the KU Leuven SMTP server is required|Since 24 February 2023, not all students have access to smtps.kuleuven.be by default anymore. If you are unable to send emails after following the instructions outlined in our documentation, then you may have to register on https://ulyssis.org/smtp/ to (re)gain SMTP access.}}

If you have your own domain, it's very easy to use [[Forwarders]] to forward email from addresses under your own domain to other email addresses at external providers or your ULYSSIS mailbox. While you can always reply with the address of that external provider or the @ulyssis.org address of your mailbox, it's often preferred to also use the address of your own domain when replying to messages or starting conversations. In that case you will want to configure an alias for your forwarder.

While you are free to use whatever provider, email application or webmail application you prefer, we have step-by-step manuals available for some specific case. You can find them listed here:
* [[Add an alias in ULYSSIS webmail]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]

[[Category:Mail]]

Using a forwarder as an alias

2023-02-24T11:08:44Z

Bert:

{{notice|To use a forwarder as an alias, access to the KU Leuven SMTP server is required|Since 24 February 2023, not all students have access to smtps.kuleuven.be by default anymore. If you are unable to send emails after following the instructions outlined in our documentation, then you may have to register on https://ulyssis.org/smtp/ for SMTP access.}}

If you have your own domain, it's very easy to use [[Forwarders]] to forward email from addresses under your own domain to other email addresses at external providers or your ULYSSIS mailbox. While you can always reply with the address of that external provider or the @ulyssis.org address of your mailbox, it's often preferred to also use the address of your own domain when replying to messages or starting conversations. In that case you will want to configure an alias for your forwarder.

While you are free to use whatever provider, email application or webmail application you prefer, we have step-by-step manuals available for some specific case. You can find them listed here:
* [[Add an alias in ULYSSIS webmail]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]

[[Category:Mail]]

Using a forwarder as an alias

2023-02-24T11:04:38Z

Bert:

{{notice|To use a forwarder as an alias, access to the KU Leuven SMTP server is required|Since 24 February 2023, not all students have access to smtps.kuleuven.be by default any more. If you are unable to send emails after following the instructions outlined in documentation, then you may have to register on https://ulyssis.org/smtp/ for SMTP access.}}

If you have your own domain, it's very easy to use [[Forwarders]] to forward email from addresses under your own domain to other email addresses at external providers or your ULYSSIS mailbox. While you can always reply with the address of that external provider or the @ulyssis.org address of your mailbox, it's often preferred to also use the address of your own domain when replying to messages or starting conversations. In that case you will want to configure an alias for your forwarder.

While you are free to use whatever provider, email application or webmail application you prefer, we have step-by-step manuals available for some specific case. You can find them listed here:
* [[Add an alias in ULYSSIS webmail]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]

[[Category:Mail]]

Add an alias in Thunderbird

2023-02-24T05:09:58Z

Bert:

{{notice|To use a forwarder as an alias, access to the KU Leuven SMTP server is required|Since 24 February 2023 not all students have access to this server by default any more. If you are unable to send emails after following our documentation, then you may want to register on https://ulyssis.org/smtp/ for SMTP access.}}

You may want to send e-mail from Thunderbird using your @ulyssis.org address, or another domain name that you use for your account. Thunderbird allows you to do this, but to configure this properly, you should not use your provider's SMTP server. They will add an extra header stating the original e-mail address the e-mail is sent from. Some e-mail clients show this information, which might be unwanted.

The KU Leuven also provides an SMTP server which you can use as a student. It accepts e-mail originating from any e-mail adress, and can therefore be used for this purpose. It should be noted that this is an '''authenticated''' server, so any potential abuse can be tracked back to you. You should '''not''' use this for any malicious purpose.

== Adding the KU Leuven SMTP server in Thunderbird ==
If you already have set up your KU Leuven e-mail in Thunderbird, you can skip this step and proceed to [[#Configure an identity for your e-mail account|Configure an identity for your e-mail account]] below.

Go to your '''Account Settings''' (Edit > Account Settings or Tools > Account Settings, depending on your operating system). At the bottom of the left sidebar, you will find an entry named '''Outgoing Server (SMTP)'''. Click this to access your SMTP settings.

In your SMTP settings, you should see a list of existing SMTP servers. We want to add a new entry, so click the '''Add...''' button. In the screen that pops up, fill in the settings of the KU Leuven SMTP server, using the example screenshot below based on the [https://admin.kuleuven.be/icts/english/services/email/imap-configuratie-en official ICTS documentation]. Replace the displayed user name with your own KULid (m/r/s/u number). You will have to fill in the corresponding password on first use.

[[File:Thunderbird-SMTPS.png]]

== Configure an identity for your e-mail account ==
Back in the '''Account Settings''' screen, click on your e-mail address (not on any of its children). In the screen that opens, there will be a button '''Manage Identities...''' at the bottom. Click it.

In the new screen, there will be one existing identity already: the default identity corresponding with your normal e-mail address. We want to add a new identity, so click the '''Add...''' button. In the screen that pops up, fill in the name and e-mail address you wish to use. At the bottom, make sure you choose the SMTP server of your KULid. This is shown in the image below.

[[File:Thunderbird-Identity.png]]

If you're adding an identity for a group alias, you may also want to automatically send a copy of any replies or emails you're sending to the alias itself to make sure all others are aware of it. To do that, enable the BCC checkbox under the '''Copies & Folders''' tab. It should automatically contain the alias.

== Sending your first e-mail ==
When you compose a new e-mail, you can change the sender in the "From" field to the identity you just configured. If everything was installed correctly, Thunderbird will show you a pop-up to enter your KU Leuven password when you try to send the e-mail. In this pop-up, you can choose to save this password for later use.

[[Category:Mail]]

Add an alias in Hotmail/Outlook

2023-02-24T05:09:51Z

Bert:

{{notice|Adding an alias to Hotmail/Outlook is not advised|Hotmail/Outlook does not use a relevant SMTP server, for example the one of the KU Leuven, to send emails as an alias. This may cause recipients to automatically reject your email or mark it as spam. You can circumvent this issue by using Thunderbird or another email provider. Please refer to [[Using a forwarder as an alias]] for some potential alternatives.}}

{{notice|To use a forwarder as an alias, access to the KU Leuven SMTP server is required|Since 24 February 2023 not all students have access to this server by default any more. If you are unable to send emails after following our documentation, then you may want to register on https://ulyssis.org/smtp/ for SMTP access.}}

You may want to send e-mail from Outlook.com using your @ulyssis.org address, or another domain name that you use for your account. Outlook.com allows you to do this by configuring a few settings. Because you should only be able to send mails from an e-mail address you actually own, make sure that you configured receiving mails before starting this process. Outlook.com will send a confirmation mail to the provided e-mail address to confirm that you own it.

# In Outlook.com, click on your profile image.
# Click '''My Microsoft account''' (Dutch: '''Mijn Microsoft-account''').
# Go to the tab '''Your info''' (Dutch: '''Je gegevens''').
# Under '''Account info''' (Dutch: '''Rekeninggegevens''') click on: '''Sign-in preferences''' (Dutch: '''Aanmeldingsvoorkeuren''').
# You will have to log in again to proceed. Click '''Add email''' (Dutch: '''E-mailadres toevoegen''').
# Select '''Add an existing email address as a Microsoft account alias''' (Dutch: '''Een bestaand e-mailadres als een Microsoft-accountalias toevoegen''') and fill in the email address you want to send from.
# Click '''Add alias''' (Dutch: '''Alias toevoegen''').
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Outlook.com from this address:

# In Outlook.com, click '''New message''' (Dutch: '''Nieuw bericht''').
# Click on '''From''' (Dutch: '''Van''') and select the email address.

[[Category:Mail]]

Add an alias in Gmail

2023-02-24T05:09:45Z

Bert:

Using a forwarder as an alias

2023-02-24T05:09:32Z

Bert:

Using a forwarder as an alias

2023-02-24T05:09:04Z

Bert:

{{notice|To use a forwarder as an alias, access to the KU Leuven SMTP server is required. Since 24 February 2023 not all students have access to this server by default any more. If you are unable to send emails after following our documentation, then you may want to register on https://ulyssis.org/smtp/ for SMTP access.}}

If you have your own domain, it's very easy to use [[Forwarders]] to forward email from addresses under your own domain to other email addresses at external providers or your ULYSSIS mailbox. While you can always reply with the address of that external provider or the @ulyssis.org address of your mailbox, it's often preferred to also use the address of your own domain when replying to messages or starting conversations. In that case you will want to configure an alias for your forwarder.

While you are free to use whatever provider, email application or webmail application you prefer, we have step-by-step manuals available for some specific case. You can find them listed here:
* [[Add an alias in ULYSSIS webmail]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]

[[Category:Mail]]

Shibboleth

2022-10-08T23:24:03Z

Bert: /* How to request */

Shibboleth is the software powering the Central KU Leuven Login. It's a piece of software used by many universities to supply identification and access management.

ULYSSIS works together with ICTS to supply limited access to Shibboleth. We are however only able to supply Shibboleth to those approved by ICTS. In practice all faculty unions will be granted access if they can prove they have the technical ability to use Shibboleth in a safe and privacy friendly way. For other organisations it can be more difficult to get access, therefore it is best to write an extensive explenation of what you plan to do with Shibboleth, why your organisation requires it, what your organisation does, and other relevant information. We will then contact ICTS with your request.

== How to request ==
To request Shibboleth access, you first need to make sure the domain you wish to use Shibboleth on has valid SSL certificates. Lately ICTS has been pushing that all traffic to the website is already over HTTPS before Shibboleth is issued. For more info you can check [[Getting SSL]]

If you have SSL set up you need to send an email to request Shibboleth to ulyssis@ulyssis.org. The email must contain the following info:
* What domain you wish to use Shibboleth on (this must be a single domain, so keep subdomains and www in mind)
* What you will be using Shibboleth for and in general what your application will do. This explanation is required by ICTS. If you fail to convince them they will not grant your domain access.
* What attributes you wish to use and what you will do with them (and whether you will store them). You can find the list of attributes on https://admin.kuleuven.be/icts/services/aai/attributes
* Preconfigure .htaccess in the root folder of the (sub)domain you are requesting Shibboleth for. This is required for ULYSSIS to be able to export the required Shibboleth Metadata.
** ULYSSIS may view your .htaccess file to investigate any problems.
* If you are not a recognised faculty union you will need to include an extra motivation why you require Shibboleth (as noted above)

If your application is complete and correct we will file a formal request. We will of course notify you of ICTS' response.

== Deploying Shibboleth ==
After you have been granted access you can soon start using Shibboleth.

The first step is to add the following lines to your .htaccess
ShibDisable Off
AuthType Shibboleth
require shibboleth
ShibRequireSession off

We disable certain features of Shibboleth here because it will otherwise interfere with any other HTTP-auth options you might be using.

Now that you have added this information to .htaccess you are able to serve requests to Shibboleth.sso, if your request is well-formed the sso will handle communication with the IdP (identity provider) of the KU Leuven. A login link follows the following syntax:
https://[YOUR_HOSTNAME]/Shibboleth.sso/WAYF/kuleuven?target=[URLENCODED_RETURN_URL]
And logout links:
https://[YOUR_HOSTNAME]/Shibboleth.sso/Logout?return=[URLENCODED_DISPLAY_URL]
It is important to note that on logout the user will stay on the KU Leuven's IdP-page and your link will only be displayed. The user will NOT be redirected (even though this is the normale behaviour according to the Shibboleth documentation).

As soon as a user is logged in, their attributes will be available to your application. Attributes are certain properties that an account may have and that supply further information about them. Some examples are: first name, last name, mail, student id.
All of these will be available as environment variables. In PHP these are part of $_SERVER. Keep in mind that Apache might prefix the names of these variables with REDIRECT_ multiple times (for example when mod_rewrite is used). For an overview of all attributes you can check out http://shib.kuleuven.be/secure/allAttributes

More general information on the KU Leuvens implementation can be found on http://shib.kuleuven.be/.

[[Category:Webserver]]

Overview

2022-09-16T20:23:25Z

Bert: /* Webserver */

<div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;">
Welcome to our documentation website. Many of the common procedures and issues our users experience are described here. If you still encounter problems we haven't covered or you just can't seem to get things to work, even though you followed one of our manuals, feel free to contact us on ulyssis@ulyssis.org for personal support.</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">
== Account ==
* [[Registering a new account]]
* [[Renewing your account]]
* [[Transferring your account]]
* [[Resetting your password]]
* [[Reducing disk usage|Help, my account uses too much disk space]]
* [[Why do I have to pay 0.00 euro and how?]]
</div><div style="width:45%;float:left">
== Files ==
* [[Accessing your files]]
* [[Transferring files over SFTP]]
* [[Making Backups]]
* [[Secure file permissions]]
* [[Reducing disk usage]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Webserver ==
* [[Webserver changes summer 2022]]
* [[Using your webspace]]
* [[Using (Fast)CGI for non-PHP websites]]
* [[Getting Apache logs]]
* [[Managing PHP errors]]
* [[Setting PHP options]]
* [[Sending email from websites]]
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]
* [[Claiming a port]]
* [[ULYSSIS security measures]]
</div><div style="width:45%;float:left">

== Mail ==
* [[Introduction to ULYSSIS email]]
* [[Mailbox]]
* [[Mailbox in Thunderbird]]
* [[Forwarders]]
* [[Using a forwarder as an alias]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in ULYSSIS webmail]]
* [[Fetch your KU Leuven email into another email address]]
* [[Spam]]
* [[ULYSSIS security measures]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== CMSs ==
* [[Software Version Checker]]
* [[Setting up WordPress]]
* [[Setting up Drupal]]
* [[Setting up Joomla]]
* [[Setting up MediaWiki]]
* [[Updating WordPress]]
* [[Updating MediaWiki]]
</div><div style="width:45%;float:left">

== Security & anti-spam ==
* [[Secure file permissions]]
* [[Software Version Checker]]
* [[Preventing spam on Wordpress]]
* [[Preventing spam on Joomla]]
* [[Preventing spam on Drupal]]
* [[Preventing spam on MediaWiki]]
* [[Securing MediaWiki using Centrale KU Leuven Login]]
* [[ULYSSIS security measures]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Databases ==
* [[Using PostgreSQL]]
* [[Using MySQL]]
* [[Using PHPMyAdmin]]
* [[Using PHPPgAdmin]]
* [[Using Adminer]]
* [[Making Backups]]

</div><div style="width:45%;float:left">

== Shell ==
* [[Accessing your files]]
* [[Transferring files over SFTP]]
* [[Accessing shell servers over SSH]]
* [[ULYSSIS public IRC]]
* [[Useful Linux Commands]]
* [[Managing Cron jobs]]
* [[Claiming a port]]
* [[Installing packages]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Versioning ==
* [[GitLab]]
</div><div style="width:45%;float:left">

== ULYSSIS Public Services ==
* [[ULYSSIS public IRC]]
</div>
<div style="clear:both;"></div>

<div>
<div style="width:45%;float:left;padding-right:10px;">
== Tutorials ==
* [[Using the kulemt package]]
* [[Exporting your KU Leuven class schedule and calendar]]
</div>
<div style="clear:both;"></div>
</div>

__NOTOC__

Why can't you make and/or fix my website for me?

2022-08-30T14:07:47Z

Bert:

ULYSSIS is a non-profit student organisation with usually between 15 and 20 members. These members, most are students but some might have recently transitioned to a job or PhD, maintain our server hardware, make sure all the systems of our hosting run, answer support tickets, check security, organise events such as the [https://ctf.ulyssis.org ULYSSIS CTF] and [https://opensourcejobfair.be Open Source Job Fair], co-organise the [http://24urenloop.be 24 hour run], organise several [https://ulyssis.org/category/workshops/ workshops] a year, give technical advice and support to LOKO, and develop internal an external software tools such as [https://stemt.org Stemt.org].

As you can imagine, it's often already too large a task to do so many different things with such a small group of members. Even after automating as many of our tasks as possible, our team finds it challenging to take on long term projects such as replacing dated components of our hosting infrastructure, because we spend so much time answering support tickets. As you can imagine, hosting around 50 organisations and over 150 websites for students, staff and organisations at KU Leuven, means that it would be highly unrealistic if our members had to frequently intervene in existing websites or create complete new ones.

We understand that it's a difficult task to create a new website and that maintenance can at times be challenging too. We also understand that your situation is very unique to your organisation or circumstances. We think however that it would be unfair if we would help some and not others. We therefore make lots of documentation available on this website, we give advice and help to look for solutions in support tickets, and we attempt to steer people towards easier maintenance.

Specifically, we are convinced that WordPress offers the most user friendly way to create a website while retaining as much creative freedom as possible. Our manual page [[Setting up WordPress]] details how to install WordPress in a few easy steps and includes screenshots to show you what to do. Installing is a one time thing, so once your website exists you will never need to do it again. What you will have to do more frequently is update WordPress and any themes and plugins you may use. Luckily, this can all be achieved by the press of a button. On our documentation page about [[Updating WordPress]] we explain how you can enable automatic updates for all components of your WordPress website. That way, you will usually never have to do any maintenance at all.

For advice on how to build or maintain your website, you can of course always contact [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org] with specific questions or situations.

Why can't you make and/or fix my website for me?

2022-08-30T14:07:14Z

Bert:

ULYSSIS is a non-profit student organisation with usually between 15 and 20 members. These members, most are students but some might have recently transitioned to a job or PhD, maintain our server hardware, make sure all the systems of our hosting run, answer support tickets, check security, organise events such as the [https://ctf.ulyssis.org ULYSSIS CTF] and [https://opensourcejobfair.be Open Source Job Fair], co-organise the [http://24urenloop.be 24 hour run], organise several [https://ulyssis.org/category/workshops/ workshops] a year, give technical advice and support to LOKO, and develop internal an external software tools such as [https://stemt.org Stemt.org].

As you can imagine, it's often already too large a task to do so many different things with such a small group of members. Even after automating as many of our tasks as possible, our team finds it challenging to take on long term projects such as replacing dated components of our hosting infrastructure, because we spend so much time answering support tickets. As you can imagine, hosting around 50 organisations and over 150 websites for students, staff and organisations at KU Leuven, means that it would be highly unrealistic if our members had to frequently intervene in existing websites or create complete new ones.

We understand that it's a difficult task to create a new website and that maintenance can at times be challenging too. We also understand that your situation is very unique to your organisation or circumstances. We think however that it would be unfair if we would help some and not others. We therefore make lots of documentation available on this website, we give advice and help to look for solutions in support tickets, and we attempt to steer people towards easier maintenance.

Specifically, we are convinced that WordPress offers the most user friendly way to create a website while retaining as much creative freedom as possible. Our manual page [[Setting up WordPress]] details how to install WordPress in a few easy steps and includes screenshots to show you what to do. Installing is a one time thing, so once your website exists you will never need to do it again. What you will have to do is update WordPress and any themes and plugins you may use. Luckily, this can all be achieved by the press of a button. On our documentation page about [[Updating WordPress]] we explain how you can enable automatic updates for all components of your WordPress website. That way, you will usually never have to do any maintenance at all.

For advice on how to build or maintain your website, you can of course always contact [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org] with specific questions or situations.

Why can't you make and/or fix my website for me?

2022-08-30T14:06:54Z

Bert:

ULYSSIS is a non-profit student organisation with usually between 15 and 20 members. These members, most are students but some might have recently transitioned to a job or PhD, maintain our server hardware, make sure all the systems of our hosting run, answer support tickets, check security, organise events such as the [https://ctf.ulyssis.org ULYSSIS CTF] and [https://opensourcejobfair.be Open Source Job Fair], co-organise the [http://24urenloop.be 24 hour run], organise several [https://ulyssis.org/category/workshops/ workshops] a year, give technical advice and support to LOKO, and develop internal an external software tools such as [https://stemt.org Stemt.org].

As you can imagine, it's often already too large a task to do so many different things with such a small group of members. Even after automating as many of our tasks as possible, our team finds it challenging to take on long term projects such as replacing dated components of our hosting infrastructure, because we spend so much time answering support tickets. As you can imagine, hosting around 50 organisations and over 150 websites for students, staff and organisations at KU Leuven, means that it would be highly unrealistic if our members had to frequently intervene in existing websites or create complete new ones.

We understand that it's a difficult task to create a new website and that maintenance can at times be challenging too. We also understand that your situation is very unique to your organisation or circumstances. We think however that it would be unfair if we would help some and not others. We therefore make lots of documentation available on this website, we give advice and help to look for solutions in support tickets, and we attempt to steer people towards easier maintenance.

Specifically, we are convinced that WordPress offers the most user friendly way to create a website while retaining as much creative freedom as possible. Our manual page [[Setting up WordPress]] details how the install WordPress in a few easy steps and includes screenshots to show you what to do. Installing is a one time thing, so once your website exists you will never need to do it again. What you will have to do is update WordPress and any themes and plugins you may use. Luckily, this can all be achieved by the press of a button. On our documentation page about [[Updating WordPress]] we explain how you can enable automatic updates for all components of your WordPress website. That way, you will usually never have to do any maintenance at all.

For advice on how to build or maintain your website, you can of course always contact [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org] with specific questions or situations.

Why can't you make and/or fix my website for me?

2022-08-30T14:05:25Z

Bert:

ULYSSIS is a non-profit student organisation with usually between 15 and 20 members. These members, most are students but some might have recently transitioned to a job or PhD, maintain our server hardware, make sure all the systems of our hosting run, answer support tickets, check security, organise events such as the [https://ctf.ulyssis.org ULYSSIS CTF] and [https://opensourcejobfair.be Open Source Job Fair], co-organise the [http://24urenloop.be 24 hour run], organise several [https://ulyssis.org/category/workshops/ workshops] a year, give technical advice and support to LOKO, and develop internal an external software tools such as [https://stemt.org Stemt.org].

As you can imagine, it's often already too large a task to do so many different things with such a small group of members. Even after automating as many of our tasks as possible, our team finds it challenging to take on long term projects such as replacing dated components of our hosting infrastructure, because we spend so much time answering support tickets. As you can imagine, hosting around 50 organisations and over 150 websites for students, staff and organisations at KU Leuven, means that it would be highly unrealistic if our members had to frequently intervene in existing websites or create complete new ones.

We understand that it's a difficult task to create a new website and that maintenance can at times be challenging too. We also understand that your situation is very unique to your organisation or circumstances. We think however that it would be unfair if we would help some and not others. We therefore make lots of documentation available on this website, we give advice and help to look for solutions in support tickets, and we attempt to steer people towards easier maintenance.

Specifically, we are convinced that WordPress offers the most user friendly way to create a website while retaining as much creative freedom as possible. Our manual [[Setting up WordPress]] details how the install WordPress in a few easy steps and includes screenshots to show you what to do. Installing is a one time thing, so once your website exists you will never need to do it again. What you will have to do is update WordPress and any themes and plugins you may use. Luckily, this can all be achieved by the press of a button. On our documentation page about [[Updating WordPress]] we explain how you can enable automatic updates for all components of your WordPress website. That way, you will usually never have to do any maintenance at all.

For advice on how to build or maintain your website, you can of course always contact [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org] with specific questions or situations.

Why can't you make and/or fix my website for me?

2022-08-30T13:50:14Z

Bert:

ULYSSIS is a non-profit student organisation with usually between 15 and 20 members. These members, most are students but some might have recently transitioned to a job or PhD, maintain our server hardware, make sure all the systems of our hosting run, answer support tickets, check security, organise events such as the [https://ctf.ulyssis.org ULYSSIS CTF] and [https://opensourcejobfair.be Open Source Job Fair], co-organise the [http://24urenloop.be 24 hour run], organise several [https://ulyssis.org/category/workshops/ workshops] a year, give technical advice and support to LOKO, and develop internal an external software tools such as [https://stemt.org Stemt.org].

As you can imagine, it's often already too large a task to do so many different things with such a small group of members. Even after automating as many of the tasks we have to do as possible, our team finds it challenging to take on long term projects such as replacing dated components of our hosting infrastructure, because we spend so much time answering support tickets. As you can imagine, hosting around 50 organisations and over 150 websites for students, staff and organisations at KU Leuven, means that it would be highly unrealistic if our members had to frequently intervene in existing websites or create complete new ones.

We understand that it's a difficult task to create a new website and that maintenance can at times be challenging too. We also understand that your situation is very unique to your organisation or circumstances. We think however that it would be unfair if we would help some and not others. We therefore make lots of documentation available on this website, we give advice and help to look for solutions in support tickets, and we attempt to steer people towards easier maintenance.

Specifically, we are convinced that WordPress offers the most user friendly way to create a website while retaining as much creative freedom as possible. Our manual [[Setting up WordPress]] details how the install WordPress in a few easy steps and includes screenshots to show you what to do. Installing is a one time thing, so once your website exists you will never need to do it again. What you will have to do is update WordPress and any themes and plugins you may use. Luckily, this can all be achieved by the press of a button. On our documentation page about [[Updating WordPress]] we explain how you can enable automatic updates for all components of your WordPress website. That way, you will usually never have to do any maintenance at all.

For advice on how to build or maintain your website, you can of course always contact [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org] with specific questions or situations.

Why can't you make and/or fix my website for me?

2022-08-30T13:49:35Z

Bert: Created page with "ULYSSIS is a non-profit student organisation with usually between 15 and 20 members. These members, most are students but some might have recently transitioned to a job or PhD..."

ULYSSIS is a non-profit student organisation with usually between 15 and 20 members. These members, most are students but some might have recently transitioned to a job or PhD, maintain our server hardware, make sure all the systems of our hosting run, answer support tickets, check security, organise events such as the [https://ctf.ulyssis.org ULYSSIS CTF] and [https://opensourcejobfair.be Open Source Job Fair], co-organise the [http://24urenloop.be 24 hour run], organise several [https://ulyssis.org/category/workshops/ workshops] a year, give technical advice and support to LOKO, and develop internal an external software tools such as [https://stemt.org Stemt.org].

As you can imagine, it's often already too large a task to do so many different things with such a small group of members. Even after automating as many of the tasks we have to do as possible, our team finds it challenging to take on long term projects such as replacing dated components of our hosting infrastructure, because we spend so much time answering support tickets. As you can imagine, hosting around 50 organisations and over 150 websites for students, staff and organisations at KU Leuven, means that it would be highly unrealistic if our members had to frequently intervene in existing websites or create complete new ones.

We understand that it's a difficult task to create a new website and that maintenance can at times be challenging too. We also understand that your situation is very unique to your organisation or circumstances. We think however that it would be unfair if we would help some and not others. We therefore make lots of documentation available on this website, we give advice and help to look for solutions in support tickets, and we attempt to steer people towards easier maintenance.

Specifically, we are convinced that WordPress offers the most user friendly way to create a website while retaining as much creative freedom as possible. Our manual [[Setting up WordPress]] details how the install WordPress in a few easy steps and includes screenshots to show you what to do. Installing is a one time thing, so once your website exists you will never need to do it again. What you will have to do is update WordPress and any themes and plugins you may use. Luckily, this can all be achieved by the press of a button. On our documentation page about [[Updating WordPress]] we explain how you can enable automatic updates for all components of your WordPress website. That way, you will usually never have to do any maintenance at all.

For advice on how to build or maintain your website, you can of course always contact [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org].

Add an alias in Hotmail/Outlook

2022-08-14T23:49:21Z

Bert:

{{notice|Adding an alias to Hotmail/Outlook is not advised|Hotmail/Outlook does not use a relevant SMTP server, for example the one of the KU Leuven, to send emails as an alias. This may cause recipients to automatically reject your email or mark it as spam. You can circumvent this issue by using Thunderbird or another email provider. Please refer to [[Using a forwarder as an alias]] for some potential alternatives.}}

You may want to send e-mail from Outlook.com using your @ulyssis.org address, or another domain name that you use for your account. Outlook.com allows you to do this by configuring a few settings. Because you should only be able to send mails from an e-mail address you actually own, make sure that you configured receiving mails before starting this process. Outlook.com will send a confirmation mail to the provided e-mail address to confirm that you own it.

# In Outlook.com, click on your profile image.
# Click '''My Microsoft account''' (Dutch: '''Mijn Microsoft-account''').
# Go to the tab '''Your info''' (Dutch: '''Je gegevens''').
# Under '''Account info''' (Dutch: '''Rekeninggegevens''') click on: '''Sign-in preferences''' (Dutch: '''Aanmeldingsvoorkeuren''').
# You will have to log in again to proceed. Click '''Add email''' (Dutch: '''E-mailadres toevoegen''').
# Select '''Add an existing email address as a Microsoft account alias''' (Dutch: '''Een bestaand e-mailadres als een Microsoft-accountalias toevoegen''') and fill in the email address you want to send from.
# Click '''Add alias''' (Dutch: '''Alias toevoegen''').
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Outlook.com from this address:

# In Outlook.com, click '''New message''' (Dutch: '''Nieuw bericht''').
# Click on '''From''' (Dutch: '''Van''') and select the email address.

[[Category:Mail]]

Add an alias in Hotmail/Outlook

2022-08-14T23:47:35Z

Bert:

{{notice|Adding an alias to Hotmail/Outlook is not advised|Hotmail/Outlook does not use a relevant SMTP server, for example the one of the KU Leuven, to send emails as an alias. This may cause recipients to automatically reject your email or mark it as spam.}}

You may want to send e-mail from Outlook.com using your @ulyssis.org address, or another domain name that you use for your account. Outlook.com allows you to do this by configuring a few settings. Because you should only be able to send mails from an e-mail address you actually own, make sure that you configured receiving mails before starting this process. Outlook.com will send a confirmation mail to the provided e-mail address to confirm that you own it.

# In Outlook.com, click on your profile image.
# Click '''My Microsoft account''' (Dutch: '''Mijn Microsoft-account''').
# Go to the tab '''Your info''' (Dutch: '''Je gegevens''').
# Under '''Account info''' (Dutch: '''Rekeninggegevens''') click on: '''Sign-in preferences''' (Dutch: '''Aanmeldingsvoorkeuren''').
# You will have to log in again to proceed. Click '''Add email''' (Dutch: '''E-mailadres toevoegen''').
# Select '''Add an existing email address as a Microsoft account alias''' (Dutch: '''Een bestaand e-mailadres als een Microsoft-accountalias toevoegen''') and fill in the email address you want to send from.
# Click '''Add alias''' (Dutch: '''Alias toevoegen''').
# Confirm your request using the link or code, you just received via an email on the address you provided.

You can now send emails in Outlook.com from this address:

# In Outlook.com, click '''New message''' (Dutch: '''Nieuw bericht''').
# Click on '''From''' (Dutch: '''Van''') and select the email address.

[[Category:Mail]]

Overview

2022-08-14T23:31:25Z

Bert: /* Mail */

<div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;">
Welcome to our documentation website. Many of the common procedures and issues our users experience are described here. If you still encounter problems we haven't covered or you just can't seem to get things to work, even though you followed one of our manuals, feel free to contact us on ulyssis@ulyssis.org for personal support.</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">
== Account ==
* [[Registering a new account]]
* [[Renewing your account]]
* [[Transferring your account]]
* [[Resetting your password]]
* [[Reducing disk usage|Help, my account uses too much disk space]]
* [[Why do I have to pay 0.00 euro and how?]]
</div><div style="width:45%;float:left">
== Files ==
* [[Accessing your files]]
* [[Transferring files over SFTP]]
* [[Making Backups]]
* [[Secure file permissions]]
* [[Reducing disk usage]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Webserver ==
* [[Webserver changes summer 2020]]
* [[Using your webspace]]
* [[Using (Fast)CGI for non-PHP websites]]
* [[Getting Apache logs]]
* [[Managing PHP errors]]
* [[Setting PHP options]]
* [[Sending email from websites]]
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]
* [[Claiming a port]]
* [[ULYSSIS security measures]]
</div><div style="width:45%;float:left">

== Mail ==
* [[Introduction to ULYSSIS email]]
* [[Mailbox]]
* [[Mailbox in Thunderbird]]
* [[Forwarders]]
* [[Using a forwarder as an alias]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]
* [[Add an alias in Thunderbird]]
* [[Add an alias in ULYSSIS webmail]]
* [[Fetch your KU Leuven email into another email address]]
* [[Spam]]
* [[ULYSSIS security measures]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== CMSs ==
* [[Software Version Checker]]
* [[Setting up WordPress]]
* [[Setting up Drupal]]
* [[Setting up Joomla]]
* [[Setting up MediaWiki]]
* [[Updating WordPress]]
* [[Updating MediaWiki]]
</div><div style="width:45%;float:left">

== Security & anti-spam ==
* [[Secure file permissions]]
* [[Software Version Checker]]
* [[Preventing spam on Wordpress]]
* [[Preventing spam on Joomla]]
* [[Preventing spam on Drupal]]
* [[Preventing spam on MediaWiki]]
* [[Securing MediaWiki using Centrale KU Leuven Login]]
* [[ULYSSIS security measures]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Databases ==
* [[Using PostgreSQL]]
* [[Using MySQL]]
* [[Using PHPMyAdmin]]
* [[Using PHPPgAdmin]]
* [[Using Adminer]]
* [[Making Backups]]

</div><div style="width:45%;float:left">

== Shell ==
* [[Accessing your files]]
* [[Transferring files over SFTP]]
* [[Accessing shell servers over SSH]]
* [[ULYSSIS public IRC]]
* [[Useful Linux Commands]]
* [[Managing Cron jobs]]
* [[Claiming a port]]
* [[Installing packages]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Versioning ==
* [[GitLab]]
</div><div style="width:45%;float:left">

== ULYSSIS Public Services ==
* [[ULYSSIS public IRC]]
</div>
<div style="clear:both;"></div>

<div>
<div style="width:45%;float:left;padding-right:10px;">
== Tutorials ==
* [[Using the kulemt package]]
* [[Exporting your KU Leuven class schedule and calendar]]
</div>
<div style="clear:both;"></div>
</div>

__NOTOC__

Add an alias in ULYSSIS webmail

2022-08-14T23:25:49Z

Bert:

By default you can already use your @ulyssis.org email address to send emails using our webmail, but you may also want to send email from another domain name that you use for your account. You can simply configure this using the steps below.

# Login into the [https://webmail.ulyssis.org webinterface] using your ULYSSIS account name and passsword
# Go to '''Settings''' (dutch: '''Instellingen''') in the top right
# Go to '''Identities''' (dutch: '''Identiteiten''')
# Click on the plus sign in the bottom left
# Fill the alias you want to use in in the '''Email''' (dutch: '''E-mail''') field and the name you want to be displayed in front of the address in the '''Display Name''' (dutch: '''Weergavenaam''') field. All the other fields are optional.
# Click on '''Save''' (dutch: '''Opslaan''')

You can now select the alias when composing an email in the webinterface.

[[Category:Mail]]

Overview

2022-08-14T23:18:13Z

Bert: /* Mail */

<div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;">
Welcome to our documentation website. Many of the common procedures and issues our users experience are described here. If you still encounter problems we haven't covered or you just can't seem to get things to work, even though you followed one of our manuals, feel free to contact us on ulyssis@ulyssis.org for personal support.</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">
== Account ==
* [[Registering a new account]]
* [[Renewing your account]]
* [[Transferring your account]]
* [[Resetting your password]]
* [[Reducing disk usage|Help, my account uses too much disk space]]
* [[Why do I have to pay 0.00 euro and how?]]
</div><div style="width:45%;float:left">
== Files ==
* [[Accessing your files]]
* [[Transferring files over SFTP]]
* [[Making Backups]]
* [[Secure file permissions]]
* [[Reducing disk usage]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Webserver ==
* [[Webserver changes summer 2020]]
* [[Using your webspace]]
* [[Using (Fast)CGI for non-PHP websites]]
* [[Getting Apache logs]]
* [[Managing PHP errors]]
* [[Setting PHP options]]
* [[Sending email from websites]]
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]
* [[Claiming a port]]
* [[ULYSSIS security measures]]
</div><div style="width:45%;float:left">

== Mail ==
* [[Introduction to ULYSSIS email]]
* [[Mailbox]]
* [[Mailbox in Thunderbird]]
* [[Forwarders]]
* [[Using a forwarder as an alias]]
* [[Add an alias in Gmail]]
* [[Add an alias in Hotmail/Outlook]]
* [[Add an alias in Thunderbird]]
* [[Add_an_alias_in_ULYSSIS_webmail]]
* [[Fetch your KU Leuven email into another email address]]
* [[Spam]]
* [[ULYSSIS security measures]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== CMSs ==
* [[Software Version Checker]]
* [[Setting up WordPress]]
* [[Setting up Drupal]]
* [[Setting up Joomla]]
* [[Setting up MediaWiki]]
* [[Updating WordPress]]
* [[Updating MediaWiki]]
</div><div style="width:45%;float:left">

== Security & anti-spam ==
* [[Secure file permissions]]
* [[Software Version Checker]]
* [[Preventing spam on Wordpress]]
* [[Preventing spam on Joomla]]
* [[Preventing spam on Drupal]]
* [[Preventing spam on MediaWiki]]
* [[Securing MediaWiki using Centrale KU Leuven Login]]
* [[ULYSSIS security measures]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Databases ==
* [[Using PostgreSQL]]
* [[Using MySQL]]
* [[Using PHPMyAdmin]]
* [[Using PHPPgAdmin]]
* [[Using Adminer]]
* [[Making Backups]]

</div><div style="width:45%;float:left">

== Shell ==
* [[Accessing your files]]
* [[Transferring files over SFTP]]
* [[Accessing shell servers over SSH]]
* [[ULYSSIS public IRC]]
* [[Useful Linux Commands]]
* [[Managing Cron jobs]]
* [[Claiming a port]]
* [[Installing packages]]
</div>
<div style="clear:both;"></div>
</div>

<div>
<div style="width:45%;float:left;padding-right:10px;">

== Versioning ==
* [[GitLab]]
</div><div style="width:45%;float:left">

== ULYSSIS Public Services ==
* [[ULYSSIS public IRC]]
</div>
<div style="clear:both;"></div>

<div>
<div style="width:45%;float:left;padding-right:10px;">
== Tutorials ==
* [[Using the kulemt package]]
* [[Exporting your KU Leuven class schedule and calendar]]
</div>
<div style="clear:both;"></div>
</div>

__NOTOC__