https://docs.ulyssis.org/api.php?action=feedcontributions&user=Vincenttc&feedformat=atomULYSSIS documentation - User contributions [en]2024-03-29T00:09:46ZUser contributionsMediaWiki 1.39.6https://docs.ulyssis.org/index.php?title=Exporting_your_KU_Leuven_class_schedule_and_calendar&diff=1831Exporting your KU Leuven class schedule and calendar2023-11-28T20:20:58Z<p>Vincenttc: </p>
<hr />
<div>This guide will explain how your KU Leuven calendar and class schedule, which you can see on Toledo and kuloket, can be made more accessible even outside of Toledo. The procedure can be done by synchronizing the KU Leuven calendar with your personal agenda (e.g. Google Calendar, Thunderbird, Outlook, Windows Calendar, etc.), following the steps below.<br />
<br />
=== Synchronizing your class schedule to your KU Leuven calendar ===<br />
Your first step will be to visit KU Loket via Toledo or by visiting [http://kuloket.be kuloket.be] . Using the tabs on top of this page, go to '''Agenda''' and select '''Agenda Sync''' below, as shown in the picture in image 1.<br />
<br />
Now you will get an overview of your different agendas. Here you will need to select which one you wish to export. Next you will be presented a window with settings. The settings can be changed to your personal liking, but are not necessary to be edited for synchronizing your agenda so they will not be discussed further here.<br />
<br />
The only necessary step here is to make sure our '''synchronisation is on'''. We can check this at the top of the page. If the synchronisation is off, simply select restart sync at the top right. It's possible you will need to '''wait about 15 minutes''', to make sure KU Loket saved all the settings correctly. It should look as shown in image 2.<br />
<br />
<gallery mode=packed heights="160px"><br />
File:Agenda Sync.png|Image 1 - Where to find Agenda Sync<br />
File:Agenda Synchronisation on.png|Image 2 - Synchronisation status<br />
</gallery><br />
<br />
=== Importing your KU Leuven calendar into Thunderbird/Google Calendar/Outlook/... ===<br />
<br />
First, '''visit your personal student email'''. This can be done via Toledo or by visiting [https://owa.student.kuleuven.be owa.student.kuleuven.be]. This should bring you to your personal KU Leuven mailbox. On the left side of the page, you should see several icons (Mail, Calendar, People). Here you will need to '''select''' '''<nowiki/>'Calendar'''' (Image 3), which should bring you to a page with an overview of the KU Leuven calendar (future tasks and courses that are put on Toledo by your professors, should also be shown here now).<br />
If the calendar is still completely empty, make sure they're selected within 'My Calendars' on the left of your calendar overview. If it doesn't show up in this list, check if your agenda settings in KU Loket are set correctly according to image 2 and that you are looking at time period where classes are scheduled (not a holiday period).<br />
<br />
Continuing in the top right corner of the page, below the menu bar, there should be 2 buttons (share, print), as shown in the screenshot. You will need to select the '''share''' button. This will open a dropdown where you can select which agenda you would like to share (Image 4) (In this case we want to select UURROOSTER).<br />
<br />
Next you'll be shown a 'Sharing and permissions' window. In here simply enter a personal (non-KU Leuven) email address. When you have filled in the address, make sure 'Can view all details' is selected from the dropdown menu (this should be done by default).<br />
<br />
Now you will need to check the mailbox of the email address you entered before. Normally you should have received an email. In this email you want to copy the '''iCal link below the button 'Accept and view calendar'''' (see Image 5). Importing the iCal link to your chosen personal agenda can vary widely depending on which personal agenda you are using. We list a few links here on how to import iCal into the agenda for the most common services: <br />
<br />
* ''Google Calendar:'' https://support.google.com/calendar/answer/37648?hl=en<br />
* ''Outlook Calendar:'' https://www.howtogeek.com/661142/how-to-add-an-icalendar-link-to-your-outlook-calendar/<br />
* ''Thunderbird:'' https://support.mozilla.org/en-US/questions/1105153<br />
<br />
Almost all calendar services support importing iCal. If your chosen calendar service is not listed here, you can try searching the internet on how to import iCal for your service.<br />
<br />
<gallery mode=packed heights="160px" class="center"><br />
File:Agenda in Outlook.png|Image 3 - Calendar<br />
File:Select Agenda.png|Image 4 - Sharing your agenda<br />
File:ICal link in Outlook sharing-mail.png|Image 5 - iCal link in Outlook sharing-mail<br />
</gallery><br />
<br />
[[Category:Tutorials]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Exporting_your_KU_Leuven_class_schedule_and_calendar&diff=1830Exporting your KU Leuven class schedule and calendar2023-11-28T20:03:09Z<p>Vincenttc: Uitleg voor iCal link krijgen als ge geen MS account hebt</p>
<hr />
<div>This guide will explain how your KU Leuven calendar and class schedule, which you can see on Toledo and kuloket, can be made more accessible even outside of Toledo. The procedure can be done by synchronizing the KU Leuven calendar with your personal agenda (e.g. Google Calendar, Thunderbird, Outlook, Windows Calendar, etc.), following the steps below.<br />
<br />
=== Synchronizing your class schedule to your KU Leuven calendar ===<br />
[[File:Agenda Sync.png|thumb|235x235px|Image 1 - Where to find Agenda Sync]]<br />
Your first step will be to visit KU Loket via Toledo or by visiting [http://kuloket.be kuloket.be] . Using the tabs on top of this page, go to '''Agenda''' and select '''Agenda Sync''' below, as shown in the picture in image 1.<br />
<br />
Now you will get an overview of your different agendas. Here you will need to select which one you wish to export. Next you will be presented a window with settings. The settings can be changed to your personal liking, but are not necessary to be edited for synchronizing your agenda so they will not be discussed further here.<br />
[[File:Agenda Synchronisation on.png|thumb|268x268px|Image 2 - Synchronisation status|alt=]]<br />
<br />
<br />
<br />
The only necessary step here is to make sure our '''synchronisation is on'''. We can check this at the top of the page. If the synchronisation is off, simply select restart sync at the top right. It's possible you will need to '''wait about 15 minutes''', to make sure KU Loket saved all the settings correctly. It should look as shown in image 2.<br />
<br />
=== Importing your KU Leuven calendar into Thunderbird/Google Calendar/Outlook/... ===<br />
[[File:Agenda in Outlook.png|thumb|209x209px|Image 3 - Calendar]]<br />
<br />
First, '''visit your personal student email'''. This can be done via Toledo or by visiting [https://owa.student.kuleuven.be owa.student.kuleuven.be]. This should bring you to your personal KU Leuven mailbox. On the left side of the page, you should see several icons (Mail, Calendar, People). Here you will need to '''select''' '''<nowiki/>'Calendar'''' (Image 3), which should bring you to a page with an overview of the KU Leuven calendar (future tasks and courses that are put on Toledo by your professors, should also be shown here now).<br />
If the calendar is still completely empty, make sure they're selected within 'My Calendars' on the left of your calendar overview. If it doesn't show up in this list, check if your agenda settings in KU Loket are set correctly according to image 2 and that you are looking at time period where classes are scheduled (not a holiday period).<br />
'''<nowiki/>'''[[File:Select Agenda.png|thumb|216x216px|Image 4 - Sharing your agenda]]<br />
Continuing in the top right corner of the page, below the menu bar, there should be 2 buttons (share, print), as shown in the screenshot. You will need to select the '''share''' button. This will open a dropdown where you can select which agenda you would like to share (Image 4) (In this case we want to select UURROOSTER).<br />
<br />
Next you'll be shown a 'Sharing and permissions' window. In here simply enter a personal (non-KU Leuven) email address. When you have filled in the address, make sure 'Can view all details' is selected from the dropdown menu (this should be done by default).<br />
<br />
Now you will need to check the mailbox of the email address you entered before. Normally you should have received an email. In this email you want to copy the '''iCal link below the button 'Accept and view calendar'''' (see Image 5). Importing the iCal link to your chosen personal agenda can vary widely depending on which personal agenda you are using. We list a few links here on how to import iCal into the agenda for the most common services: <br />
[[File:ICal link in Outlook sharing-mail.png|alt=|thumb|261x261px|Image 5 - iCal link in Outlook sharing-mail]]<br />
* ''Google Calendar:'' https://support.google.com/calendar/answer/37648?hl=en<br />
* ''Outlook Calendar:'' https://www.howtogeek.com/661142/how-to-add-an-icalendar-link-to-your-outlook-calendar/<br />
* ''Thunderbird:'' https://support.mozilla.org/en-US/questions/1105153<br />
<br />
Almost all calendar services support importing iCal. If your chosen calendar service is not listed here, you can try searching the internet on how to import iCal for your service.<br />
<br />
[[Category:Tutorials]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=File:ICal_link_in_Outlook_sharing-mail.png&diff=1829File:ICal link in Outlook sharing-mail.png2023-11-28T20:02:26Z<p>Vincenttc: </p>
<hr />
<div>iCal link in Outlook sharing-mail</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1818Overview2023-04-04T20:12:29Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Reducing disk usage|Help, my account uses too much disk space]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
* [[Reducing disk usage]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2022]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Mailbox in Thunderbird]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Add an alias in ULYSSIS webmail]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
* [[Updating WordPress]]<br />
* [[Updating MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[Exporting your KU Leuven class schedule and calendar]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Using_your_webspace&diff=1791Using your webspace2023-02-15T21:57:07Z<p>Vincenttc: Outdated informatie over file permissions weggehaald</p>
<hr />
<div>= Location of your files =<br />
<br />
All the files you want to provide via the web browser must reside in a directory named "www" in your homefolder. Within that folder you can organise your data in sub directories. For more information about accessing your files is available [https://docs.ulyssis.org/Accessing_your_files here].<br />
<br />
= Accessing your website =<br />
<br />
Your webspace is accessible on following url's (with username your username):<br />
<br />
* http://username.studentenweb.org<br />
* http://username.ulyssis.be<br />
<br />
If you have a domainname like yourname.be, you can link it with our webserver. For more information on this subject, see the [https://docs.ulyssis.org/Adding_domain_names domainnames documentation].<br />
<br />
= Troubleshooting =<br />
<br />
I keep getting an "HTTP Error 403: permission denied" when accessing my website. Check that all permissions on the files and folders relevant to your website are set properly. See [[Secure file permissions]] for more information.<br />
[[Category:Webserver]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Mailbox_in_Thunderbird&diff=1664Mailbox in Thunderbird2021-12-04T18:34:48Z<p>Vincenttc: </p>
<hr />
<div>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]]. <br />
<br />
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. <br />
==Thunderbird==<br />
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.<br />
<br />
==Adding a ULYSSIS mailbox to Thunderbird==<br />
If this is the first mailbox being added to Thunderbird, the following pop-up should come up:<br />
[[File:First Open TB.png|left|alt=|thumb|432x432px]]<br />
<br />
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:<br />
[[File:New Mailbox.png|left|alt=|thumb|600x600px]]<br />
<br />
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>):<br />
[[File:Fill in email.png|left|alt=|thumb|432x432px]]<br />
<br />
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:<br />
[[File:Click Configure Manually.png|left|alt=|thumb|479x479px]]<br />
<br />
Now, fill in the information as follows:<br />
<br />
[[File:Fill advanced.png|left|alt=|thumb|479x479px]]<br />
{| class="wikitable"<br />
|+ Manual settings<br />
|-<br />
|| || INCOMING || OUTGOING<br />
|-<br />
|| Protocol: || IMAP || SMTP<br />
|-<br />
|| Server: || mail.ulyssis.org || smtps.kuleuven.be<br />
|-<br />
|| Port: || 993 || 443<br />
|-<br />
|| SSL: || SSL/TLS || SSL/TLS<br />
|-<br />
| style="padding-right: 10px" | Authentication: <br />
|| Autodetect <br />
|| Autodetect<br />
|-<br />
|| Username: <br />
| style="padding-right: 10px" | ULYSSIS username <br />
|| r/m/s/u number<br />
|-<br />
| colspan="3" |<br />
<br />
<br />
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.<br />
|}<br />
<br />
<br />
<br />
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:<br />
<br />
[[File:After Clicking Retest GOOD.png|left|alt=|thumb|479x479px]]<br />
<br />
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.<br />
<br />
[[File:After Clicking GetMessages.png|left|alt=|thumb|600x600px]]<br />
<br />
<br />
{{notice|Use your KU Leuven login for the outgoing (SMTP) mailserver|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.}}<br />
<br />
[[Category:Mail]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Accessing_shell_servers_over_SSH&diff=1533Accessing shell servers over SSH2021-08-18T21:41:58Z<p>Vincenttc: </p>
<hr />
<div>This documentation article is aimed at more advanced users who want to use the command line to administer files or perform other actions on their ULYSSIS account. If you prefer to upload, download, move and delete files on your account using a graphical user interface, then please refer to [[Accessing your files]].<br />
<br />
==Connecting==<br />
Users can access ULYSSIS services through two shell servers: <code>ssh1.ulyssis.org</code> and <code>ssh2.ulyssis.org</code>. Both of them run Linux (the latest Ubuntu LTS). You can run commands on these servers or use them to access the files on your ULYSSIS account. These servers can only be accessed through SSH or SFTP (see [[Accessing your files]] for the latter). For SSH access, use the following details:<br />
<br />
* Server: "ssh1.ulyssis.org" or "ssh2.ulyssis.org"<br />
* Port: 22<br />
* Username: your ULYSSIS account username, the one you use for [https://ucc.ulyssis.org ucc.ulyssis.org]<br />
* Password: your ULYSSIS account password<br />
<br />
===Connecting on Linux===<br />
<br />
On Linux, you can just open a terminal and connect to the servers by using one of the following commands (with <code>username</code> your ULYSSIS username) followed by your password (once prompted):<br />
<br />
ssh username@ssh1.ulyssis.org<br />
ssh username@ssh2.ulyssis.org<br />
<br />
By doing this, the terminal will now act as a terminal on the remote server. To disconnect, type <code>logout</code>, <code>exit</code> or use Ctrl+D.<br />
<br />
To copy and paste inside a terminal window, you usually have to use Ctrl+Shift+C and Ctrl+Shift+V, but this may depend on your choice of terminal and its settings.<br />
<br />
===Connecting on macOS===<br />
<br />
On Mac, you can use Terminal app. This application can be found in the Utilities folder within your Application folder. You can also use Spotlight to find it.<br />
<br />
You can now connect to the servers by using one of the following commands (with <code>username</code> your username) followed by your password (once prompted):<br />
<br />
ssh username@ssh1.ulyssis.org<br />
ssh username@ssh2.ulyssis.org<br />
<br />
By doing this, the terminal will now act as a terminal on the remote server. To disconnect, type <code>logout</code>, <code>exit</code> or use ctrl+D.<br />
<br />
===Connecting on Windows===<br />
==== Windows 10 ====<br />
Windows has built-in SSH capabilities since the April 2018 update of Windows 10. Simply search and launch Powershell from your menu. <br />
<br />
You can now connect to the servers by using one of the following commands (with <code>username</code> your username) followed by your password (once prompted):<br />
<br />
ssh username@ssh1.ulyssis.org<br />
ssh username@ssh2.ulyssis.org<br />
<br />
By doing this, the terminal will now act as a terminal on the remote server. To disconnect, type <code>logout</code>, <code>exit</code> or use ctrl+D.<br />
<br />
==== Older versions of Windows ====<br />
Older versions of Windows don't support native terminals, so you will have to download one first. An option that works on any version of Windows is [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty], which is completely free and doesn't require any installation. Just download it and run the .exe file. The parameters: <br />
*Host name: "ssh1.ulyssis.org" or "ssh2.ulyssis.org"<br />
*Protocol: SSH<br />
*Port: 22 (should be set automatically)<br />
You can save these options for later on. Next, you will be asked to give your password.<br />
<br />
Doing all this will open a terminal to the remote server which can be used the same way as a Linux terminal. To disconnect, type <code>logout</code>, <code>exit</code> or use Ctrl+D.<br />
<br />
To copy and paste in Putty, you have to right click. More information about Putty is available on https://the.earth.li/~sgtatham/putty/latest/htmldoc/.<br />
<br />
==Getting started==<br />
Once connected, you can start executing commands to manage your files or perform tasks. You can find a simple overview of basis commands on [[Useful Linux Commands]]. We also have several articles detailing commands for more specific tasks:<br />
*[[Managing Cron jobs]]<br />
*[[Reducing disk usage]]<br />
*[[ULYSSIS public IRC]]<br />
*[[Making Backups]]<br />
*[[Using (Fast)CGI for non-PHP websites]]<br />
*[[Fetch your KU Leuven email into another email address]]<br />
<br />
==Using rsync over SSH==<br />
Rsync is a well known utility to transfer and synchronise files across locations. You can use it to synchronise between two local folders, but it also supports synchronisation across an SSH connection. To for example sync the local folder <code>myproject</code> exactly to the <code>www/myproject</code> folder on your ULYSSIS account, you can use the following command:<br />
<pre>rsync -rLpvz --delete myproject/ username@ssh1.ulyssis.org:~/www/myproject</pre><br />
<br />
Refer to the rsync man page (using <code>man rsync</code>) for more details about the many options of rsync, including the use of -L, -p and --delete in the example above.<br />
<br />
[[Category:Shell]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=ULYSSIS_public_IRC&diff=1527ULYSSIS public IRC2021-08-14T10:31:32Z<p>Vincenttc: </p>
<hr />
<div>ULYSSIS hosts its own IRC network. IRC stands for Internet Relay Chat, [https://en.wikipedia.org/wiki/Internet_Relay_Chat IRC on wikipedia]. It is a chat protocol that mainly focuses on group chat, but also allows for private chat.<br />
<br />
For any support questions, you are free to contact us via email on ulyssis@ulyssis.org, but if your questions are of a less sensitive nature and could benefit from a back-and-forth, it could be useful to contact us on IRC. Do keep in mind that you may have to wait until someone notices your question, which may take a while. If you don't have a question and just want to hang out in our chat, feel free to join!<br />
<br />
Keep in mind that our IRC network has been a social space for several generations, so you will find alumni and students from different walks of life there, not just ULYSSIS members and users.<br />
<br />
==Web IRC client==<br />
If you won't regularly use our IRC or if you just want to check it out, you can use our web IRC client. You can find it at [https://webirc.ulyssis.org/ webirc.ulyssis.org]. Remember to leave your web IRC browser tab open while you wait for a response.<br />
<br />
==IRC network details==<br />
<br />
Below are specific instructions for some clients, but if you are already familiar with IRC, here are the details you need to connect to our server. We highly recommend using SSL.<br />
<br />
Server: irc.ulyssis.org<br />
Port: 6668 (SSL)<br />
Channel: #ulyssis<br />
<br />
If <code>irc.ulyssis.org</code> is down, you can also try the other server in the same network, hosted at <code>irc2.ulyssis.org</code>. Both are connected to each other and you can use them interchangeably. It is advised to add it as a fallback in your IRC client.<br />
<br />
==IRC clients==<br />
To use IRC, you'll need an IRC client. We advise the terminal based [https://irssi.org/ irssi] or [https://weechat.org/ weechat] for Linux and [https://hexchat.github.io/ hexchat] or [https://www.mirc.com/ mIRC] for Windows, but there are a lot of other free options.<br />
<br />
You can only receive messages over IRC while you're connected. Therefore, we advise you to run irssi or weechat in either a screen or a tmux session. With a ULYSSIS account, you can run screen or tmux on our shellservers, as they keep running 24/7 you can use them to keep track of your conversations.<br />
Screen and tmux are similar programs. Screen has been around for longer and is more tested, while tmux is more modern with new features and being easier to use for beginners.<br />
<br />
===Using irssi on our shell servers===<br />
====Connect to the shellserver====<br />
Use the ssh command in your Linux or OS X terminal, or use PuTTY to connect on windows.<br />
Extensive information on how to do so can be found on [[Accessing shell servers over SSH]].<br />
<br />
====Start irssi in a screen====<br />
*When on the shellserver, enter <code>screen -U</code> to start a screen session, or <code>tmux</code> to start a tmux session.<br />
*Enter <code>irssi</code> to start irssi<br />
*Connect to the IRC server: <code>/server -ssl irc.ulyssis.org 6668</code><br />
*Connect to the public channel: <code>/join #ulyssis</code><br />
<br />
====Screen usage====<br />
*To exit the screen: press Ctrl-A and press D ('detach') to return to the shellserver.<br />
*To reconnect: enter <code>screen -r</code> or <code>screen -DR</code> (the latter will create a new screen if it wasn't already made).<br />
<br />
====Tmux usage====<br />
*To exit the tmux session: press Ctrl-B and press D ('detach') to return to the shellserver.<br />
*To reconnect: enter <code>tmux attach</code><br />
<br />
====Help, I can't reconnect to my session!====<br />
*Check if you are on the right shell server and didn't make a typing error.<br />
*If everything is correct, your screen may have been stopped by a crash or a reboot of our shellserver. You can check the [http://status.ulyssis.org status] section of our website for more information about possible downtimes.<br />
*Make sure you use the right program (<code>screen</code> if you started a screen session and <code>tmux</code> if you started a tmux session)<br />
<br />
==Using ZNC==<br />
Alternatively, if you don't like using terminal-based clients, or just want to run your client locally, you can connect with our [https://znc.ulyssis.org/ ZNC server]. However, to use it, you'll need a ULYSSIS account. ZNC connects to our IRC server in your place (fill in the details at the beginning of this article). You can then connect to ZNC with a client of your choice, and it will send you the history you've missed while you were offline.<br />
<br />
Log in to our ZNC server. In your settings, create a new network. Fill in the basic details (server name, nickname, set <code>BindHost</code> to <code>0.0.0.0</code>). In the server field, fill in <code>irc.ulyssis.org +6668</code>. Add <code>#ulyssis</code> as a channel. You may want to increase the buffer count. Then save at the bottom of the page.<br />
<br />
In your IRC client, connect to the server <code>znc.ulyssis.org</code> on port 6666 (with SSL) and set <code>username/network:password</code> as password to the server. Replace <code>username</code> with your ULYSSIS username, <code>network</code> with the name of the network in your znc settings, and <code>password</code> with your ULYSSIS password.<br />
<br />
==Using Bitlbee==<br />
<br />
With [https://www.bitlbee.org/main.php/news.r.html Bitlbee], you can connect to other services as if they were an IRC server. It is available at <code>bitlbee.ulyssis.org</code> on ports 7000 and 7001 (SSL). For documentation on how to use Bitlbee, we refer to the manual on its website. This service is only reachable from within the ULYSSIS and KU Leuven networks.<br />
<br />
[[Category:Shell]]<br />
[[Category:ULYSSIS Public Services]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Updating_MediaWiki&diff=1526Updating MediaWiki2021-08-13T14:00:38Z<p>Vincenttc: </p>
<hr />
<div>The MediaWiki project provides an official [https://www.mediawiki.org/wiki/Manual:Upgrading wiki page] which explains the procedure to update a wiki. Unfortunately, their instructions are complex, and the page contains a lot of information that is outdated or irrelevant for our users. To make it easier for our users to update, this documentation page aims to be more accessible and easier to understand. However, this page is not an authoritative source on the subject. If the instructions on this page are unclear at any point, you should always refer back to the official instructions.<br />
<br />
{{info|In this guide, we assume you are familiar with the files on your ULYSSIS account. If you don't know how to access these files, please read [[Accessing your files]] first.}}<br />
<br />
== Downloading the right version ==<br />
To start updating MediaWiki, you will need to download the archive file of the version you want to update to. If you did not receive an email from our [[Software Version Checker]], follow the instructions in the next subsection. Otherwise, you can skip to the subsection [[#Downloading the right version using the Software Version Checker | Downloading the right version using the Software Version Checker]].<br />
<br />
=== Downloading the right version based on your wiki ===<br />
You can find your current MediaWiki version by going to the <code>Special:Version</code> page on your wiki (simply paste this in the search box) and looking for the "MediaWiki" version under "Installed software". For example, for this wiki, you can find the current version at [[Special:Version]]. At the time of writing, it looks like this:<br />
<br />
[[File:Installed software.png|center|frame]]<br />
<br />
A table of all recent MediaWiki versions can be found on [https://en.wikipedia.org/wiki/MediaWiki_version_history wikipedia]. Currently supported versions are indicated by a green or yellow color in the first column. To determine which version you want to download, follow these steps:<br />
* If the ''branch'' of your version ('''the first two numbers''', like <code>1.xx</code>) is currently supported (green or yellow), you should choose the latest version for this branch. For example, for version 1.35.3, the branch is 1.35.<br />
* If this branch is not supported anymore, you should choose the most recent LTS branch. This is indicated by '''(LTS)''' in the second column. '''Make sure this LTS branch is not older than your current branch!'''<br />
* If the most recent LTS branch is older than your current branch, you should choose the newest supported branch (green).<br />
<br />
Now, click on the link of the branch you want to download. This will redirect you to a page with information about this version. The first paragraph on this page contains a link to <code>mediawiki-1.xx.yy.tar.gz</code>. Download this archive and save it somewhere on your computer.<br />
<br />
=== Downloading the right version using the Software Version Checker ===<br />
The email you received will contain a link to the correct MediaWiki version. This link looks something like:<br />
https://releases.wikimedia.org/mediawiki/1.xx/mediawiki-core-1.xx.yy.tar.gz<br />
<br />
Simply click this link to download the archive and save it somewhere on your computer.<br />
<br />
== Renaming the old installation ==<br />
An important step in the update process is to rename the old installation directory. This way, you can simply copy your data from the old installation directory to the new installation directory during the update. Additionally, you can easily restore your old wiki if something goes wrong.<br />
<br />
The easiest way to do this, is to '''rename''' your wiki location (the directory containing your <code>LocalSettings.php</code> configuration file) to a new directory. If you don't know how to access your files on your ULYSSIS account, refer to [[Accessing your files]] for easy instructions. For example, if <code>LocalSettings.php</code> is stored in <code>www/wiki</code>, you should '''rename''' the wiki folder to <code>wiki_old</code>.<br />
<br />
== Installing the new files ==<br />
Now, you will need to upload the <code>mediawiki-1.xx.yy.tar.gz</code> file you downloaded in step 1 next to the old installation directory. For example, if your old installation directory is located in <code>www/wiki_old</code>, upload <code>mediawiki-1.xx.yy.tar.gz</code> to <code>www/</code>.<br />
<br />
After uploading, you can extract the archive file on the server by using the Cyberduck "Expand Archive" feature. Simply right click the archive and click "Expand Archive".<br />
<br />
[[File:Cyberduck expand.png|thumb|center]]<br />
<br />
This will create a directory named <code>mediawiki-1.xx.yy</code>. Rename this directory to the original name of your wiki directory on your ULYSSIS account. For example, if the original name was <code>wiki</code>, rename this directory from <code>mediawiki-1.xx.yy</code> to <code>wiki</code>. This can be done using Cyberduck by right clicking the directory and clicking "Rename".<br />
<br />
[[File:Cyberduck rename.png|thumb|center]]<br />
<br />
Finally, you need to copy certain other other files and directories from the '''old''' directory to the '''new''' directory. The easiest way to do this using Cyberduck is by creating a "New Browser". Right click the '''new''' directory, and click "New Browser".<br />
<br />
[[File:Cyberduck new browser.png|thumb|center]]<br />
<br />
Then, you can simply place both windows next to each other, and drag-and-drop files or directories to copy them from the '''old''' directory to the '''new''' directory. For example, copying <code>LocalSettings.php</code>:<br />
<br />
[[File:Cyberduck drag and drop.png|center|750px]]<br />
<br />
Although the exact files you need to copy are different depending on your wiki, here are some suggestions from the [https://www.mediawiki.org/wiki/Manual:Upgrading#Other_files official instructions]:<br />
* <code>LocalSettings.php</code>, which contains your old configuration settings.<br />
* The <code>images/</code> directory, containing the uploaded files to the wiki.<br />
* Custom extensions from within the <code>extensions/</code> directory. Be careful not to overwrite the default extensions that are bundled with the new MediaWiki version.<br />
* Custom skins from within the <code>skins/</code> directory. Be careful not to overwrite the default skins that are bundled with the new MediaWiki version.<br />
* Any <code>.htaccess</code> file, if present. '''Make sure you can view hidden files'''; to enable this for Cyberduck, you can look at [[Accessing_your_files#Viewing_hidden_files|Accessing your files]].<br />
<br />
== Updating extensions ==<br />
If you use any extensions that are not bundled with MediaWiki by default, you should update them too. A list of bundled extensions can be found at https://www.mediawiki.org/wiki/Bundled_extensions_and_skins, these extensions will be updated automatically. However, for example, you might have the ULYSSIS extensions [[Securing MediaWiki using Centrale KU Leuven Login|MediaWikiShibboleth]] or [https://github.com/ULYSSIS-KUL/CompressUploads CompressUploads] installed. As with MediaWiki itself, you can find the versions of your installed extensions on the <code>Special:Version</code> page, under "Installed extensions". Extensions will often link to a website where you can download the latest versions. For example, for this wiki, you can find the installed extensions at [[Special:Version]]. At the time of writing, it looks like this: <br />
<br />
[[File:Installed extensions.png|center|frame]]<br />
<br />
Because the update instructions are different for each extension, you will have to refer to the update instructions of the extension you want to update. However, most extensions follow the same template as the MediaWiki upgrade itself:<br />
* Downloading the latest version: make sure to download the correct update for your new MediaWiki version.<br />
* Making a backup of the extension: you should already have a backup in the directory you created in step 2.<br />
* Extracting the archive files: similar to the MediaWiki tar.gz archive files, you might have to copy the new extension files to a directory in the new <code>extension/</code> directory.<br />
<br />
== Finalizing the update ==<br />
The final step in the update process is to update the database structure of your wiki. Your MediaWiki installation contains a script, called <code>update.php</code>, to perform the necessary database upgrades. This script can be executed using the Cyberduck "Send Command" feature.<br />
<br />
[[File:Cyberduck send command.png|thumb|center]]<br />
<br />
Enter the following command in the pop-up box:<br />
<br />
php <wiki installation location>/maintenance/update.php<br />
<br />
For example, if your wiki is located at <code>www/wiki</code>, the command should be as follows:<br />
<br />
[[File:Cyberduck update.png|center|750px]]<br />
<br />
After pressing "Send", the command will be executed on the server. If everything went well, you should see a lot of output, ending with something like:<br />
<br />
[[File:Cyberduck update output.png|center|750px]]<br />
<br />
However, if you did encounter any errors while executing the script, you could try taking a look at the [https://www.mediawiki.org/wiki/Manual:Upgrading#Command_line_2 official instructions]. If this does not resolve your problems, feel free to send us an email. We will try to assist you in completing the update.<br />
<br />
Congratulations! You successfully updated MediaWiki. Still, there are two more important steps you must perform:<br />
* Test your new MediaWiki installation: make sure all basic functionality (viewing, editing pages, file upload) works and all your extensions function properly.<br />
* Delete the old installation: you should remove the previously created <code>www/wiki_old</code> directory, using the command line or through a GUI. A simple GUI explanation can be found on [[Accessing_your_files#Creating_and_Deleting_files_and_folders|Accessing your files]].</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Accessing_your_files&diff=1466Accessing your files2021-07-21T19:04:33Z<p>Vincenttc: </p>
<hr />
<div>This documentation article will explain how to to upload, download, move and delete files on your account using a graphical user interface. If you are a more advanced user, you may want to use the command line to administer your files, in that case [[Accessing shell servers over SSH]] is probably a more relevant documentation page for you.<br />
<br />
Many different SFTP clients are available depending on your needs and what operating system you run on your computer. For Windows and Mac users, we recommend the graphical SFTP client [https://cyberduck.io/download/ Cyberduck]. If you're using Linux, your file manager usually has a built-in option to connect using the details mentioned in [[#Connecting | Connecting]].<br />
<br />
==Connecting==<br />
<br />
{{notice|Keep in mind|Our automatic security systems may temporarily prevent you from connecting over SSH/SFTP if you try to connect several times with the wrong username and/or password. This will result in the connection being refused. You can switch between sftp://ssh1.ulyssis.org and sftp://ssh2.ulyssis.org when this happens or wait 10 minutes. More information on our security measures is available on [[ULYSSIS security measures]]}}<br />
<br />
A Cyderduck-specific explanation can be found at [[#Connecting_2 | Cyberduck: Connecting]]. To access your files using another program you will have to enter the following connection details:<br />
* Protocol: SFTP<br />
* Server: "ssh1.ulyssis.org" or "ssh2.ulyssis.org"<br />
* Port: 22<br />
* Username: your ULYSSIS account username, the one you use for [https://ucc.ulyssis.org ucc.ulyssis.org]<br />
* Password: your ULYSSIS account password<br />
<br />
On our servers, your files are stored in your home folder located at <code>/home/(group)/(username)/</code>, where the group depends upon your account type and the username is your ULYSSIS account username. Any regular user is stored within the <code>user</code> group, and their files are stored within <code>/home/user/(username)</code>. For organizations, <code>org</code> is used, so files are stored within <code>/home/org/(username)</code>. Most (S)FTP clients will by default display your own home folder after you've logged in.<br />
<br />
==Using Cyberduck==<br />
To get started, download [https://cyberduck.io/download/ Cyberduck] from the official website. You can then install the downloaded file like you would install any other application. Once installed, launch Cyberduck and connect using the steps below.<br />
<br />
=== Connecting ===<br />
<ul><br />
<li>Click on Open Connection in the top-left corner.</li><br />
<li>Protocol (upper dropdown menu): "SFTP (SSH File Transfer Protocol)"</li><br />
<li>Username: your ULYSSIS account username, the one you use for [https://ucc.ulyssis.org ucc.ulyssis.org]</li><br />
<li>Password: your ULYSSIS account password</li><br />
<li>Server: "ssh1.ulyssis.org" or "ssh2.ulyssis.org"<br />
<li>Enable "Save Password" if you don't want to enter your password every time you want to connect using this computer</li><br />
<li>Press connect</li><br />
</ul>[[File:Open-connection-WB.png|alt=|left|frame]]<br />
<br />
If you get a dialog window about an unknown fingerprint, tick the "Always" box in the bottom left and then click allow. You will now be connected and able to access your files.<br />
[[File:Fingerprint dialog window.png|none|alt=|frame]]<br />
<br />
When you connect to a server using Cyberduck, the remote files will appear:<br />
[[File:Cyberduck connection interface.png|none|alt=|frame]]<br />
<br />
===Navigating===<br />
You can open a folder by double-clicking it. To go back up one step you can press the "Up" button to the right of the "Current Folder" dropdown.<br />
To go back up multiple steps you can click on the "Current Folder" dropdown and select which folder you would like to go back to.[[File:Navigating-WB.png|none|alt=|frame]]<br />
<br />
===Viewing hidden files===<br />
To make hidden files, whose filename always start with a '.', visible, click on View -> Show Hidden Files. This is necessary because some files like ".htaccess" and ".user.ini" are hidden by default and they need to be edited sometimes.<br />
[[File:Hidden Files.png|none|thumb]]<br />
<br />
===Uploading files and folders===<br />
To upload a file or folder, you can use the "Upload" button in the top menu bar and select the file or folder you wish to upload using your file manager.<br />
[[File:Cyberduck-upload-button.png|alt=|frame|left]]<br />
<br />
Or you can drag and drop it from your file manager (Explorer for Windows, Finder for Mac) into the current folder in Cyberduck.<br />
[[File:Upload-drag-WB.png|none|alt=|thumb|514x514px]]<br />
<br />
===Downloading files and folders===<br />
To download files and folders, you can drag and drop it into your file manager (Explorer for Windows or Finder for Mac), just like uploading but in the other direction. For files specifically it's also possible to simply double-click the file. This will then download it to your Downloads folder.<br />
<br />
===Creating and Deleting files and folders===<br />
To create a folder, you right click where you want your folder to be located and then click the "New Folder" option as seen below. You can then type a name for your new folder.<br />
<br />
To create a file, you right click in the folder where you want your file to be located and then click the "New File" option as seen below. You can then type a name for your new file, making sure to include the necessary extension (e.g. file.txt for a text file, file.php for a PHP file, etc.).<br />
<br />
You can delete a file or folder by selecting it and then either pressing the "Delete" key on your keyboard, or right-clicking and selecting "Delete".<br />
[[File:Delete-cyberduck-WB.png|alt=|thumb|384x384px|none]]<br />
<br />
===Editing files===<br />
Cyberduck allows you to edit files remotely by selecting a file and then pressing the "Edit" button in the top menu bar, next to the "Upload" button. This opens the file in your text editor (by default Notepad for Windows and TextEdit for Mac). After you're done editing, make sure to save the file using the text editor and then close it.<br />
[[File:Edit.png|none|alt=|frame]]<br />
<br />
[[Category:Files]]<br />
[[Category:Shell]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Forwarders&diff=1403Forwarders2021-05-30T22:10:03Z<p>Vincenttc: /* Change the forwarders for your @ulyssis.org email address */</p>
<hr />
<div>You may want to receive e-mail from ULYSSIS on another email provider. It is very easy to set this up.<br />
<br />
== Change the forwarders for your @ulyssis.org email address ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
# Under '''Address forward''' you can change the forward address of your ULYSSIS mail by clicking on '''edit'''.<br />
# Choose '''forward''' and enter the email address(es) you want to forward your ULYSSIS mail to and save the changes.<br />
# If you forward to Gmail, Hotmail. or use Thunderbird, we recommend looking at [[Using a forwarder as an alias]] so you can send mails under the forwarding address instead of just your own.<br />
If you want to forward emails received on your @ulyssis.org email address to other addresses as well as have them delivered in your [[mailbox]], you can add ''username''@ulyssis.org to the forwarders list. This will ensure that the email is delivered to your mailbox as if the destination was set to '''Inbox''', while emails are still forwarded to the other addresses.<br />
<br />
== Change the forwarders for other domains ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
<br />
[[File:Forwarder Step1.png|left|alt=|thumb|700px]]<br />
3. Under '''Virtual Domains''', click on the domain you want to change.<br />
[[File:Forwarder Step2.png|left|alt=|thumb|700px]]<br />
4. You can change a forwarder by clicking on '''edit''' or on '''Add alias''' and add the forwarders you want.<br />
[[File:Forwarder Step3.png|left|alt=|thumb|700px]]<br />
5. Save your changes<br />
<br />
[[Category:Mail]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Forwarders&diff=1402Forwarders2021-05-30T22:06:57Z<p>Vincenttc: /* Change the forwarders for your @ulyssis.org email address */</p>
<hr />
<div>You may want to receive e-mail from ULYSSIS on another email provider. It is very easy to set this up.<br />
<br />
== Change the forwarders for your @ulyssis.org email address ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
# Under '''Address forward''' you can change the forward address of your ULYSSIS mail by clicking on '''edit'''.<br />
# Choose '''forward''' and enter the email address(es) you want to forward your ULYSSIS mail to and save the changes.<br />
# If you forward to Gmail, Hotmail. or use Thunderbird, we recommend looking at [[Using a forwarder as an alias]] so you can send mails under the forwarding address instead of just your own.<br />
If you want to forward emails received on your @ulyssis.org email address to other addresses as well as have them be delivered in your [[mailbox]], you can add ''username''@ulyssis.org to the forwarders list. This will ensure that the email is delivered to your mailbox as if the destination was set to '''Inbox''' while still forwarding to the other addresses.<br />
<br />
== Change the forwarders for other domains ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
<br />
[[File:Forwarder Step1.png|left|alt=|thumb|700px]]<br />
3. Under '''Virtual Domains''', click on the domain you want to change.<br />
[[File:Forwarder Step2.png|left|alt=|thumb|700px]]<br />
4. You can change a forwarder by clicking on '''edit''' or on '''Add alias''' and add the forwarders you want.<br />
[[File:Forwarder Step3.png|left|alt=|thumb|700px]]<br />
5. Save your changes<br />
<br />
[[Category:Mail]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Forwarders&diff=1401Forwarders2021-05-30T21:58:20Z<p>Vincenttc: /* Use your mailbox and forwarders at the same time */</p>
<hr />
<div>You may want to receive e-mail from ULYSSIS on another email provider. It is very easy to set this up.<br />
<br />
== Change the forwarders for your @ulyssis.org email address ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
# Under '''Address forward''' you can change the forward address of your ULYSSIS mail by clicking on '''edit'''.<br />
# Choose '''forward''' and enter the email address you want to forward your ULYSSIS mail to and save the changes.<br />
# If you forward to Gmail, Hotmail. or use Thunderbird, we recommend looking at [[Using a forwarder as an alias]] so you can send mails under the forwarding address instead of just your own.<br />
<br />
== Change the forwarders for other domains ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
<br />
[[File:Forwarder Step1.png|left|alt=|thumb|700px]]<br />
3. Under '''Virtual Domains''', click on the domain you want to change.<br />
[[File:Forwarder Step2.png|left|alt=|thumb|700px]]<br />
4. You can change a forwarder by clicking on '''edit''' or on '''Add alias''' and add the forwarders you want.<br />
[[File:Forwarder Step3.png|left|alt=|thumb|700px]]<br />
5. Save your changes<br />
<br />
[[Category:Mail]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Forwarders&diff=1400Forwarders2021-05-30T21:49:08Z<p>Vincenttc: </p>
<hr />
<div>You may want to receive e-mail from ULYSSIS on another email provider. It is very easy to set this up.<br />
<br />
== Change the forwarders for your @ulyssis.org email address ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
# Under '''Address forward''' you can change the forward address of your ULYSSIS mail by clicking on '''edit'''.<br />
# Choose '''forward''' and enter the email address you want to forward your ULYSSIS mail to and save the changes.<br />
# If you forward to Gmail, Hotmail. or use Thunderbird, we recommend looking at [[Using a forwarder as an alias]] so you can send mails under the forwarding address instead of just your own.<br />
<br />
== Change the forwarders for other domains ==<br />
<br />
# Go to [https://ucc.ulyssis.org UCC] and log in with your username and password.<br />
# On the right side, click on '''Mail'''.<br />
<br />
[[File:Forwarder Step1.png|left|alt=|thumb|700px]]<br />
3. Under '''Virtual Domains''', click on the domain you want to change.<br />
[[File:Forwarder Step2.png|left|alt=|thumb|700px]]<br />
4. You can change a forwarder by clicking on '''edit''' or on '''Add alias''' and add the forwarders you want.<br />
[[File:Forwarder Step3.png|left|alt=|thumb|700px]]<br />
5. Save your changes<br />
<br />
== Use your mailbox and forwarders at the same time ==<br />
<br />
An alternative way to set the forwarders, that will also allow you to use your mailbox and the webinterface, is to use a .forward file. On each line of this file, you can specify to wich addresses you want to forward the email. If one of the addresses is the same as your @ulyssis address, then the mail will also be placed in your ULYSSIS mailbox. In the following example, your @ulyssis email address is <code>user@ulyssis.org</code>.<br />
<br />
Example .forward file:<br />
<br />
user@ulyssis.org<br />
example@gmail.com<br />
example2@skynet.be<br />
<br />
This will place the email in your ULYSSIS mailbox so that you can access it from the webinterface or your local mailclient. It will also forward the mail to <code>example@gmail.com</code> and <code>example2@skynet.be</code>.<br />
<br />
To use this, place a .forward file with the prefered email addresses in your homedir, see [[Accessing your files]], and set your forwarder to 'Inbox' in https://ucc.ulyssis.org/mail<br />
<br />
[[Category:Mail]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Adding_domain_names&diff=1331Adding domain names2021-04-26T19:08:28Z<p>Vincenttc: </p>
<hr />
<div>As described in [[Using your webspace|https://docs.ulyssis.org/Using_your_webspace]], you have your own ULYSSIS domain name that you can use.<br />
<br />
If you wish, you can also register another domain name. ULYSSIS isn't a domain name registrar, so<br />
you'll have to use an external registrar. For example, you can find a list of all registrars for<br />
.be at [http://dns.be dns.be].<br />
<br />
{{notice|Caution!|Please don't configure your domain to use ns4.ulyssis.student.kuleuven.be, not only will it not work, it may result in unpredictable behaviour.}}<br />
If you have registered your own domain and you want to use it with your ULYSSIS account, you need to:<br />
# Point your domain name to the following ULYSSIS nameservers:<br />
#* ns.ulyssis.student.kuleuven.be<br />
#* ns3.ulyssis.student.kuleuven.be<br />
#* Optionally: ns2.ulyssis.student.kuleuven.be<br />
# Mail us at ulyssis@ulyssis.org, with the following details:<br />
#* Your ULYSSIS username<br />
#* The domain name you registered<br />
#* The directory that you want the domain to point at. This could be your <code>www</code> folder, but any other folder within your home directory is possible.<br />
#* Whether you want to receive e-mail at that domain name via ULYSSIS. Note that we need to request this with ICTS, so this will take a while.<br />
<br />
Please do keep in mind that, just like any change to an account, this can only be requested by the account holder. <br />
<br />
You can find more information about DNS at http://en.wikipedia.org/wiki/Domain_Name_System.<br />
<br />
[[Category:Webserver]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Transferring_your_account&diff=1330Transferring your account2021-04-26T19:05:34Z<p>Vincenttc: </p>
<hr />
<div>You can transfer the account of your (faculty) organization to a new webmaster. The new webmaster must have a valid Central KU Leuven Login. Otherwise, the new webmaster will not be able to accept the account transfer.<br />
<br />
The instructions below must be executed by the current account owner.<br />
<br />
* Log in to [https://ucc.ulyssis.org/ UCC].<br />
* Click 'Transfer account' in the menu on the right.<br />
* Enter the details of the new account owner. Ensure the KU Leuven email address is entered correctly.<br />
<br />
The new webmaster will receive an email to confirm the transfer.<br />
<br />
[[Category:Account]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Transferring_files_over_SFTP&diff=1329Transferring files over SFTP2021-04-26T19:03:59Z<p>Vincenttc: </p>
<hr />
<div>ULYSSIS doesn't support ftp, because it is insecure. However, we support sftp (ftp over ssh).<br />
This works similar as ssh.<br />
<br />
On the server, your files are located in <code>/home/group/username/</code>. For a normal user with username <code>username/</code> this will be <code>/home/user/username/</code>, for an organisation with username <code>organisation/</code> this will be <code>/home/org/organisation/</code> etc.<br />
<br />
==Non-graphical methods==<br />
<br />
The most common way to transfer files is with a terminal by using the <code>scp</code> command.<br />
<br />
===Copying file to host:===<br />
scp SourceFile user@host:directory/TargetFile<br />
If you want to copy an '''empty''' folder, you have to add -r, for example:<br />
scp -r SourceFolder user@host:directory/TargetFolder<br />
<br />
===Copying file from host:===<br />
scp user@host:directory/SourceFile TargetFile<br />
If you want to copy an '''empty''' folder, you have to add -r, for example:<br />
scp -r user@host:directory/SourceFolder TargetFolder<br />
<br />
You don't need to use the full path to your file. You may you the relative path, starting from your home directory. For example:<br />
scp index.html user@ssh1.ulyssis.org:www/index.html<br />
<br />
You can find '''more info''' on the '''scp commands''' by using:<br />
man scp<br />
<br />
==Graphical methods==<br />
<br />
The graphical methods are explained in [[Accessing your files]].<br />
<br />
[[Category:Files]]<br />
[[Category:Shell]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Transferring_files_over_SFTP&diff=1328Transferring files over SFTP2021-04-26T19:03:29Z<p>Vincenttc: </p>
<hr />
<div>ULYSSIS doesn't support ftp, because it is insecure. However, we support sftp (ftp over ssh).<br />
This works similar as ssh.<br />
<br />
On the server, your files are located in <code>/home/group/username/</code>. For a normal user with username <code>username/</code> this will be <code>/home/user/username/</code>, for an organisation with username <code>organisation/</code> this will be <code>/home/org/organisation/</code> etc.<br />
<br />
=Non-graphical methods=<br />
<br />
The most common way to transfer files is with a terminal by using the <code>scp</code> command.<br />
<br />
==Copying file to host:==<br />
scp SourceFile user@host:directory/TargetFile<br />
If you want to copy an '''empty''' folder, you have to add -r, for example:<br />
scp -r SourceFolder user@host:directory/TargetFolder<br />
<br />
==Copying file from host:==<br />
scp user@host:directory/SourceFile TargetFile<br />
If you want to copy an '''empty''' folder, you have to add -r, for example:<br />
scp -r user@host:directory/SourceFolder TargetFolder<br />
<br />
You don't need to use the full path to your file. You may you the relative path, starting from your home directory. For example:<br />
scp index.html user@ssh1.ulyssis.org:www/index.html<br />
<br />
You can find '''more info''' on the '''scp commands''' by using:<br />
man scp<br />
<br />
=Graphical methods=<br />
<br />
The graphical methods are explained in [[Accessing your files]].<br />
<br />
[[Category:Files]]<br />
[[Category:Shell]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1327Overview2021-04-26T18:55:21Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Reducing disk usage|Help, my account uses too much disk space]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
* [[Reducing disk usage]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
* [[Updating WordPress]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=GitLab&diff=1326GitLab2021-04-26T18:53:35Z<p>Vincenttc: /* Guest users */</p>
<hr />
<div>If you want to use [http://git-scm.com/ git] for version control to work privately on personal projects, or collaborate with others on projects, you can use GitLab for central repositories, and for tracking bugs.<br />
<br />
== Accessing GitLab ==<br />
<br />
You can access our GitLab server at https://gitlab.ulyssis.org.<br />
<br />
You can log in with your standard ULYSSIS username and password.<br />
<br />
== Getting started with Git ==<br />
<br />
If you want to get acquainted with git, these are good free resources:<br />
<br />
* [https://try.github.io Try Git]: an interactive introduction to git<br />
* [http://git-scm.com/book Pro Git]: a book that you can read for free online<br />
* [http://git-scm.com/docs The official Git reference documentation]<br />
<br />
== Guest users ==<br />
<br />
If not everyone who works on your project has their own ULYSSIS account, you can request a Gitlab guest account via email. You simply send an email with the guest account's username (which will be prefixed with an underscore), full name, KU Leuven uid (m/s/r/u number) and email address to ulyssis@ulyssis.org and we will create it. Do keep in mind you bear full responsibility for all guests created for your account.<br />
<br />
[[Category:Versioning]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Add_an_alias_in_Thunderbird&diff=1325Add an alias in Thunderbird2021-04-26T18:18:43Z<p>Vincenttc: /* Adding the KU Leuven SMTP server in Thunderbird */</p>
<hr />
<div>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.<br />
<br />
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.<br />
<br />
== Adding the KU Leuven SMTP server in Thunderbird ==<br />
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.<br />
<br />
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.<br />
<br />
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 as in the example screenshot below. Replace the displayed user name with your own student number. You will have to fill in the corresponding password on first use.<br />
<br />
[[File:Thunderbird-SMTPS.png]]<br />
<br />
== Configure an identity for your e-mail account ==<br />
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.<br />
<br />
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 the name and e-mail address you wish to use. At the bottom, make sure you choose the SMTP server of your student account. This is shown in the image below.<br />
<br />
[[File:Thunderbird-Identity.png]]<br />
<br />
== Sending your first e-mail ==<br />
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.<br />
<br />
[[Category:Mail]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Updating_WordPress&diff=1291Updating WordPress2021-04-22T11:32:32Z<p>Vincenttc: /* Manually updating WordPress, plugins and themes */</p>
<hr />
<div>Maintaining the software of your website is crucial to ensure everything remains operational and secure. Making sure to perform updates on a regular basis is an important part of that. Beyond fixing security bugs, updates of WordPress as well as its plugins and themes, may introduce new useful features and ensures that no problems arise when we upgrade our servers every two years.<br />
<br />
While consistently applying updates has many benefits, the most important aspect for you as an account holder and ULYSSIS as the server maintainer is of course that the information on your website is safe and that your visitors can safely visit your website. We therefore advise that all users enable full updating automation within WordPress. This way, you no longer need to perform updates yourself, but the entire process will be automated. The instructions within this manual primarily go into how to fully automate the process, but you can also find instructions on manual updates. Do keep in mind that security issues, especially in popular plugins or WordPress itself, are often exploited by cybercriminals within a few days after the release of a fix. <br />
<br />
== Automatic updates ==<br />
To undergo the following steps, you log into WordPress' admin dashboard. This is also where you create and edit your pages. If you can't find an admin or login link on your website itself (often in the footer), you can simply add /wp-admin behind the main URL of your website. <br />
<br />
=== Automatic updates for WordPress ===<br />
* Go to '''Dashboard''' at the upper left of the screen and go to '''updates'''.<br />
* Toggle ''<nowiki/>'Enable automatic updates for all new versions of WordPress'''.<br />
[[File:Enable WordPress updates.png|frameless|500x500px|alt=|center]]<br />
<br />
=== Automatic updates for plugins ===<br />
* Navigate to '''Plugins''' in the left sidebar and select '''Installed plugins'''.<br />
* In the dropdown menu select '''Enable Auto-updates'''.<br />
* Check the boxes next to the plugins you want to update automatically.<br />
[[File:Auto updates for plugins.png|frameless]]<br />
* Press '''Apply''' next to the previously mentioned dropdown menu.<br />
<br />
=== Automatic updates for themes ===<br />
* Navigate to '''Appearance''' in the left sidebar and select '''Themes'''.<br />
* Click on the theme thumbnail and select ''<nowiki/>'Enable auto-updates'''. This must be done for each theme separately.<br />
[[File:Auto-update themes.png|center|frameless|781x781px]]<br />
<br />
== Manually updating WordPress, plugins and themes ==<br />
We still do not recommend updating manually as it is more time consuming and a bigger security risk. The following steps are only for updating plugins, but you can perform manual updates for themes and for WordPress itself in a similar way on the respective sections of the updates page.<br />
* Pending updates will be displayed as a notification in the left bar of the interface.<br />
[[File:Needed updates .png|frameless]]<br />
* Go to '''Dashboard''' at the upper left of the screen and go to '''updates'''.<br />
* All updates will be visible on this page. First check the boxes next to the plugins you want to update.<br />
* Now click the '''Update Plugins''' button.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Getting_SSL/TLS&diff=1284Getting SSL/TLS2021-04-20T13:12:23Z<p>Vincenttc: Reverted edits by Pcy (talk) to last revision by Bert</p>
<hr />
<div>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 is you are eligible for one, and we will also install certificates you have bought or obtained elsewhere.<br />
<br />
==Requesting SSL from the KU Leuven==<br />
<br />
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.<br />
<br />
Before sending us a request, the following steps have to be performed:<br />
* Set up the site that needs SSL if that's not already the case<br />
* Make sure our nameservers are being used for the involved domain(s), as explained on [[Adding domain names]]<br />
* Consider all subdomains (whether separate websites or not) you wish to have certificates for<br />
* 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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
{{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.}}<br />
<br />
==External certificates==<br />
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<br />
<br />
===Let's Encrypt===<br />
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.<br />
<br />
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:<br />
<br />
mkdir -p ~/letsencrypt/mydomain.be<br />
<br />
Certificates should be stored in these folders, according to the following file structure:<br />
<br />
letsencrypt/<br />
└── mydomain.be/<br />
├── mydomain.be.chain (the CA file)<br />
├── mydomain.be.crt (the cert file; "public key")<br />
└── mydomain.be.key (the key file; "private key")<br />
<br />
If you already possess the necessary files, renaming and copying them accordingly is sufficient. <br />
'''You still have to email us to install your certificate.''' More information in the last section on this page.<br />
<br />
Otherwise, you can generate or renew your certificates using acme.sh. This is explained in the next section.<br />
<br />
==== Generating certificates ====<br />
{{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><br />
RewriteRule "^.well-known/acme-challenge" - [L]<br />
</IfModule></pre>}}<br />
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.'''<br />
<br />
Firstly, execute the following commands to download the acme.sh script in your home directory and make it executable:<br />
<br />
curl -o ~/acme.sh https://raw.githubusercontent.com/acmesh-official/acme.sh/master/acme.sh<br />
chmod +x ~/acme.sh<br />
<br />
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).<br />
<br />
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!<br />
<br />
~/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<br />
<br />
The explanation of these many parameters is as follows:<br />
* <code>--issue</code> tells acme.sh to generate a new certificate.<br />
* <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.<br />
* <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.<br />
* <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.<br />
* <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.<br />
* <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.<br />
* <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.<br />
<br />
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.<br />
<br />
==== Renewing certificates ====<br />
To renew the certificates of <code>mydomain.be</code>, just execute:<br />
~/acme.sh --renew -d mydomain.be<br />
<br />
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>.<br />
<br />
If you are not sure which domain name to use, you can execute the command:<br />
~/acme.sh --list<br />
<br />
This will generate a list of available certificates, which looks a bit like this:<br />
Main_Domain KeyLength SAN_Domains CA Created Renew<br />
mydomain.be "" www.mydomain.be LetsEncrypt.org ... ...<br />
... ... ... ... ... ...<br />
<br />
In this example, the main domain is <code>mydomain.be</code>.<br />
<br />
The renewed certificates will automatically be copied to the files you provided in the command to generate the certificates (see previous section).<br />
<br />
'''After renewing the certificate, you have to email us to install your certificate.''' More information in the next section.<br />
<br />
==== Getting your certificates installed ====<br />
Check whether everything is stored correctly by executing the following command:<br />
ulyssis-certificate check mydomain.be<br />
<br />
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. <br />
<br />
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.<br />
<br />
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.<br />
<br />
[[Category:Webserver]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1246Overview2021-04-08T18:17:17Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Help, my account has been disabled]]<br />
* [[Reducing disk usage|Help, my account uses too much disk space]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
* [[Reducing disk usage]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1235Reducing disk usage2021-03-08T00:20:05Z<p>Vincenttc: </p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.[[File:Disk usage ncdu.png|thumb|760x760px]]<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.<br />
[[Category:Files]]<br />
__FORCETOC__<br />
[[Category:Account]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1234Overview2021-03-08T00:18:50Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Help, my account has been disabled]]<br />
* [[Reducing disk usage|Help, my account uses too much disk space]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
* [[Reducing disk usage]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
* [[ULYSSIS public FTP]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1232Overview2021-03-08T00:17:37Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Help, my account has been disabled]]<br />
* [[Help, my account uses too much disk space]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
* [[Reducing disk usage]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
* [[ULYSSIS public FTP]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1231Reducing disk usage2021-03-08T00:14:56Z<p>Vincenttc: </p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.[[File:Disk usage ncdu.png|thumb|760x760px]]<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.<br />
[[Category:Files]]<br />
__FORCETOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1230Reducing disk usage2021-03-08T00:13:47Z<p>Vincenttc: </p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.[[File:Disk usage ncdu.png|thumb|760x760px]]<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.<br />
[[Category:Files]]<br />
[[Category:Account|Help, my account uses to much disk space]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1229Reducing disk usage2021-03-08T00:10:59Z<p>Vincenttc: </p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.[[File:Disk usage ncdu.png|thumb|760x760px]]<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.<br />
[[Category:Files]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1228Overview2021-03-08T00:09:06Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Help, my account has been disabled]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
* [[Reducing disk usage]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
* [[ULYSSIS public FTP]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1227Reducing disk usage2021-03-08T00:02:21Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.[[File:Disk usage ncdu.png|thumb|760x760px]]<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1226Reducing disk usage2021-03-07T23:47:01Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* [[File:Disk usage ncdu.png|thumb]]You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=File:Disk_usage_ncdu.png&diff=1225File:Disk usage ncdu.png2021-03-07T23:45:49Z<p>Vincenttc: Vincenttc uploaded a new version of File:Disk usage ncdu.png</p>
<hr />
<div>Voorbeeld van ncdu met wat uitleg</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1224Reducing disk usage2021-03-07T23:44:39Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.[[File:Disk usage ncdu.png|thumb]]<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1223Reducing disk usage2021-03-07T23:44:22Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
[[File:Disk usage ncdu.png|thumb]]<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=File:Disk_usage_ncdu.png&diff=1222File:Disk usage ncdu.png2021-03-07T23:44:06Z<p>Vincenttc: </p>
<hr />
<div>Voorbeeld van ncdu met wat uitleg</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1221Reducing disk usage2021-03-07T16:53:47Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are using more disk space than the allowed quota for your account type for more than seven consecutive days (the so called grace period), you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails sent to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using too much disk space. In order to prevent impact on other users in cases where disk usage within an account suddenly and substantially surges, an additional quota slightly higher than your normal quota is imposed, independent of any grace period.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is taking up space on your account. Sadly, there are no dependable cross-platform tools to help with this. Instead, we will be using the command line tool ''ncdu'', which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, the step-by-step manual below will guide you through the process. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* Connect through SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once <code>ncdu</code> has finished scanning, it will display which files or folders located directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder. The results are ordered by size, so it makes most sense to start with the top items.<br />
* You can select different files/folders using the '''up and down arrow keys''', navigate the directory structure using either the '''enter and backspace''' keys or the '''left and right''' arrows to move in and out of folders, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota. The percentage and values displayed are always current and accurate, there is no delay.<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1219Reducing disk usage2021-03-07T15:48:04Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are user more disk space than your quota for more than seven consecutive days, you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails send to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using to much disk space. In order to prevent impact on other users during this seven day period, an additional quota slightly higher than your normal quota is imposed, independent of whether the grace period has passed or not.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is using up your disk space on your account. Sadly, there do not exist good cross-platform tools to help with this. Instead, we will be using the tool ''ncdu'' which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, a step-by-step guide can be found below. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once it has finished scanning it will show which files or folders directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder.<br />
* You select different files/folders using the '''up and down arrow keys''', navigate the directory structure using the '''enter and escape''' keys, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails (or emails in general): if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.<br />
* Unused images: in the case of many CMS's (WordPress, Drupal, ...), removing an image from a post will not delete it. For example, in the case of WordPress it will still be available through the [https://wordpress.com/support/media/deleting-files/ Media Library]. In order to reclaim the disk space used by the image, you will have to delete it there as well.<br />
* Large images: images are often several MBs in size and often have a large resolution. While this is great for editing, printing, ..., such large sizes are not all that useful for inclusion in a webpage. They can make your side load slower and use more disk space without a significant increase in quality. You should therefore consider resizing images before uploading them or installing a plugin that reduces their size on upload. However, do watch out for plugins that keep the original image around as this will not reduce but increase your disk usage. For a tutorial on how to resize images, you can take a look at https://wordpress.com/support/media/image-optimization/. This tutorial is geared towards WordPress, but is also applicable in general. If you are using MediaWiki, we have written a plugin that reduces the size of various type of files. You can find more details on [[Setting up MediaWiki#Extensions|Setting up MediaWiki - Extensions]].<br />
* Backups: ULYSSIS makes daily backups of all account data, including databases, and keeps them for at least a month. It is therefore not necessary to make automated backups of your own, for example with plugins like [https://nl.wordpress.org/plugins/updraftplus/ Updraft] in the case of WordPress. Although it is a good practice to make backups whenever you make changes to your site (for example, before performing updates), it is not necessary to keep them after you have verified that your site still works.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1218Reducing disk usage2021-03-07T14:53:05Z<p>Vincenttc: /* What happens when I go over my quota? */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are user more disk space than your quota for more than seven consecutive days, you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails send to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using to much disk space. In order to prevent impact on other users during this seven day period, an additional quota slightly higher than your normal quota is imposed, independent of whether the grace period has passed or not.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is using up your disk space on your account. Sadly, there do not exist good cross-platform tools to help with this. Instead, we will be using the tool ''ncdu'' which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, a step-by-step guide can be found below. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once it has finished scanning it will show which files or folders directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder.<br />
* You select different files/folders using the '''up and down arrow keys''', navigate the directory structure using the '''enter and escape''' keys, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails: if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1217Reducing disk usage2021-03-06T23:47:17Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are user more disk space than your quota for more than seven consecutive days, you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails send to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using to much disk space. In order to prevent impact on other users during this seven day period, an additional quota slightly higher than your normal quota is imposed, independent of whether the grace period has passed or not.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is using up your disk space on your account. Sadly, there do not exist good cross-platform tools to help with this. Instead, we will be using the tool '''ncdu''' which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool, a step-by-step guide can be found below. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once it has finished scanning it will show which files or folders directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder.<br />
* You select different files/folders using the '''up and down arrow keys''', navigate the directory structure using the '''enter and escape''' keys, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota<br />
<br />
=== Common sources of unnecessary disk usage ===<br />
<br />
* Deleted emails: if you have deleted a substantial amount of emails (or some emails with large attachments) and they still exist in the ''Trash'' folder of your ''@ulyssis.org'' email account, they might take op a large amount of disk space. In order to actually delete them you will gave to empty this ''Trash'' folder. You can do this on https://webmail.ulyssis.org or by deleting the folder ''Maildir/.Trash'' using ncdu (see previous section).<br />
* Old websites: if you have older websites on your account that you are no longer using, it might be worth removing them in their entirety. If the deleted website uses a database (this will always be the case if your using WordPress, MediaWiki or another popular CMS), then you can delete that as well through our control panel: https://ucc.ulyssis.org. If this website had an associated (sub)domain, please send us an email to have it removed.</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1216Reducing disk usage2021-03-06T23:28:04Z<p>Vincenttc: /* Identifying which files & folders use the most disk space */</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are user more disk space than your quota for more than seven consecutive days, you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails send to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using to much disk space. In order to prevent impact on other users during this seven day period, an additional quota slightly higher than your normal quota is imposed, independent of whether the grace period has passed or not.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is using up your disk space on your account. Sadly, there do not exist good cross-platform tools to help with this. Instead, we will be using the tool '''ncdu''' which runs directly on one of our shell servers. You do not need to be proficient with command line interfaces in order to use this tool. However, should you get stuck, do not hesitate to contact us at <code>ulyssis@ulyssis.org</code>. <br />
<br />
* SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once it has finished scanning it will show which files or folders directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder.<br />
* You select different files/folders using the '''up and down arrow keys''', navigate the directory structure using the '''enter and escape''' keys, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Reducing_disk_usage&diff=1215Reducing disk usage2021-03-06T23:22:42Z<p>Vincenttc: Created page with "This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful i..."</p>
<hr />
<div>This page discusses what happens when you use more disk space than has been allotted to your account (your quota) and how to reduce your disk usage. This page is also useful if you want to reduce your disk usage even if you're not using more than your quota. You can check your current disk usage as well as your quota on https://ucc.ulyssis.org/quota . <br />
<br />
== What happens when I go over my quota? ==<br />
<br />
If you are user more disk space than your quota for more than seven consecutive days, you will no longer be able to write any additional files or extend existing files. You will probably no longer be able to edit websites on your account or it might even stop working outright. If you haven't configured a forwarder for your <code>''username''@ulyssis.org</code> email address, you will lose emails send to this address. The grace period of seven days is intended for you to have time to reduce your disk space. You will receive an email every day reminding you that you are using to much disk space. In order to prevent impact on other users during this seven day period, an additional quota slightly higher than your normal quota is imposed, independent of whether the grace period has passed or not.<br />
<br />
== Identifying which files & folders use the most disk space ==<br />
It is not always easy to immediately identify what is using up your disk space on your account. Sadly, <br />
<br />
* SSH to one of the shell servers: https://docs.ulyssis.org/Accessing_shell_servers_over_SSH<br />
* Type in <code>ncdu</code> and press enter. You will then see that <code>ncdu</code> is scanning your account.<br />
* Once it has finished scanning it will show which files or folders directly in your home directory are using the most disk space. When the filename stars with <code>/</code> it is a folder.<br />
* You select different files/folders using the '''up and down arrow keys''', navigate the directory structure using the '''enter and escape''' keys, quit ncdu by pressing '''q''' and delete a file or folder with '''d'''. Be careful to not delete files you still need as you will need to contact us in order to restore them from a backup.<br />
* You can check your progress on https://ucc.ulyssis.org/quota</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Getting_SSL/TLS&diff=1211Getting SSL/TLS2021-02-15T16:38:38Z<p>Vincenttc: /* Requesting SSL from the KU Leuven */</p>
<hr />
<div>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 is you are eligible for one, and we will also install certificates you have bought or obtained elsewhere.<br />
<br />
==Requesting SSL from the KU Leuven==<br />
<br />
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 Stura body as well as organisations (vrije verenigingen) recognized by LOKO or KU Leuven.<br />
<br />
Before sending us a request, the following steps have to be performed:<br />
* Set up the site that needs SSL if that's not already the case<br />
* Make sure our nameservers are being used for the involved domain(s), as explained on [[Adding domain names]]<br />
* Consider all subdomains (whether separate websites or not) you wish to have certificates for<br />
* 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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
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.<br />
<br />
{{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.}}<br />
<br />
==External certificates==<br />
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<br />
<br />
===Let's Encrypt===<br />
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.<br />
<br />
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:<br />
<br />
mkdir -p ~/letsencrypt/mydomain.be<br />
<br />
Certificates should be stored in these folders, according to the following file structure:<br />
<br />
letsencrypt/<br />
└── mydomain.be/<br />
├── mydomain.be.chain (the CA file)<br />
├── mydomain.be.crt (the cert file; "public key")<br />
└── mydomain.be.key (the key file; "private key")<br />
<br />
If you already possess the necessary files, renaming and copying them accordingly is sufficient. <br />
'''You still have to email us to install your certificate.''' More information in the last section on this page.<br />
<br />
Otherwise, you can generate or renew your certificates using acme.sh. This is explained in the next section.<br />
<br />
==== Generating certificates ====<br />
{{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><br />
RewriteRule "^.well-known/acme-challenge" - [L]<br />
</IfModule></pre>}}<br />
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.'''<br />
<br />
Firstly, execute the following commands to download the acme.sh script in your home directory and make it executable:<br />
<br />
curl -o ~/acme.sh https://raw.githubusercontent.com/acmesh-official/acme.sh/master/acme.sh<br />
chmod +x ~/acme.sh<br />
<br />
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).<br />
<br />
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!<br />
<br />
~/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<br />
<br />
The explanation of these many parameters is as follows:<br />
* <code>--issue</code> tells acme.sh to generate a new certificate.<br />
* <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.<br />
* <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.<br />
* <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.<br />
* <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.<br />
* <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.<br />
* <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.<br />
<br />
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.<br />
<br />
==== Renewing certificates ====<br />
To renew the certificates of <code>mydomain.be</code>, just execute:<br />
~/acme.sh --renew -d mydomain.be<br />
<br />
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>.<br />
<br />
If you are not sure which domain name to use, you can execute the command:<br />
~/acme.sh --list<br />
<br />
This will generate a list of available certificates, which looks a bit like this:<br />
Main_Domain KeyLength SAN_Domains CA Created Renew<br />
mydomain.be "" www.mydomain.be LetsEncrypt.org ... ...<br />
... ... ... ... ... ...<br />
<br />
In this example, the main domain is <code>mydomain.be</code>.<br />
<br />
The renewed certificates will automatically be copied to the files you provided in the command to generate the certificates (see previous section).<br />
<br />
'''After renewing the certificate, you have to email us to install your certificate.''' More information in the next section.<br />
<br />
==== Getting your certificates installed ====<br />
Check whether everything is stored correctly by executing the following command:<br />
ulyssis-certificate check mydomain.be<br />
<br />
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. <br />
<br />
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.<br />
<br />
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.<br />
<br />
[[Category:Webserver]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Secure_file_permissions&diff=1194Secure file permissions2020-11-30T23:51:34Z<p>Vincenttc: /* Recommended permissions */</p>
<hr />
<div>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 it's own user.<br />
<br />
=== Recommended permissions ===<br />
<br />
* www directory (and other directories from where websites are served), including subdirectories: <code>0705/drwxr-xr-x</code><br />
* Static website files (css, images, html, ...): <code>0604/-rw-r--r--</code><br />
* Configuration files containing secrets/passwords: <code>0600/-rw-------</code><br />
* Other directories and files that are not part of a website: <code>0600/-rw-------</code> or <code>0700/-rwx------</code><br />
<br />
=== Securing database login info ===<br />
<br />
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 FileZilla, you can do this by right-clicking on the config file, clicking on "File permissions...", and changing the permissions according to the following screenshots:<br />
<br />
[[File:config-php_dropdown.png]]<br />
[[File:config-php_attrs.png]]<br />
<br />
=== Securing uploads directory ===<br />
<br />
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 FileZilla, you can do this by right-clicking on the config file, clicking on "File permissions...", and changing the permissions according to the following screenshots:<br />
<br />
<br />
<br />
[[File:uploads_dropdown.png]]<br />
[[File:uploads_attrs.png]]<br />
<br />
[[Category:Files]]<br />
<br />
[[Category:Security & anti-spam]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Secure_file_permissions&diff=1193Secure file permissions2020-11-30T23:51:01Z<p>Vincenttc: /* Homedirectory permissions */</p>
<hr />
<div>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 it's own user.<br />
<br />
=== Recommended permissions ===<br />
<br />
* Homedirectory: See [[#Homedirectory permissions | homedirectory]]<br />
* www directory (and other directories from where websites are served), including subdirectories: <code>0705/drwx---r-x</code><br />
* Static website files (css, images, html, ...): <code>0604/-rw----r--</code><br />
* Configuration files containing secrets/passwords: <code>0600/-rw-------</code><br />
* Other directories and files that are not part of a website: <code>0600/-rw-------</code> or <code>0700/-rwx------</code><br />
<br />
=== Securing database login info ===<br />
<br />
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 FileZilla, you can do this by right-clicking on the config file, clicking on "File permissions...", and changing the permissions according to the following screenshots:<br />
<br />
[[File:config-php_dropdown.png]]<br />
[[File:config-php_attrs.png]]<br />
<br />
=== Securing uploads directory ===<br />
<br />
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 FileZilla, you can do this by right-clicking on the config file, clicking on "File permissions...", and changing the permissions according to the following screenshots:<br />
<br />
<br />
<br />
[[File:uploads_dropdown.png]]<br />
[[File:uploads_attrs.png]]<br />
<br />
[[Category:Files]]<br />
<br />
[[Category:Security & anti-spam]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1158Overview2020-10-19T18:33:35Z<p>Vincenttc: /* Versioning */</p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Help, my account has been disabled]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
* [[ULYSSIS public FTP]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1128Overview2020-09-17T12:45:31Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Help, my account has been disabled]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[Subversion]]<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
* [[ULYSSIS public FTP]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Securing_MediaWiki_using_Centrale_KU_Leuven_Login&diff=1120Securing MediaWiki using Centrale KU Leuven Login2020-08-11T15:12:53Z<p>Vincenttc: /* MWSAllowedDegrees */</p>
<hr />
<div>==About==<br />
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.<br />
<br />
==Prerequisites==<br />
Before installing, you need to have SSL and Shibboleth (Central KU Leuven Login) enabled on your domain.<br />
* For instructions on how to get SSL: https://docs.ulyssis.org/Getting_SSL<br />
* Information about requesting Shibboleth: https://docs.ulyssis.org/Shibboleth<br />
Once you know everything is installed properly, you can proceed to install the extension.<br />
<br />
==Installation==<br />
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:<br />
<br />
wfLoadExtension('MediaWikiShibboleth');<br />
$wgGroupPermissions['*']['createaccount'] = false;<br />
$wgRevokePermissions['Shibboleth']['editmyprivateinfo'] = true;<br />
<br />
$wgGroupPermissions['*']['edit'] = false;<br />
$wgGroupPermissions['*']['createtalk'] = false;<br />
$wgGroupPermissions['*']['createpage'] = false;<br />
$wgGroupPermissions['*']['writeapi'] = false;<br />
<br />
If you want to allow anonymous editing, you should <b>not</b> add the last 4 lines of the previous paragraph. This really defeats the purpose of the extension though.<br />
<br />
==Configuration==<br />
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.<br />
<br />
=== Restricting access to logged-in users only ===<br />
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>: <br />
<br />
$wgGroupPermissions['*']['read'] = false;<br />
<br />
=== MWSStudentsOnly ===<br />
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 <br />
<br />
$wgMWSStudentsOnly = true;<br />
<br />
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.<br />
<br />
=== MWSAllowedKULids ===<br />
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 <br />
<br />
$wgMWSAllowedKULids = "r0653730, r0300342, KUL id 3...";<br />
<br />
to <code>LocalSettings.php</code>. You can add as many KUL ids as you like, separated by a comma.<br />
<br />
=== MWSAllowedDegrees ===<br />
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 <br />
<br />
$wgMWSAllowedDegrees = "51016742, 51016835, 51016753...";<br />
<br />
to <code>LocalSettings.php</code>. You can add as many degree numbers as you like, separated by a comma.<br />
<br />
=== Translations ===<br />
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.<br />
<br />
==Operation==<br />
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.<br />
<br />
The new log in page looks like this with "Login without Central KU Leuven login" expanded:<br />
<br />
[[File:Login.png]]<br />
<br />
==Creating accounts==<br />
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".<br />
<br />
[[File:CreateAccount.png]]<br />
<br />
[[Category:Security & anti-spam]]</div>Vincenttchttps://docs.ulyssis.org/index.php?title=Overview&diff=1116Overview2020-07-29T14:43:00Z<p>Vincenttc: </p>
<hr />
<div><div style="background:#f9f9f9;border:1px solid #ddd;font-size:95%;padding:1.5em;"><br />
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><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Account ==<br />
* [[Registering a new account]]<br />
* [[Renewing your account]]<br />
* [[Transferring your account]]<br />
* [[Resetting your password]]<br />
* [[Help, my account has been disabled]]<br />
* [[Why do I have to pay 0.00 euro and how?]]<br />
</div><div style="width:45%;float:left"><br />
== Files ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Using SSHFS]]<br />
* [[Making Backups]]<br />
* [[Secure file permissions]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Webserver ==<br />
* [[Webserver changes summer 2020]]<br />
* [[Using your webspace]]<br />
* [[Using (Fast)CGI for non-PHP websites]]<br />
* [[Getting Apache logs]]<br />
* [[Managing PHP errors]]<br />
* [[Setting PHP options]]<br />
* [[Sending email from websites]]<br />
* [[Adding domain names|Adding domain names (.be, .com, .org, ...)]]<br />
* [[Getting SSL/TLS|Getting SSL/TLS (HTTPS security)]]<br />
* [[Shibboleth|Shibboleth (Centrale KU Leuven Login)]]<br />
* [[Basic authentication|Basic authentication in PHP]]<br />
* [[Claiming a port]]<br />
* [[ULYSSIS security measures]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Mail ==<br />
* [[Introduction to ULYSSIS email]]<br />
* [[Mailbox]]<br />
* [[Forwarders]]<br />
* [[Using a forwarder as an alias]]<br />
* [[Add an alias in Gmail]]<br />
* [[Add an alias in Hotmail/Outlook]]<br />
* [[Add an alias in Thunderbird]]<br />
* [[Fetch your KU Leuven email into another email address]]<br />
* [[Spam]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== CMSs ==<br />
* [[Software Version Checker]]<br />
* [[Setting up WordPress]]<br />
* [[Setting up Drupal]]<br />
* [[Setting up Joomla]]<br />
* [[Setting up MediaWiki]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== Security & anti-spam ==<br />
* [[Secure file permissions]]<br />
* [[Software Version Checker]]<br />
* [[Preventing spam on Wordpress]]<br />
* [[Preventing spam on Joomla]]<br />
* [[Preventing spam on Drupal]]<br />
* [[Preventing spam on MediaWiki]]<br />
* [[Securing MediaWiki using Centrale KU Leuven Login]]<br />
* [[ULYSSIS security measures]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Databases ==<br />
* [[Using PostgreSQL]]<br />
* [[Using MySQL]]<br />
* [[Using PHPMyAdmin]]<br />
* [[Using PHPPgAdmin]]<br />
* [[Using Adminer]]<br />
* [[Making Backups]]<br />
<br />
</div><div style="width:45%;float:left"><br />
<br />
== Shell ==<br />
* [[Accessing your files]]<br />
* [[Transferring files over SFTP]]<br />
* [[Accessing shell servers over SSH]]<br />
* [[ULYSSIS public IRC]]<br />
* [[Useful Linux Commands]]<br />
* [[Managing Cron jobs]]<br />
* [[Claiming a port]]<br />
* [[Installing packages]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
<br />
== Versioning ==<br />
* [[Subversion]]<br />
* [[GitLab]]<br />
</div><div style="width:45%;float:left"><br />
<br />
== ULYSSIS Public Services ==<br />
* [[ULYSSIS public IRC]]<br />
* [[ULYSSIS public FTP]]<br />
</div><br />
<div style="clear:both;"></div><br />
<br />
<div><br />
<div style="width:45%;float:left;padding-right:10px;"><br />
== Tutorials ==<br />
* [[Using the kulemt package]]<br />
* [[KULoket agenda iCal feed]]<br />
</div><br />
<div style="clear:both;"></div><br />
</div><br />
<br />
__NOTOC__</div>Vincenttc