docs/content/en/installation/linux.md
{{% include "/_common/installation/01-editions.md" %}}
{{% include "/_common/installation/02-prerequisites.md" %}}
{{% include "/_common/installation/03-prebuilt-binaries.md" %}}
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 control automatic updates:
# disable automatic updates
sudo snap refresh --hold hugo
# enable automatic updates
sudo snap refresh --unhold hugo
To control access to removable media:
# allow access
sudo snap connect hugo:removable-media
# revoke access
sudo snap disconnect hugo:removable-media
To control access to SSH keys:
# allow access
sudo snap connect hugo:ssh-keys
# revoke access
sudo snap disconnect hugo:ssh-keys
{{% include "/_common/installation/homebrew.md" %}}
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.
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
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
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.
To install the extended edition of Hugo on Exherbo:
Add this line to /etc/paludis/options.conf:
www-apps/hugo extended
Install using the Paludis package manager:
cave resolve -x repository/heirecka
cave resolve -x hugo
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
Derivatives of the Gentoo distribution of Linux include Calculate Linux, Funtoo, and others. To install the extended edition of Hugo:
Specify the extended USE flag in /etc/portage/package.use/hugo:
www-apps/hugo extended
Build using the Portage package manager:
sudo emerge www-apps/hugo
The NixOS distribution of Linux includes Hugo in its package repository. To install the extended edition of Hugo:
nix-env -iA nixos.hugo
Derivatives of the openSUSE distribution of Linux include GeckoLinux, Linux Karmada, and others. To install the extended edition of Hugo:
sudo zypper install hugo
The Solus distribution of Linux includes Hugo in its package repository. To install the extended edition of Hugo:
sudo eopkg install hugo
To install the extended edition of Hugo on Void Linux:
sudo xbps-install -S hugo
{{% include "/_common/installation/04-build-from-source.md" %}}
| Prebuilt binaries | Package managers | Repository packages | Build from source | |
|---|---|---|---|---|
| Easy to install? | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
| Easy to upgrade? | :heavy_check_mark: | :heavy_check_mark: | varies | :heavy_check_mark: |
| Easy to downgrade? | :heavy_check_mark: | :heavy_check_mark: 1 | varies | :heavy_check_mark: |
| Automatic updates? | :x: | varies 2 | :x: | :x: |
| Latest version available? | :heavy_check_mark: | :heavy_check_mark: | varies | :heavy_check_mark: |