How to host a site on GitGud

gitgud logo

This tutorial will teach you how to launch an index.html to the link https://username.gitgud.site where username is your GitGud/Sapphire username

IMPORTANT: Git was never designed for privacy. Always set everything to private, use psuedonyms and non-personal emails etc

Intro

https://gitgud.io is a free Git hosting site powered by GitLab, hosted by sapphire.moe . It's used by many open source adult videogames and videogame mods, and it is quite permissive.

Because it is hosted by GitLab, they also support GitLab Pages, which allows you to deploy a website from a GitGud repository, which will be hosted on a https://gitgud.site link

Make an account

Go to https://accounts.sapphire.moe/ and sign up. If you're confident you'll never lose your password, you can use a 10 minute mail. You will need to confirm your email when setting up Gitgud for the first time.

Once you have an account made, click on GitGud

gg

Then click Sapphire, then when it asks "GitGud.io wants to connect your Sapphire account" press Authorize

authorize

You should now be redirected to https://gitgud.io/-/user_settings/profile . It wants you to complete your profile with an email. You can use the one you made your sapphire account with, or whatever as long as you can click the verification. Your email is public by default. The setting below the email field allows you to select a private email to show instead, which is recommended.

Making a repository

Click the + in the top left of the screen and select New project/repository

new repo

Go to "Create from template", and then scroll down until you see Pages/Plain HTML and press Use Template

plainhtml

Set the project name to username.gitgud.site where username is your gitgud username. You can make it Private, or if you want people to see your code you can make it public. (Since this is a just a simple HTML website everyone can see your code anyways when they Inspect Element)

createfromtemplate

setting up CI

GitGud is not going to generate the website for you. You're gonna have to provide your own hardware. What this essential means is that you will need to setup a Pipeline which are instructions for how to deploy the site, and a Runner which is a machine that runs the pipeline's Jobs to deploy the website. This isn't very complicated for simple sites like this one, but you will still need to set it up yourself.

Go to Build > Pipelines

buildpiplines

Press New Pipeline in the top right and then just press New Pipeline again

newpipeline

Congrats! You have now created your first Pipeline, and you have your first Job called deploy.

myfirstjob

As you can see, it says that the job is stuck. Because you have no Runner registered to run the job. Let's register a runner now.

Go to Settings > CI/CD and open the Runners section and click on "Create project runner".

create project runner

IMPORTANT: Make sure "run untagged jobs" is checked in the Tags section, and then click Create runner

create runner

the part where you give up

You should now be on the register runner page. Follow the instructions for your operating system. Choose shell for your executor.

If you nocoders are really, really having trouble, I'll make a more detailed guide for Windows here in a bit.

Once you have the runner running, go back to the Build > Pipelines section and restart your deploy. You'll see your console on your machine pick up the job, and it will deploy the site. Give it a couple of minutes, if you see a green checkmark you did it successfully. Here's mine: lut22194.gitgud.site

wedidit

People get paid six figures to know how to do this, so don't be upset if you're having trouble and ask for help.

IMPORTANT: Your job logs are public by default. This can leak information about your PC. Private repos solve this, but its best to delete the logs entirely just in case as well

editing your website

hello world

If you're familiar with neocities it's the exact same idea. Just edit your public/index.html file to whatever you want, and when you save (commit) the changes, it will automatically queue up a job again for your runner. You need to have the runner running to deploy the updates to your website.

If you're just doing a small little page, "edit single file" straight in your web browser is fine. If you're actually doing web development, well then I assume you also know how to push and pull Git repositories and how to set that up so I don't need to tell you how to do that.

edit single files

I edited my file to say "gitgud is a cool website!". And when I pressed on "commit changes" (commit to the master branch because thats where our runner is configured to deploy) in just a few seconds a new deploy job was automatically created and my website was updated

gotten gud

next steps

Learn web development? You can deploy any static site on gitgud, not just basic HTML. Also, you might want to learn how Git works, including branches and pull requests if you're interested in editing files locally on your device and then uploading them to your repository, instead of having to edit single file on the website. I hope this guide helps you share your beauty with the world

Edit

Pub: 26 Aug 2025 14:27 UTC

Edit: 26 Aug 2025 16:57 UTC

Views: 247