Getting Started

Welcome to the statichost.uk documentation. Follow these guides to get your site deployed in minutes.

1. Create an Account

Sign up at app.statichost.uk using your email address (magic link — no password needed) or sign in with your GitHub or GitLab account. No credit card required.

2. Create a New Site

From your dashboard, click New Site and configure:

  • Site name — a friendly name for your project
  • Repository URL — the HTTPS or SSH URL of your Git repository
  • Branch — the branch to build from (e.g., main)
  • Framework — choose Hugo, Jekyll, or Static
  • Build command — (optional) custom build command
  • Publish directory — the output directory (e.g., public for Hugo, _site for Jekyll)

3. Add the Deploy Key

For private repositories, copy the deploy key shown in your site settings and add it to your repository:

  • GitHub: Settings → Deploy keys → Add deploy key
  • GitLab: Settings → Repository → Deploy keys

4. Set Up Webhooks (Optional)

To trigger automatic builds when you push, add the webhook URL shown in your site settings to your repository:

  • GitLab: Settings → Webhooks → Add webhook (push events)
  • GitHub: Settings → Webhooks → Add webhook (push events)

5. Deploy

Click the Deploy button in your dashboard, or push to your configured branch. Your site will be built and available at your free subdomain within seconds.

Next Steps