Getting started
From order to a live site takes about 15 minutes of your time. After that, publishing happens automatically on every push.
Step 1: Order
Order GetGeek Static in the portal: https://portal.getgeek.se/index.php/cart/webbhosting/&action=add&id=931
In the order you fill in the following:
You can change all of this later, see Manage your site in the portal.
Step 2: What you find in the portal
Once the site is set up, you find the following on the service page in the portal (see Manage your site in the portal):
- Status — per domain whether it is verified, the current version and the result of the latest publication.
- A deploy key (when we fetch from your repository) — a public SSH key that gives us read access to your repository. It cannot change anything.
- A webhook address (when we fetch from your repository), in the form
https://static.getgeek.se/hook/<site>/<token>. It tells us that there is something new to build. - An upload address (when you upload a pre-built site from CI), see Build it yourself.
- A verification code per domain,
gg-static-…, which shows that the domain is yours (see step 4).
The last part of the address is a key. It can only start a build of what is already in your repository — it can never change your site — but don't share it unnecessarily. If you think it has leaked, press Ny webhook- och uppladdningsnyckel (new webhook and upload key) on the service page.
Step 3: Connect your repository
Add the deploy key and the webhook in your git service. It differs slightly between services:
- GitLab (with screenshots)
- GitHub
- Gitea, Forgejo, Codeberg, Bitbucket and others
Step 4: DNS
Add two records for each domain at your DNS provider.
Point the domain to us. For a subdomain, for example www.example.com:
For a domain without a prefix (example.com) you cannot use a CNAME — the DNS
standard doesn't allow it at the apex of a zone. Add both addresses instead:
The addresses are fixed and will not change. Add both A and AAAA, so that the site reaches visitors over both IPv4 and IPv6.
Show that the domain is yours, with the verification code you received in step 2:
Without it, anyone could ask us to publish a site on your domain if it happens to point to us — for example an old CNAME that was left behind. The TXT record proves that you control the domain's DNS. GitLab Pages and most similar services use the same method. The code is unique to your site.
We check for the record automatically every ten minutes. When it is found, you receive an email saying the domain is verified — you don't need to contact us. After that the record doesn't need to stay, but it does no harm if it does.
Step 5: Push
Push something to your branch. Within a few seconds we:
- receive the webhook,
- fetch your repository with the deploy key,
- build the site with Hugo,
- publish it.
The first time your domain is used, we also fetch a certificate from Let's Encrypt. That takes from half a minute to a few minutes — but only once the DNS records have propagated. If you have just changed DNS, it can take up to an hour or so, depending on how long the old answers are cached.
Done! From now on the site is published on every push. If a build fails you get an email, and your site keeps showing the latest working version.