Installing the Ananke Theme for Hugo #
There are two primary ways to install Ananke:
- Hugo Module — Uses Hugo’s built-in Go module system to fetch and manage the theme as a package.
- Git Submodule — Links the theme repository as a submodule inside your Hugo project.
If you’re following the Hugo Quickstart guide, you’ll notice that it currently recommends installing the Ananke theme as a Git submodule. While this is a valid approach, Hugo also offers a more powerful alternative: Hugo Modules, which leverage Go’s module system for better dependency management.
We prefer the Hugo Module approach, as it provides a more flexible and future-proof way to manage themes.
[!NOTE] Already using Ananke from the old
theNewDynamicrepository? See Migration from theNewDynamic to update your references togithub.com/gohugo-ananke/ananke.
Comparison: Hugo Module vs. Git Submodule #
| Method | Pros | Cons | Sample Repo |
|---|---|---|---|
| Hugo Module (Preferred) | Easier version management, automatic updates, better integration | Requires Go installed and initial setup | Sample Repo |
| Git Submodule | Simple if you are used to working with Git | Requires manual updates, can be tricky with Git workflows | Sample Repo |
Installation as a Hugo Module (recommended)
Hugo Module based installation for the Ananke theme for Hugo.
Methods #
Requirements #
- Install Hugo (extended or extended/deploy edition, 0.128.0 or later)
- Install Git
- Install Golang
Installation #
To install or create a Hugo website from scratch with the Ananke theme using the Hugo Module method, follow these steps:
Installation as Git Submodule
Git Submodule based installation for the Ananke theme for Hugo.
Methods #
Requirements #
- Install Hugo (extended or extended/deploy edition, 0.128.0 or later)
- Install Git
Installation #
To install or create a Hugo website from scratch with the Ananke theme using the submodule method, follow these steps:
Upgrading from theNewDynamic to gohugo-ananke
- What changed
- Migrate a Hugo Module install
- Migrate a Git submodule install
- Confirm the theme is loaded
- Common failure cases
Ananke moved to its own organisation in April 2026. The repository changed from: github.com/theNewDynamic/gohugo-theme-ananke to github.com/gohugo-ananke/ananke.
Both URLs still resolve for now, so existing sites will keep building, but you should update your references so future updates come from the new location.
What changed #
- Organisation and repository name changed as shown above.
- Module path changed from
github.com/theNewDynamic/gohugo-theme-ananke/v2togithub.com/gohugo-ananke/ananke/v2. The/v2suffix is unchanged and still required for the latest theme on the v2 branch. - Installation methods are unchanged. If you are installing fresh rather than migrating, follow Install as Hugo Module or Install as Git Submodule instead of this page.
Migrate a Hugo Module install #
Search your site configuration for the old module path and replace every
instance of github.com/theNewDynamic/gohugo-theme-ananke/v2 with github.com/gohugo-ananke/ananke/v2.