Project

General

Profile

Ungleich static web hosting » History » Version 21

ll nu, 03/25/2020 06:41 PM

1 1 Timothée Floure
h1. Ungleich Static Web Hosting
2
3
{{toc}}
4
5
*%{color:green}This document concerns end-users/customers. See [[The ungleich static web hosting infrastructure]] page for server-side documentation.%*
6
7
h2. Status
8
9 7 Timothée Floure
This document is *in PRODUCTION*.
10 1 Timothée Floure
11
h2. Overview
12
13
Our "static web hosting offer":https://ungleich.ch/u/products/zerocarbon-webhosting-with-ipv6/ is dead simple: you get an SFTP-accessible storage share which is served by a dual-stack (IPv4+IPv6) NGINX web server.
14
15
h2. FAQ
16
17
h3. Q: How do I upload files?
18
19 2 Timothée Floure
We offer you an SFTP interface which is authenticated against our (LDAP) customer directory, which means you can use your ungleich username and password.
20 1 Timothée Floure
21 10 Timothée Floure
* Host: staticwebhosting.ungleich.ch
22 2 Timothée Floure
* Port: 22
23
* Username: your ungleich username
24
* Password: your ungleich password
25
26
You can use the cross-platform "FileZilla (S)FTP client":https://filezilla-project.org/ if you do not know where to start.
27
28 1 Timothée Floure
h3. Q: Can I use SSH keys?
29
30 2 Timothée Floure
Yes! You just have to upload your own @authorized_keys@ file in @.ssh/authorized_keys@.
31 1 Timothée Floure
32
h3. Q: Do I need my own domain name?
33
34 3 Timothée Floure
We expect that most people will use their own domain but you can access the files stored under @public_html@ at @https://staticwebhosting.ungleich.ch/~YOURUSERNAME/@.
35 1 Timothée Floure
36
h3. Q: How do I configure a domain? How many domains can I serve?
37
38 8 Timothée Floure
You can point as many domains as you want to this service (on demand). You will first have to set:
39 1 Timothée Floure
40 9 Timothée Floure
* An @A@ record for IPv4, pointing to @185.203.114.169@.
41 8 Timothée Floure
* An @AAAA@ record for IPv6, pointing to @2a0a:e5c0:2:12:0:f0ff:fea9:c3c8@.
42
* ... or (instead of @A@ and @AAAA@) a @CNAME@ record point to @staticwebhosting.ungleich.ch@.
43 2 Timothée Floure
44 1 Timothée Floure
h3. Q: What web server do you use? Can you enable X for me?
45
46 2 Timothée Floure
We use "NGINX":http://nginx.org/ and can reasonable features / configuratiob on demand.
47 1 Timothée Floure
48
h3. Q: How can I make a static website?
49
50 4 Timothée Floure
You have various alternatives:
51 5 Timothée Floure
* Write HTML/CSS by hand.
52 11 Timothée Floure
* Use a static website generator intended to somewhat technical people ("Jekyll":https://jekyllrb.com/, "Hugo":https://gohugo.io/, "Pelican":https://blog.getpelican.com/, "Hakyll":https://jaspervdj.be/hakyll/, "cstate":https://github.com/cstate/cstate, ...)
53 5 Timothée Floure
* Use a static website generator intended to standard end-users ("Publii":https://getpublii.com/).
54 15 ll nu
   
55 18 ll nu
 
56
 
57
 
58 17 ll nu
59 12 ll nu
h2. Deploying static websites with custom domain names
60 1 Timothée Floure
61 20 ll nu
h3. Step 1: Point your custom domain name entries to the staticwebhosting's ips.
62 16 ll nu
63 12 ll nu
As described "here":https://redmine.ungleich.ch/projects/open-infrastructure/wiki/Ungleich_static_web_hosting#Q-How-do-I-configure-a-domain-How-many-domains-can-I-serve
64
65 20 ll nu
h3. Step 2: Log into staticwebhosting:
66 14 ll nu
67 12 ll nu
sftp $YOUR_USERNAME@staticwebhosting.ungleich.ch
68
69 20 ll nu
h3. Step 3: Create your website's directory:
70 14 ll nu
71 12 ll nu
mkdir public_html/$YOUR_FULL_DOMAIN_NAME
72
e.g:
73
mkdir public_html/my.beautifulwebsite.com
74
75 20 ll nu
h3. Step 4: Place your html/css files there
76 12 ll nu
77 21 ll nu
put $File_path_from_your_pc $Target_Directory
78
e.g.:
79
put /tmp/index.html public_html/$YOUR_FULL_DOMAIN_NAME/
80
81 20 ll nu
h3. Step 5: Open a support request or ping us via chat to finalize the setup.
82 14 ll nu
83 12 ll nu
Dont forget to include your domain name.