hugo/docs/content/overview/installing.md
Anthony Fok ba44e860a3 [Docs] Copyediting
* Add meta author, description and generator tags
 * Add Hugo version beside the logo and in the footer
 * Suggest the user to run `go get -u -v` to update dependencies
 * Requires Go 1.3+ rather than Go 1.1+
 * Improve rendering/formatting in some places
 * Add trailing slash to URLs where appropriate
 * GitHub redirects all http requests to https, update accordingly
2015-01-28 18:02:40 -07:00

2.3 KiB
Raw Blame History

aliases date menu next prev title weight
/doc/installing/
2013-07-01
main
parent
getting started
/overview/usage /overview/quickstart Installing Hugo 20

Hugo is written in Go with support for multiple platforms.

The latest release can be found at Hugo Releases. We currently build for  Windows,  Linux,  FreeBSD and  OS X for x64 and i386 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 OS X, if you have Homebrew, installation is even easier: just run brew install hugo.

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 youve placed in your PATH.

Installing from source

Dependencies

  • Git
  • Go 1.1+ (Go 1.4+ on Windows, see Go Issue #8090)
  • Mercurial
  • Bazaar

Get directly from GitHub

$ export GOPATH=$HOME/go
$ go get -v github.com/spf13/hugo

go get will then fetch Hugo and all its dependent libraries to your $GOPATH/src directory, and compile everything into the final hugo (or hugo.exe) executable, which you will find sitting in the $GOPATH/bin/ directory, all ready to go!

You may run go get with the -u option to update Hugo's dependencies:

$ go get -u -v github.com/spf13/hugo

Contributing

Please see the contributing guide.