5.9 KiB
aliases:
- /doc/installing/ lastmod: 2016-01-04 date: 2013-07-01 menu: main: parent: getting started next: /overview/usage prev: /overview/quickstart title: Installing Hugo weight: 20
Hugo is written in Go with support for multiple platforms.
The latest release can be found at Hugo Releases. We currently provide pre-built binaries for Windows, Linux, FreeBSD and OS X (Darwin) for x64, i386 and ARM architectures.
Hugo may also be compiled from source wherever the Go compiler tool chain can run, e.g. for other operating systems including DragonFly BSD, OpenBSD, Plan 9 and Solaris. See http://golang.org/doc/install/source for the full set of supported combinations of target operating systems and compilation architectures.
Installing Hugo (binary)
Installation is very easy. Simply download the appropriate version for your platform from Hugo Releases. Once downloaded it can be run from anywhere. You don't need to install it into a global location. This works well for shared hosts and other systems where you don't have a privileged account.
Ideally, you should install it somewhere in your PATH for easy use.
/usr/local/bin is the most probable location.
On macOS, if you have Homebrew, installation is even
easier: just run brew install hugo.
For a more detailed explanation follow the corresponding installation guides:
- [Installation on macOS]({{< relref "tutorials/installing-on-mac.md" >}})
- [Installation on Windows]({{< relref "tutorials/installing-on-windows.md" >}})
Installing Pygments (optional)
The Hugo executable has one optional external dependency for source code highlighting (Pygments).
If you want to have source code highlighting using the highlight shortcode, you need to install the Python-based Pygments program. The procedure is outlined on the Pygments home page.
Upgrading Hugo
Upgrading Hugo is as easy as downloading and replacing the executable you’ve
placed in your PATH.
On macOS, if you have Homebrew, upgrading is even
easier: just run brew upgrade hugo.
Installing Hugo on Linux from native packages
Arch Linux
You can install Hugo from the Arch user repository on Arch Linux or derivatives such as Manjaro.
sudo pacman -S yaourt
yaourt -S hugo
Be aware that Hugo is built from source. This means that additional tools like Git and Go will be installed as well.
Debian and Ubuntu
Hugo has been included in Debian and Ubuntu since 2016, and thus installing Hugo is as simple as:
sudo apt install hugo
Pros:
- Native Debian/Ubuntu package maintained by Debian Developers
- Pre-installed bash completion script and man pages for best interactive experience
Cons:
- Might not be the latest version, especially if you are using an older stable version (e.g., Ubuntu 16.04 LTS). Until backports and PPA are available, you may consider installing the Hugo snap package to get the latest version of Hugo, as described below.
Fedora, CentOS and Red Hat
- https://copr.fedorainfracloud.org/coprs/daftaupe/hugo/ : updated as soon as possible after the official Hugo release.
- https://copr.fedorainfracloud.org/coprs/spf13/Hugo/ (updated to Hugo v0.16)
See also this discussion.
Alternate Installation Methods
Snap Package
In any of the Linux distributions that support snaps:
snap install hugo
Note: Hugo-as-a-snap can write only inside the user’s
$HOMEdirectory—and gvfs-mounted directories owned by the user—because of Snaps’ confinement and security model. More information is also available in this related GitHub issue.
Docker Image (unofficial)
Docker Hugo is a Docker image that can be used for local development but more importantly, can be easily used for continuous integration builds of your Hugo site on CircleCI or Travis CI. Source available on GitHub.
Installing from source
Prerequisite tools for downloading and building source code
Vendored Dependencies
Hugo uses govendor to vendor dependencies, but we don't commit the vendored packages themselves to the Hugo git repository.
Therefore, a simple go get is not supported since go get is not vendor-aware.
You must use govendor to fetch Hugo's dependencies.
Fetch from GitHub
The commands below assume that you have [Go](https://golang.org/dl/) installed with your `$GOPATH` set.
go get github.com/kardianos/govendor
govendor get github.com/gohugoio/hugo
govendor get will fetch Hugo and all its dependent libraries to
$GOPATH/src/github.com/gohugoio/hugo, and compile everything into a final hugo
(or hugo.exe) executable, which you will find sitting inside
$GOPATH/go/bin/, all ready to go!
Windows users: where you see the $HOME environment variable above, replace it with %USERPROFILE%.
Note: For syntax highlighting using the highlight shortcode, you need to install the Python-based Pygments program.
Contributing
Please see the contributing guide if you are interested in working with the Hugo source or contributing to the project in any way.