In the world of web content creation, Hugo, is, with no doubt, my favorite. If you’re not familiar with Hugo or the concept of static website generators, I suggest checking

Though is post, I’ll show you how to get a blog up and running in less than 10min!


Head to, log in and create a new project. If it’s your first time, follow this quick intro here.

Create an Application

It is good practice to separate components of your projects. So let’s create an application to host our function.

  • Navigate to Applications applications-menu

  • Click on the ➕ button, this will open a modal to create an application. We’ll call it blog. Click on ✔️ to validate.

  • Click on the application you just created.

Create a Domain

Right now, Taubyte does not generate sub-domains so you’ll have to use your own. This section will assume that you either own or know how to get a DNS domain. If not, start by getting one.

  • Navigate to the Domains tab domain-tab-application

  • Click on the ➕ button, this will open a modal to create an application. We’ll call it blog_domain. Make sure you type your subdomain in the FQDN field then click on ✔️ to validate. create-ping-domain If your domain is, you want to type

Domain validation

You need to provide proof that you own the domain in question.

In addition to this entry, you will need to redirect the DNS requests to this subdomain to the Taubyte network. To do so, add the following entry:


Depending on you’re registar, doing so would look like this: example-dns-namecheap

Once you added the entries, get back to the console and close the modal.

You can continue with the next step as, unlike anything you might have seen before, on Taubyte nodes verify the TXT record individually at run-time.

Create a website

Now that you have your sub-domain setup, you can attach a website to it. But first, let’s cover some cool facts:

  • Websites are built into bundles and stored in the network in a distributed fashion (similar to IPFS)
  • No need to use a CDN (Content Delivery Network) as the Taubyte network will always instantiate your website close to the user
  • Unlike a CDN, updates automatically propagate, generally, in less than 3 seconds.

Back to the web console,

  • First, switch to the websites tab websites-tab-webconsole

  • Click on the ➕ button.

    • Name it blog
    • Leave Repository set to --Generate--
    • Select your domain blog_domain
    • Set path to /
    • Finally, Click on ✔️ to create. website-create-blog

Because you did not set a repository, you will get a repository creation assistant. Select Hugo and click on Generate. website-template-hugo

Your new website has been created and the repo contains build scripts for a hugo-based website

Commit and Push

At this point, everything is happening inside a virtual file system hosting your repo on your browser. To make the network aware of the changes you need to push.

  • Click on the big green button on the bottom right push-btn This will open a modal that will guide you through three pages:
    • Configuration changes there you will see all the diffs related to resources. In addition to all the other resources you created, under Applications > blog > Websites you can see your newly created function.

    • Commit message there you should enter a commit message and click on Finish to push.

You will not see changes in the newly created website repository as those were pushed by the assistant earlier during creation.

Clone your website repo

Now that we have our config set, let’s focus on the website itself.

  • To open the created repository in Github click on the link icon. Skip to the next section if you know how to clone a Github repo. open-website-repo

  • On the Github page, copy the clone URI. My favorite is SSH, so we’ll go ahead and copy that. get-website-clone-uri

  • Assuming that you have your ssh keys set up correctly, let’s clone the repo. If you’re not sure about the ssh keys, read this.

    $ git clone
    Cloning into 'tb_website_hugo'...
    remote: Enumerating objects: 5, done.
    remote: Counting objects: 100% (5/5), done.
    remote: Compressing objects: 100% (3/3), done.
    remote: Total 5 (delta 0), reused 5 (delta 0), pack-reused 0
    Receiving objects: 100% (5/5), done.

  • Create a hugo site

    $ npx hugo-extended new site --force tb_website_hugo
    Congratulations! Your new Hugo site is created in /tmp/tb_website_hugo.
    Just a few more steps and you're ready to go:
    1. Download a theme into the same-named folder.
       Choose a theme from or
       create your own with the "hugo new theme <THEMENAME>" command.
    2. Perhaps you want to add some content. You can add single files
       with "hugo new <SECTIONNAME>/<FILENAME>.<FORMAT>".
    3. Start the built-in live server via "hugo server".
    Visit for quickstart guide and full documentation.
    Note that if you have hugo already installed, you can just run
    $ hugo new site --force tb_website_hugo

  • Change directory to the website repository

    $ cd tb_website_hugo

  • We’re going to use as theme. Start by cloning it as a sub module

    $ git submodule add -b main themes/blowfish
    Cloning into '/tmp/tb_website_hugo/themes/blowfish'...
    remote: Enumerating objects: 5296, done.
    remote: Counting objects: 100% (315/315), done.
    remote: Compressing objects: 100% (187/187), done.
    remote: Total 5296 (delta 161), reused 216 (delta 99), pack-reused 4981
    Receiving objects: 100% (5296/5296), 60.89 MiB | 4.08 MiB/s, done.
    Resolving deltas: 100% (2691/2691), done.

  • Open config.toml with your favorite IDE and make it look like:

    baseURL = ''
    languageCode = 'en-us'
    title = 'Blog running on Taubyte'
    theme = "blowfish"

  • Serve your website locally

    $ npx hugo-extended server
    Start building sites … 
    hugo v0.103.1-b665f1e8f16bf043b9d3c087a60866159d71b48d+extended linux/amd64 BuildDate=2022-09-18T13:19:01Z VendorInfo=gohugoio
                       | EN  
      Pages            |  7  
      Paginator pages  |  0  
      Non-page files   |  0  
      Static files     |  9  
      Processed images |  0  
      Aliases          |  0  
      Sitemaps         |  1  
      Cleaned          |  0  
    Built in 27 ms
    Watching for changes in /tmp/tb_website_hugo/{archetypes,content,data,layouts,static,themes}
    Watching for config changes in /tmp/tb_website_hugo/config.toml, /tmp/tb_website_hugo/themes/blowfish/config.toml, /tmp/tb_website_hugo/themes/blowfish/config/_default, /tmp/tb_website_hugo/go.mod
    Environment: "development"
    Serving pages from memory
    Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
    Web Server is available at http://localhost:1313/ (bind address
    Press Ctrl+C to stop

  • Navigate to http://localhost:1313/ to access the website locally.

  • Feel free to edit the content as you see fit


All you have to do now is push your code!

  • Commit

    $ git add .
    $ git commit -m 'My first hugo website'
    [master 14517b8] My first hugo website
     4 files changed, 15 insertions(+)
     create mode 100644 .gitmodules
     create mode 100644 archetypes/
     create mode 100644 config.toml
     create mode 160000 themes/blowfish

  • And Push

    $ git push
    Enumerating objects: 8, done.
    Counting objects: 100% (8/8), done.
    Delta compression using up to 8 threads
    Compressing objects: 100% (5/5), done.
    Writing objects: 100% (7/7), 757 bytes | 378.00 KiB/s, done.
    Total 7 (delta 0), reused 0 (delta 0), pack-reused 0
       f7a43c1..14517b8  master -> master


Each time you push code to Github, jobs to rebuild code and config are created by the network in response to the event. You can check those build jobs and their status on the Builds page. builds-page

For your website, you should see something like website-build-log

You can download the built website as well by clicking on the icon at the far right website-build-download

Access your website

Open your browser and check out your new blog/website! website-in-browser