Differences between revisions 5 and 9 (spanning 4 versions)
Revision 5 as of 2015-02-28 19:57:18
Size: 1009
Editor: DavidAdam
Comment: mantis is dead but I keep finding references to it everwhere
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 3: Line 3:
Say your username was {{{username}}}. Then your website would appear at the following places:
  * {{{http://username.ucc.asn.au}}} (Hosted from [[Mussel]])
  * {{{http://www.ucc.asn.au/~username}}} (Hosted from [[Mussel]])
== How It Works ==
Line 7: Line 5:
To put stuff in your website, put files in {{{/home/ucc/username/public-html/}}} 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}}}
Line 9: Line 9:
An easy way to upload stuff is to use [[http://winscp.net/eng/index.php|WinSCP]] or [[https://filezilla-project.org/|FileZilla]] or [[sftp]] or [[sshfs]] or ... there are lots of ways. You can also use [[SSH]] and a text editor such as [[vim]] or [[nano]] to edit your files directly. More detail about the configuration can be found [[Systems/Web#Web Serving|here]].
Line 11: Line 11:
You can run [[CGI]] scripts. === Basic Usage ===
Line 13: Line 13:
If you register a domain name, we can point it at your website; email {{{wheel@}}}. 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 15:
Examples of amazing websites:
  * [[http://zanchey.ucc.asn.au/qdb]]
  * [[http://bobgeorge33.ucc.asn.au/]]
  * [[http://tpg.ucc.asn.au/]]
  * [[http://sulix.ucc.asn.au/]]
  * An incomplete list: [[http://www.ucc.asn.au/member/mempages.ucc]]
== Tips ==

Easy ways to upload site files include using [[http://winscp.net/eng/index.php|WinSCP]], [[https://filezilla-project.org/|FileZilla]], [[https://wiki.archlinux.org/title/SCP_and_SFTP|sftp]], [[https://wiki.archlinux.org/title/SSHFS|sshfs]] or a myriad of other ways. You can also use [[SSH]] and a terminal text editor such as [[https://www.vim.org|vim]] or [[https://www.nano-editor.org/|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 [[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.