Een statische website hosten

Een statische site is de eenvoudigste soort website om te hosten: een map met bestanden die precies zo naar bezoekers wordt gestuurd. Deze handleiding legt uit wat dat betekent, op welke drie manieren je in het paneel je bestanden publiceert, hoe je de site bijwerkt en hoe je hem op je eigen domein zet.

Wat een statische site is

Een statische site bestaat uit kant-en-klare bestanden: HTML, CSS, JavaScript, afbeeldingen en lettertypen. Er zit geen PHP en geen database achter, dus er valt niets te patchen en er kan weinig stukgaan.

Het past goed bij:

• Een portfolio, landingspagina, documentatie of een kleine bedrijfssite.
• Alles wat je bouwt met een generator zoals Hugo, Jekyll, Astro of Vite. Je publiceert het eindresultaat, niet het project zelf.

Het past niet bij sites die een login, een webshop of een op de server verwerkt contactformulier nodig hebben. Wil je een site die je in de browser bewerkt, bekijk dan Een WordPress-site starten.

Je startpagina moet een bestand zijn met de naam index.html.

1. De app bestellen

1. Log in op het paneel, open Apps in de zijbalk en klik op App aanmaken.
2. Kies onder Template voor de statische site. Je vindt hem onder Statische sites.
3. Kies onder Pakket een pakket en stel de resources in met de sliders.
4. Vul onder Details de Weergavenaam in. Zet SFTP-toegang aan als je bestanden wilt uploaden met een SFTP-programma en je pakket dat bevat.
5. Vink de bevestiging aan, klik op App deployen en betaal.

Als de status Actief toont, staat in de kaart Toegang op de app-pagina het adres van je site. Klik op Openen. Tot je iets publiceert, zie je een tijdelijke pagina.

2. Je bestanden publiceren

De kaart Inhoudsbron op de app-pagina bepaalt waar je site vandaan komt. Je hebt drie opties.

Optie A: de bestanden zelf uploaden

Dit werkt zolang er in de kaart Inhoudsbron geen bron is gekoppeld.

• Bestandsbrowser: klik op de app-pagina op Uploaden of sleep bestanden naar de lijst. Met Nieuwe map maak je mappen aan. Klik op een tekstbestand om het in de browser te bewerken en klik op Opslaan.
• SFTP: heb je de app met SFTP besteld, dan toont de kaart SFTP-toegang de Host, Poort en Gebruikersnaam. Klik op Wachtwoord instellen (minimaal 12 tekens) of op Sleutel toevoegen en maak daarna verbinding met een SFTP-programma zoals FileZilla of WinSCP.

Optie B: een archief uploaden

1. Pak je kant-en-klare site in als .zip, .tar of .tar.gz. Het archief mag maximaal 48 MB groot zijn.
2. Klik in de kaart Inhoudsbron op Archief uploaden en kies het bestand.
3. Het paneel pakt het uit en herstart de site met de nieuwe inhoud.

Een enkele map om je bestanden heen wordt automatisch verwijderd. Het archief vervangt alles wat op dat moment op de site staat, ook bestanden die je zelf hebt geüpload.

Optie C: een GitHub-repository koppelen

1. Klik in de kaart Inhoudsbron op GitHub koppelen. Het venster Een GitHub-repository koppelen opent.
2. Klik onder Account de eerste keer op De GitHub-app installeren. GitHub vraagt welke repositories het paneel mag lezen. Daarna kom je terug in het paneel.
3. Kies je account, daarna een Repository en een Branch.
4. Klik op Koppelen & uitrollen.

Het paneel publiceert de bestanden van de repository zoals ze zijn, en ze vervangen wat er eerder op de site stond. Het voert geen build voor je uit. Gebruik je een generator, commit dan het eindresultaat of laat je eigen workflow het naar een branch pushen.

De publicatiemap

Staan je kant-en-klare bestanden in een submap, bijvoorbeeld dist of public? Typ de mapnaam in bij Publicatiemap in de kaart Inhoudsbron en klik op Opslaan. Laat het veld leeg als index.html op het hoogste niveau staat. Een wijziging publiceert de site opnieuw.

3. De site bijwerken

Hoe je bijwerkt, hangt af van de gekozen optie:

• Eigen bestanden: upload of bewerk de bestanden. Wijzigingen staan direct live.
• Archief: klik op Archief vervangen en upload de nieuwe versie.
• GitHub: push naar de gekoppelde branch. Elke push naar die branch publiceert de site automatisch. Met Opnieuw uitrollen publiceer je de huidige staat nog een keer met de hand, met Repo wijzigen kies je een andere repository of branch.

Zolang een archief of GitHub is gekoppeld, wordt de site vanuit die bron geserveerd en is de kaart SFTP-toegang verborgen. Pas je inhoud aan in de bron, niet in de bestandsbrowser. Wil je de bestanden weer zelf beheren, klik dan op Ontkoppelen.

4. Je eigen domein gebruiken

1. Ga op de app-pagina naar de kaart Eigen domeinen en klik op Domein toevoegen.
2. Vul je domein in, bijvoorbeeld www.example.com, en volg de DNS-instructies die het paneel toont.
3. Wacht tot het domein als geverifieerd wordt getoond. HTTPS wordt voor je geregeld.

Alle stappen staan in Je eigen domein aan een app koppelen. Nog geen domein? Bekijk Een domein registreren.

5. Back-ups

De kaart Back-ups toont de back-ups die het paneel automatisch maakt, en met Back-up maken maak je er direct een. Meer lees je in Een back-up van je app maken en herstellen.

Eén ding is anders bij statische sites: zolang de inhoud uit een archief of van GitHub komt, kan een back-up niet worden hersteld. Publiceer in plaats daarvan de gewenste versie vanuit de bron.