¶ Website Hosting
Using our Shell Accounts, you can host your website (or any other static resources) in ~/public_html/.
This is ideal for hosting a static site or built with a static site generator such as hugo or zola.
It is also useful for hosting files on the internet. (nothing dodgy please)
¶ Getting Started
Log into Hopper and visit https://<username>.sites.uwcs.co.uk, you should see the default site, if you are facing errors, this maybe a permissions issue, run the sites command and follow the prompts to set file permissions and test.
¶ Adding files
public_html is your webroot, placing files e.g. ~/public_html/test.txt will be accessible at https://<username>.sites.uwcs.co.uk/test.txt
¶ Custom Domains
It is possible to set up your own custom domain name to point at files served on our website. We require that you add a DNS record to point at our IP address, and also provide us with an SSL certificate for your domain.
Get in contact with us at @sysadmins on Discord to set this up.
¶ Custom *.uwcs.co.uk Domain
Contact us to edit Caddy's Nix Config.
¶ Custom domain
NOTE: If you are using Cloudflare, please DISABLE the Cloudflare proxy (i.e. click the orange cloud next to the record to make it grey) during setup. This can be enabled after it's all working and the SSL ceriticate has been issued.
(Static site on Hopper)
- Add an A record in the website's DNS settings to
137.205.37.213 - Add certificate in OPNsense ACME client
- Add this certificate to the HTTPS frontend in
HAProxy->Virtual Services->Public Sevicesin OPNSense - Add domain name to point to the
hopper_backendin thepublic_subdomainsmap file underHAProxy->Advanced->Mapfilesin OPNSense - Add add a record to point the domain to site location in Caddy's Nix Config
(Dynamic site on *.containers.uwcs.co.uk)
- Add a CNAME record to point to
<name>.containers.uwcs.co.uk - Ask a Tech Officer to add the domain to
container_backendin the map file in Milner -> Services -> HAProxy -> Settings -> Advanced -> PUBLIC_SUBDOMAINS_map - (Optional) If the name of the containers differs from the url of the website (for example
foo.com -> bar.containers.uwcs.co.ukrather thanfoo.containers.uwcs.co.uk), ask a Tech Officer to create the relevant rules on HAProxy (see WSAF for an example)
¶ Setting up SSL
Please ask a Tech Officer to:
- Create a new SSL certificate in Milner -> Services -> ACME Client -> Certificates -> +
- Put the domain as the common name, and the challenge type of HTP challenge
- Assign the certificate to the HTTPS service in Milner -> Services -> HAProxy -> Settings -> Virtual Services Dropdown -> Public Servers -> 2_HTTPS_frontend
¶ Backends
Consider using a Container or get in contact for other options.
¶ Need Help?
Contact us on Discord at @sysadmins
For a more formal response techteam@uwcs.co.uk can be used.
we don't bite 