DEV Community

JJ Asghar
JJ Asghar

Posted on • Originally published at on

IBM Code Engine and static hugo site


This is a tutorial/demo of getting hugo to work with code-enginefrom IBM Cloud.


  1. You need hugo installed, there’s a few different installation paths, check this out.
  2. Create a GitHub repostiory that you can push your hugo site to.


hugo static site generator

  1. First thing you need to do is create a example hugo site, you run the following command: NOTE : code-engine-hugo is just an example name
$ hugo new site code-engine-hugo
Congratulations! Your new Hugo site is created in /code-engine-hugo.

Just a few more steps and you're ready to go:

2. Download a theme into the same-named folder.
   Choose a theme from or
   create your own with the "hugo new theme <THEMENAME>" command.
3. Perhaps you want to add some content. You can add single files
   with "hugo new <SECTIONNAME>/<FILENAME>.<FORMAT>".
4. Start the built-in live server via "hugo server".

Visit for quickstart guide and full documentation.

Enter fullscreen mode Exit fullscreen mode
  1. Next test your site and create a git repository, follow these next directions:
$ cd /code-engine-hugo
$ git init
$ git submodule add themes/ananke
$ echo theme = \"ananke\" >> config.toml
$ hugo new posts/
$ vim content/posts/ # just fill it with dummy text
$ hugo server -D

Enter fullscreen mode Exit fullscreen mode

You should be able to see a site that says “My New Hugo Site”. The my-first-post.mdhas a draft: true, when you want to make it real change that to false.

Now when you make changes or add posts you can run hugo (without drafts) and the new site will be recreated in public/ in that directory.

Push your new site up to the GitHub repository and create the Dockerfile, and we’ll start configuring code engine next.

$ cd /code-engine-hugo
$ cat << EOF >> Dockerfile [45/104]
FROM klakegg/hugo:latest

ADD . /src


ENTRYPOINT ["hugo", "server", "--port", "8080"]
$ git add .
$ git commit -m "inital commit"
$ git push origin main

Enter fullscreen mode Exit fullscreen mode
  1. Just as a sanity check, lets verify that the container we have/built will work locally. Run the following commands and to test it:
$ docker build -t jjasghar/code-engine-hugo-example .
$ docker run -it --rm -p 8080:8080 jjasghar/code-engine-hugo-example:latest server
Start building sites …

                   | EN
  Pages | 7
  Paginator pages | 0
  Non-page files | 0
  Static files | 1
  Processed images | 0
  Aliases | 0
  Sitemaps | 1
  Cleaned | 0

Built in 23 ms
Watching for changes in /src/{archetypes,content,data,layouts,static,themes}
Watching for config changes in /src/config.toml, /src/themes/ananke/config.yaml
Environment: "DEV"
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

# In another terminal/webbrowser:
$ open localhost:8080

Enter fullscreen mode Exit fullscreen mode

code-engine serverless platform

Now that we have our repository on GitHub, login to the IBM Cloudconsole. console

You should come to the [overview][codeengine-overview] page. overview

Now take your repository from above and add it to the “Start with source code” entry box. githubAnd click “Start creating”

If you haven’t created a project yet, create one where I’m pointing to, or select one like I have as “jjtesting”. project

Scroll down and click the “Specifiy build details” and put in / as your root directory. hugo needs to be able to find the config.toml file.

You’ll need to make sure it can see your Dockerfile and add your credentails to Docker Hub. This will create a repository for you and push this container to it.

Click “Done”, and “Create.”

Now if you open up the application URL you should have the hugo site!

Discussion (0)