Members of the OTH can add their own homepage to the Homepages-Server. It uses PHP 5 for Scripting and MySQL 5 for Databases, with storage equivalent to 50 MB.

• Provided it has't already been done, establish a Gateway with the Gateway Manager.
• With a SCP-Client connect to hps.hs-regensburg.de with Port 4444.
• Username im Format abc12345, Password like in the CIP-Pool.
• Upload website to the “html” directory, and done. The site is then reachable through a single link in this format:

https://hps.hs-regensburg.de/~abc12345/
or
https://hps.hs-regensburg.de/abc12345/

Special usernames use the Format:

https://hps.hs-regensburg.de/~specialusername/

Provided it has't already been done, establish a Gateway with the Gateway Manager.

To upload your website there is a SSH-Gateway you can use. With an SCP-Client such as WinSCP you can copy your homepage to the server. Additionally download the “Installation package” and install the program on your Computer. After the start of WinSCP it should look like this:

Enter the data as seen in the screenshot, by “User name” instead of the abc12345 format enter your contracted username, by “Password” enter your password like in the CIP-Pool.
To save time, you can save the entry bz clicking “Save…”. But beforehand please clear the password field.

In the next step WinSCP will verify that the Server is the one which it says it is. If your line by “ssh-rsa” is similar to the screenshot below, click “Yes”.

If all went well then WinSCP should show the main window:

Now, in the left side of the window, naviate to the folder you wish to upload and, in the right side of the window, open the “html” folder:

Highlight the data and folders you wish to upload, and then copy them by clicking “F5 Copy”. A dialogue window will pop up, you may then comfirm the transfer by pressing “Copy”:

That was it. Now, using a browser of your choice, open your webpage with the link in the Format

https://hps.hs-regensburg.de/~abc12345/

Usernames, that aren't in the format abc12345, must be called with a Tilde too

https://hps.hs-regensburg.de/~specialusername/

As long as nothing else is given in the link it will first open the data in index.html or index.php:

To use your MySQL-Database you can use phpMyAdmin. Log yourself in by using your DB-Username and DB-Password.
If you can't remember your database password, you can create a new one at the Gateway Manager.

Please don't upload any own or third party tools to use in your databaseas they are often used as attack points by malicious attackers. The pre-installed phpMyAdmin can be kept up from a central point.

Connect yourself to the server, as explain above. In the WinSCP Main Window click the button “Commands / Open Terminal”.
In the “Enter Command” enter the command:

quota -gls

After clicking the “Execute” button you will recieve your current usage and limit of your memory.

This command also works easily in a SSH-Session.

To execute commands yourself, you can connect to a SSH-Client such as PuTTY. In the Login window enter the same information as in the SCP part of this Wiki.

If you wish to restrict, who can access your webpage, you can use the .htaccess Mechanic. Here in the folder, in which you wish to restrict access, put a file with the name .htaccess and with the following contents:

AuthType Basic
AuthName "Gesperrter Bereich"
AuthUserFile /home/abc12345/html/gesperrt/.htpasswd
Require valid-user

This way you can replace Gesperrter Bereich with your own text. Then you must tell the webserver where the file with the access-granted users is. This directory path is dictatced by the AuthUserFile:
line. In this example the user abc12345 in the folder html has a sub-folder with the name gesperrt. Here you must place your username like the foldername.

Finally you must make the file with the whitelist. Here in a SSH-Session you can usethe command in which

htpasswd -c -s /home/abc12345/html/gesperrt/.htpasswd benutzername

the parts mentioned above can be replaced. When editing an existing .htpasswd file the-c must be removed.
If thats too complicated, you can use a Javascript-htpasswd-Generator. There enter the usernames like passwords of the new users and click on “encrypt password”. Write the output into a file with the name .htpasswd and then place them into the same location as the .htaccess file. If you wish to allow more than one new user, just append the output line. Such a .htpasswd file should then look like this:

test:$apr1$Izqzb/vl$SOd6F.dLpj7orU7xHa40N0
fritz:$apr1$xVvl14WY$.tHSAwnXA6ohOLMidiSSC1

A more detailed instruction set with more information such as about the back-end can be found at SelfHTML.

If after the installation of PHP-Scripts(such as a Forum) you still get sent to the index.php page, but by style.css receive Error 403, then the Apache-Webserver is probably just missing the permissions to read the files.
Scripts will be used as both the user's and the group's to which they belong.

The following situation appeared after the installation of a SMF Forum:

$ ls -l
-rw-r--r-- 1 abc12345 abc12345  14K Dec 22 17:12 index.php
(...)
drwx------ 4 abc12345 abc12345 4.0K May 30 11:08 Themes/

So the forum was able to reach index.php but not the Stylesheet index.css underThemes/. The reason for this is the following:

• index.php is a PHP-Script and is started by the User/Group abc12345, since this is the owner of the files. Access granted, all good.
• Themes/default/css/index.css is not a PHP-Script and therefore Webserver-Userwww-data opens. Since to Themes/ onlyabc12345 has permissions to open the folder, access is blocked with a 403 Error.
• To fix this you should give read permission to such folders and files. You can use the following command:

find -type d -print0 | xargs -0 chmod -c 755 ; find -type f -print0 | xargs -0 chmod -c 644

With this all the read and write permissions for all files and folders will be given.

$ ls -l
-rw-r--r-- 1 abc12345 abc12345  14K Dec 22 17:12 index.php
(...)
drwxr-xr-x 4 abc12345 abc12345 4.0K May 30 11:08 Themes/

If more users wish to work on one file (e.g. Special Accounts), it is useful to work with another umask. Files use this to declare file permissions, which are assigned by default when creating a file or folder. Normally this is set to the value 0022 , which leads to the following rights:

$ touch test
$ ls -l test
-rw-r--r-- 1 abc12345 spezialaccount 0 Dec 10 15:25 test

Here only the user abc12345 has writing permission (-rw-r–r–), but not the group spezialaccount (-rw-r–r–) Writing permissions are not enough for working together. This can be remedied with hindsight chmod:

$ chmod -Rc g+w test
mode of ‘test’ changed from 0644 (rw-r--r--) to 0664 (rw-rw-r--)
$ ls -l test
-rw-rw-r-- 1 abc12345 spezialaccount 0 Dec 10 15:25 test

So that you don't have to repeat this every time it is reccomended to set a differentunmask with:

$ umask 0002

If the user by default gets (-rw-rw-r–) and the group (-rw-rw-r–) writing permission then:

$ touch test2
$ ls -l test2
-rw-rw-r-- 1 abc12345 spezialaccount 0 Dec 10 15:30 test2

Im WinSCP setzt man dies im Transfer Settings Dialog im Bereich Upload Options → Set Permissions.