Differences between revisions 8 and 9
Revision 8 as of 2024-01-02 15:08:10
Size: 1603
Editor: ConorBennett
Comment: Article clean-up, added more tips and links
Revision 9 as of 2024-01-03 02:00:32
Size: 2264
Editor: ConorBennett
Comment: Added basic usage for new users
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
  * {{{http://username.ucc.asn.au}}}
  * {{{http://www.ucc.asn.au/~username}}}
  * {{{https://username.ucc.asn.au}}}
  * {{{https://www.ucc.asn.au/~username}}}
Line 10: Line 10:

=== Basic Usage ===

Place an {{{index.html}}} document in your {{{public-html/}}} folder to serve as a landing page for your site. Subfolders in {{{public-html/}}} are served as routes for your site, so e.g. {{{public-html/blog/index.html}}} will be served at {{{https://username.ucc.asn.au/blog/}}}. The {{{index.html}}} document is the default document served for any route, however you can also access any file (HTML or not) stored under {{{public-html/}}} or a subdirectory by specifying the filename after the path in the URL. E.g. {{{https://username.ucc.asn.au/contact/gpg.key}}} will serve the file located at {{{public-html/contact/gpg.key}}}.
Line 15: Line 19:
If you register a domain name, we can point it at your website; get in contact with a [[WheelGroup|Wheel]] member. Conversely, if you have your own website and want your UCC site to redirect to this instead, you can configure this yourself by placing a [[https://httpd.apache.org/docs/2.4/howto/htaccess.html|.htaccess]] file with a {{{Redirect}}} directive in your {{{public-html/}}} folder. The {{{.htaccess}}} file allows you to control other aspects of Apache configuration for your site as well, such as [[https://httpd.apache.org/docs/2.4/howto/cgi.html|running CGI scripts]]. If you register a domain name, we can point it at your website; get in contact with a [[WheelGroup|Wheel]] member. Conversely, if you have your own website and want your UCC site to redirect to that instead, you can configure this yourself by placing a [[https://httpd.apache.org/docs/2.4/howto/htaccess.html|.htaccess]] file with a {{{Redirect}}} directive in your {{{public-html/}}} folder. The {{{.htaccess}}} file allows you to control other aspects of Apache configuration for your site as well, such as [[https://httpd.apache.org/docs/2.4/howto/cgi.html|running CGI scripts]].

All UCC members get personal web space.

How It Works

User websites can be configured by placing files in the public-html/ folder of their home directory (usually /home/ucc/username/). These files are then served by an Apache 2 webserver running on Mussel to the locations:

  • https://username.ucc.asn.au

  • https://www.ucc.asn.au/~username

More detail about the configuration can be found here.

Basic Usage

Place an index.html document in your public-html/ folder to serve as a landing page for your site. Subfolders in public-html/ are served as routes for your site, so e.g. public-html/blog/index.html will be served at https://username.ucc.asn.au/blog/. The index.html document is the default document served for any route, however you can also access any file (HTML or not) stored under public-html/ or a subdirectory by specifying the filename after the path in the URL. E.g. https://username.ucc.asn.au/contact/gpg.key will serve the file located at public-html/contact/gpg.key.

Tips

Easy ways to upload site files include using WinSCP, FileZilla, sftp, sshfs or a myriad of other ways. You can also use SSH and a terminal text editor such as vim or nano to edit your files directly. The HowToUCC/Program page contains more useful tips about performing development work on UCC servers.

If you register a domain name, we can point it at your website; get in contact with a Wheel member. Conversely, if you have your own website and want your UCC site to redirect to that instead, you can configure this yourself by placing a .htaccess file with a Redirect directive in your public-html/ folder. The .htaccess file allows you to control other aspects of Apache configuration for your site as well, such as running CGI scripts.