Create Your Free Website: Jekyll and GitHub Pages Make It Possible


2 October 2023

Create Your Free Website: Jekyll and GitHub Pages Make It Possible Discover how to set up your own website at no cost using Jekyll and GitHub Pages.

Jekyll is a static website generation engine and GitHub Pages is a free hosting service provided by GitHub. By combining these two tools, you can easily create a static website to showcase your projects, blogs or any other content you wish to share.


Installing Jekyll

To install jekyll you need Ruby on your computer. You can verify if Ruby is installed by running:

ruby --version

If you don’t have Ruby installed, follow the instructions at to install it.

Then install jekyll:

gem install jekyll

New project with jekyll

We will create our project with Jekyll using the following command:

jekyll new mysite

We will add some content

Jekyll is a static web site generator that converts content written in Markdown or HTML into pre-compiled static web pages. To understand a little more how it works we will add some content to our index.markdown page which is located in the root of our project. Open the file with your favorite editor and add the following content:

layout: home

# This is mysite

I will show you amazings things.

## Hello world

This is an aweson jekyll site created by me.

`def main; end`

A wise man says:

>> To be, or not to be

Let’s test our page locally

We run the local server with the following command :

bundle exec jekyll serve

Then, open your web browser and go to http://localhost:4000 to see your web site in development. You will notice that our markdown ends up converted to html. To learn more about how jekyll works and what you can achieve I recommend you read the documentation.


If you already have a GitHub account then you can use that one and if you don’t then create a new one.

For GitLab you can see here.

New repository

We create a blank repository for our project. The name of the repository must be the name of our user in github if we want our site to be in the root of the domain that github gives us. Example: If your username is luisito123 then your repository should be called And the repository must be public.

Add an ssh key

To upload changes to our repository we must add our ssh key on GitHub. For this you can take a look at this guide.

We upload our changes

For the first time

After creating our project we must initialize the git repository and upload our changes by executing the following commands in the root of our project and taking into account that the url must be the one of your repository:

git init
git add .
git commit -m "first commit
git branch -M main
git remote add origin{YOUR_ACCOUNT}/{YOUR_ACCOUNT}
git push -u origin main


For a next time you’ll just add your changes, commit and push:

git add .
git commit -m "A message here!"
git push origin main

Configure the deployment

To get our page published we must configure our repository with github pages.

Select the settings tab of our repository.

Then we select Pages.

And finally in the branch section we select our main branch and click on save.

This should start running the first pipeline which will deploy the code currently in the repository. After a minute or two you should be able to see your site at the url of the same name as your repository, in my case: m̀

Last details

As we can see, making your site with Jekyll and deploying it on GitHub pages can be a good option especially if you already know some markdown and versioning with git. This same site also works the same way.

Some tips that may interest you if you will continue working with Jekyll and GitHub Pages:

¡Hola a todos! 👋 ¿Disfrutaron leyendo el artículo? ¡Me encantaría conocer sus opiniones! 💬 No duden en dejar un comentario abajo, ya sea para compartir sus comentarios, preguntas o simplemente saludar. ¡No es necesario registrarse, solo compartan algo valioso! 😊
Hey there! 👋 Enjoyed reading the post? I'd love to hear your thoughts! 💬 Feel free to drop a comment below—whether it's feedback, questions, or just saying hi. No need to sign up, just share something valuable! 😊
Carbon impact of this web page
👷 Contratame / Hire me 👷