2013-07-06 23:36:30 +00:00
|
|
|
|
---
|
2014-05-29 22:42:05 +00:00
|
|
|
|
aliases:
|
|
|
|
|
- /doc/installing/
|
|
|
|
|
date: 2013-07-01
|
2014-04-23 07:00:11 +00:00
|
|
|
|
menu:
|
|
|
|
|
main:
|
2014-05-29 22:42:05 +00:00
|
|
|
|
parent: getting started
|
|
|
|
|
next: /overview/usage
|
|
|
|
|
prev: /overview/quickstart
|
|
|
|
|
title: Installing Hugo
|
|
|
|
|
weight: 20
|
2013-07-08 21:57:01 +00:00
|
|
|
|
---
|
2013-07-06 23:36:30 +00:00
|
|
|
|
|
2014-03-24 11:19:25 +00:00
|
|
|
|
Hugo is written in Go with support for Windows, Linux, FreeBSD and OSX.
|
2013-07-04 15:32:55 +00:00
|
|
|
|
|
2013-07-05 04:37:59 +00:00
|
|
|
|
The latest release can be found at [hugo releases](https://github.com/spf13/hugo/releases).
|
2013-07-05 04:35:11 +00:00
|
|
|
|
We currently build for Windows, Linux, FreeBSD and OS X for x64
|
|
|
|
|
and 386 architectures.
|
2013-07-04 15:32:55 +00:00
|
|
|
|
|
2013-07-24 15:43:23 +00:00
|
|
|
|
## Installing Hugo (binary)
|
|
|
|
|
|
2013-07-05 04:35:11 +00:00
|
|
|
|
Installation is very easy. Simply download the appropriate version for your
|
2013-07-24 15:43:23 +00:00
|
|
|
|
platform from [hugo releases](https://github.com/spf13/hugo/releases).
|
|
|
|
|
Once downloaded it can be run from anywhere. You don't need to install
|
2013-07-05 04:35:11 +00: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 15:32:55 +00:00
|
|
|
|
|
2013-07-05 04:35:11 +00:00
|
|
|
|
Ideally you should install it somewhere in your path for easy use. `/usr/local/bin`
|
2013-07-04 15:32:55 +00:00
|
|
|
|
is the most probable location.
|
|
|
|
|
|
2014-05-27 22:32:57 +00:00
|
|
|
|
### Installing pygments (optional)
|
2014-04-08 15:15:56 +00:00
|
|
|
|
|
2014-05-27 22:32:57 +00:00
|
|
|
|
The Hugo executable has one *optional* external dependency for source code highlighting (pygments).
|
2014-04-08 15:15:56 +00: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 17:03:16 +00:00
|
|
|
|
|
2014-05-27 22:32:57 +00:00
|
|
|
|
## Upgrading Hugo
|
|
|
|
|
|
|
|
|
|
Upgrading hugo is as easy as downloading and replacing the executable you’ve
|
|
|
|
|
placed in your path.
|
|
|
|
|
|
|
|
|
|
|
2013-07-04 17:03:16 +00:00
|
|
|
|
## Installing from source
|
|
|
|
|
|
2013-07-19 05:27:21 +00:00
|
|
|
|
### Dependencies
|
|
|
|
|
|
2013-07-24 15:43:23 +00:00
|
|
|
|
* Git
|
|
|
|
|
* Go 1.1+
|
|
|
|
|
* Mercurial
|
|
|
|
|
* Bazaar
|
2013-07-04 17:03:16 +00:00
|
|
|
|
|
2013-07-24 15:43:23 +00:00
|
|
|
|
### Get directly from Github:
|
|
|
|
|
|
|
|
|
|
go get github.com/spf13/hugo
|
2013-07-04 17:03:16 +00:00
|
|
|
|
|
2013-07-19 05:27:21 +00:00
|
|
|
|
### Building Hugo
|
|
|
|
|
|
2013-07-24 15:43:23 +00:00
|
|
|
|
cd /path/to/hugo
|
2013-07-19 05:27:21 +00:00
|
|
|
|
go build -o hugo main.go
|
2013-07-24 15:43:23 +00:00
|
|
|
|
mv hugo /usr/local/bin/
|
|
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
2013-08-03 07:30:34 +00:00
|
|
|
|
Please see the [contributing guide](/doc/contributing)
|