Installation

2 mins

Simply follow the standard Hugo Quick Start procedure to get up and running quickly.

Detailed instructions can be found below.

Install Hugo #

You can find specific instructions for your platform in the official Hugo docs.

Make sure you are using Hugo version 0.86.1 or later as the theme takes advantage of some of the latest Hugo features.

Create a new site #

Run the command hugo new site mywebsite to create a new Hugo site in a folder named mywebsite.

Download the Congo theme #

There are a couple of ways to install the Congo theme into your Hugo website. The git method is the easiest to keep the theme up-to-date, but you can also download and install manually if you don’t have git available.

Install using git #

Change into the directory for your Hugo website, initialise a new repository and add Congo as a submodule.

cd mywebsite
git init
git submodule add -b stable https://github.com/jpanther/Congo.git themes/congo

Note: You need to substitute mywebsite for the correct folder name you used in Step 2.

Install manually #

Download the latest release of the theme.

Extract the archive, rename the folder to congo and move it to the themes/ directory inside your your mywebsite folder.

Note: You need to substitute mywebsite for the correct folder name you used in Step 2.

Set up your configuration files #

In the root folder of your website, delete the config.toml file that was generated by Hugo. Copy the entire config folder from themes/congo/config/ into the root of your website. This will ensure you have all the correct theme settings and will enable you to easily customise the theme.

You’re now all set up to use Congo. From here you can add some content and start the Hugo server.

Refer to the Hugo docs for more information or read the next section to learn more about configuring the theme.