hugo/docs/content/en/installation/linux.md

title	description	categories	keywords	menu	weight	toc
Linux	Install Hugo on Linux.	installation		docs parent weight installation 30	30	true

Editions

{{% include "installation/_common/01-editions.md" %}}

Unless your specific deployment needs require the extended/deploy edition, we recommend the extended edition.

{{% include "installation/_common/02-prerequisites.md" %}}

{{% include "installation/_common/03-prebuilt-binaries.md" %}}

Package managers

Snap

Snap is a free and open-source package manager for Linux. Available for most distributions, snap packages are simple to install and are automatically updated.

The Hugo snap package is strictly confined. Strictly confined snaps run in complete isolation, up to a minimal access level that’s deemed always safe. The sites you create and build must be located within your home directory, or on removable media.

To install the extended edition of Hugo:

sudo snap install hugo

To enable or revoke access to removable media:

sudo snap connect hugo:removable-media
sudo snap disconnect hugo:removable-media

To enable or revoke access to SSH keys:

sudo snap connect hugo:ssh-keys
sudo snap disconnect hugo:ssh-keys

{{% include "installation/_common/homebrew.md" %}}

Repository packages

Most Linux distributions maintain a repository for commonly installed applications.

{{% note %}} The Hugo version available in package repositories varies based on Linux distribution and release, and in some cases will not be the latest version.

Use one of the other installation methods if your package repository does not provide the desired version.

{{% /note %}}

Alpine Linux

To install the extended edition of Hugo on Alpine Linux:

doas apk add --no-cache --repository=https://dl-cdn.alpinelinux.org/alpine/edge/community hugo

Arch Linux

Derivatives of the Arch Linux distribution of Linux include EndeavourOS, Garuda Linux, Manjaro, and others. To install the extended edition of Hugo:

sudo pacman -S hugo

Debian

Derivatives of the Debian distribution of Linux include elementary OS, KDE neon, Linux Lite, Linux Mint, MX Linux, Pop!_OS, Ubuntu, Zorin OS, and others. To install the extended edition of Hugo:

sudo apt install hugo

You can also download Debian packages from the [latest release] page.

Exherbo

To install the extended edition of Hugo on Exherbo:

1. Add this line to /etc/paludis/options.conf:

   www-apps/hugo extended
   

2. Install using the Paludis package manager:

   cave resolve -x repository/heirecka
   cave resolve -x hugo
   

Fedora

Derivatives of the Fedora distribution of Linux include CentOS, Red Hat Enterprise Linux, and others. To install the extended edition of Hugo:

sudo dnf install hugo

Gentoo

Derivatives of the Gentoo distribution of Linux include Calculate Linux, Funtoo, and others. To install the extended edition of Hugo:

1. Specify the extended USE flag in /etc/portage/package.use/hugo:

   www-apps/hugo extended
   

2. Build using the Portage package manager:

   sudo emerge www-apps/hugo
   

NixOS

The NixOS distribution of Linux includes Hugo in its package repository. To install the extended edition of Hugo:

nix-env -iA nixos.hugo

openSUSE

Derivatives of the openSUSE distribution of Linux include GeckoLinux, Linux Karmada, and others. To install the extended edition of Hugo:

sudo zypper install hugo

Solus

The Solus distribution of Linux includes Hugo in its package repository. To install the extended edition of Hugo:

sudo eopkg install hugo

{{% include "installation/_common/04-build-from-source.md" %}}

Comparison

	Prebuilt binaries	Package managers	Repository packages	Build from source
Easy to install?	✔️	✔️	✔️	✔️
Easy to upgrade?	✔️	✔️	varies	✔️
Easy to downgrade?	✔️	✔️ 1	varies	✔️
Automatic updates?	❌	varies 2	❌	❌
Latest version available?	✔️	✔️	varies	✔️

---

1. Easy if a previous version is still installed. ↩︎

2. Snap packages are automatically updated. Homebrew requires advanced configuration. ↩︎