2013-07-06 19:36:30 -04:00
|
|
|
|
---
|
2014-05-29 18:42:05 -04:00
|
|
|
|
aliases:
|
|
|
|
|
- /doc/installing/
|
|
|
|
|
date: 2013-07-01
|
2014-04-23 03:00:11 -04:00
|
|
|
|
menu:
|
|
|
|
|
main:
|
2014-05-29 18:42:05 -04:00
|
|
|
|
parent: getting started
|
|
|
|
|
next: /overview/usage
|
|
|
|
|
prev: /overview/quickstart
|
|
|
|
|
title: Installing Hugo
|
|
|
|
|
weight: 20
|
2013-07-08 17:57:01 -04:00
|
|
|
|
---
|
2013-07-06 19:36:30 -04:00
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
Hugo is written in Go with support for Windows, Linux, FreeBSD and OS X.
|
2013-07-04 11:32:55 -04:00
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
The latest release can be found at [Hugo Releases](https://github.com/spf13/hugo/releases).
|
|
|
|
|
We currently build for Windows, Linux, FreeBSD and OS X for x64
|
|
|
|
|
and i386 architectures.
|
2013-07-04 11:32:55 -04:00
|
|
|
|
|
2013-07-24 11:43:23 -04:00
|
|
|
|
## Installing Hugo (binary)
|
|
|
|
|
|
2013-07-05 00:35:11 -04:00
|
|
|
|
Installation is very easy. Simply download the appropriate version for your
|
2014-08-31 07:08:36 -04:00
|
|
|
|
platform from [Hugo Releases](https://github.com/spf13/hugo/releases).
|
2013-07-24 11:43:23 -04:00
|
|
|
|
Once downloaded it can be run from anywhere. You don't need to install
|
2013-07-05 00:35:11 -04:00
|
|
|
|
it into a global location. This works well for shared hosts and other systems
|
|
|
|
|
where you don't have a privileged account.
|
2013-07-04 11:32:55 -04:00
|
|
|
|
|
2014-09-22 19:58:30 -04:00
|
|
|
|
Ideally you should install it somewhere in your path for easy use. `/usr/local/bin`
|
2013-07-04 11:32:55 -04:00
|
|
|
|
is the most probable location.
|
|
|
|
|
|
2014-09-22 19:58:30 -04:00
|
|
|
|
If you have [Homebrew](http://brew.sh), installation is even easier. Just run
|
|
|
|
|
`brew install hugo`.
|
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
### Installing Pygments (optional)
|
2014-04-08 11:15:56 -04:00
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
The Hugo executable has one *optional* external dependency for source code highlighting (Pygments).
|
2014-04-08 11:15:56 -04:00
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
If you want to have source code highlighting using the [highlight shortcode](/extras/highlighting),
|
|
|
|
|
you need to install the Python-based Pygments program. The procedure is outlined on the [Pygments home page](http://pygments.org).
|
2013-07-04 13:03:16 -04:00
|
|
|
|
|
2014-05-27 18:32:57 -04:00
|
|
|
|
## Upgrading Hugo
|
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
Upgrading Hugo is as easy as downloading and replacing the executable you’ve
|
2014-05-27 18:32:57 -04:00
|
|
|
|
placed in your path.
|
|
|
|
|
|
|
|
|
|
|
2013-07-04 13:03:16 -04:00
|
|
|
|
## Installing from source
|
|
|
|
|
|
2013-07-19 01:27:21 -04:00
|
|
|
|
### Dependencies
|
|
|
|
|
|
2013-07-24 11:43:23 -04:00
|
|
|
|
* Git
|
|
|
|
|
* Go 1.1+
|
|
|
|
|
* Mercurial
|
|
|
|
|
* Bazaar
|
2013-07-04 13:03:16 -04:00
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
### Get directly from GitHub:
|
2013-07-24 11:43:23 -04:00
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
go get -v github.com/spf13/hugo
|
2013-07-04 13:03:16 -04:00
|
|
|
|
|
2013-07-19 01:27:21 -04:00
|
|
|
|
### Building Hugo
|
|
|
|
|
|
2013-07-24 11:43:23 -04:00
|
|
|
|
cd /path/to/hugo
|
2013-07-19 01:27:21 -04:00
|
|
|
|
go build -o hugo main.go
|
2013-07-24 11:43:23 -04:00
|
|
|
|
mv hugo /usr/local/bin/
|
|
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
2014-08-31 07:08:36 -04:00
|
|
|
|
Please see the [contributing guide](/doc/contributing).
|