Remote Container

Run Hugo locally using only Visual Studio Code and the Remote Container extension.


Sometimes you want to make a larger, more complex change to the site and want to be able to build and run it locally to verify changes manually.

It can be a pain to set up the build infrastructure locally for any project, especially when dealing with a mixture of technologies and versions.

Thankfully Azure Citadel makes use of Visual Studio Code - Remote Containers to make this easier.

On your local computer you will still need the following tools set up, however they are not specific to this one repository and can be re-used for every project that makes use of Remote Containers.

If this is still too much infrastructure to maintain or you are in an environment that restricts what can be installed and run locally, you should look at using a cloud-hosted instance of the container using GitHub Codespaces.

Running Locally

Checkout Code

From a terminal run the following.

git clone
code azurecitadel

Re-open in container

Use the Remote Container extension to open this project in VS Code, as shown in the following video

Install Dependencies

Open a new terminal window in VS Code and run the following command to install dependencies

npm install

Serve content

In the terminal window, tell Static Web Apps to start serving the local content

swa start http://localhost:1313 --run "hugo server"

Run hugo serve

Technical Details

You can follow links to see exactly what is being run when running inside a remote container.

Help us improve

Azure Citadel is a community site built on GitHub, please contribute and send a pull request

 Make a change