mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
e7ff094d63
The tutorial for installing on windows didn't mention the exact name of the hugo executable in windows which is generally hugo_<hugo-version>_windows_<arch>.exe. The tutorial mentioned the windows executable's name as hugo.exe, which can be confusing sometimes. So extra information has been added to rename the executable to hugo.exe which would be easy to use. Fixes #2656
123 lines
6.5 KiB
Markdown
123 lines
6.5 KiB
Markdown
---
|
||
author: "Michael Henderson"
|
||
lastmod: 2016-07-18
|
||
date: 2015-03-30
|
||
linktitle: Installing on Windows
|
||
toc: true
|
||
menu:
|
||
main:
|
||
parent: tutorials
|
||
next: /tutorials/mathjax
|
||
prev: /tutorials/installing-on-mac
|
||
title: Installing on Windows
|
||
weight: 10
|
||
---
|
||
|
||
# Installing Hugo on Windows
|
||
|
||
This tutorial aims to be a complete guide to installing Hugo on your Windows computer.
|
||
|
||
## Assumptions
|
||
|
||
1. We'll call your website `example.com` for the purpose of this tutorial.
|
||
2. You will use `C:\Hugo\Sites` as the starting point for your site.
|
||
3. You will use `C:\Hugo\bin` to store executable files.
|
||
|
||
## Setup Your Directories
|
||
|
||
You'll need a place to store the Hugo executable, your content (the files that you build), and the generated files (the HTML that Hugo builds for you).
|
||
|
||
1. Open Windows Explorer.
|
||
2. Create a new folder: `C:\Hugo` (assuming you want Hugo on your C drive – it can go anywhere.)
|
||
3. Create a subfolder in the Hugo folder: `C:\Hugo\bin`.
|
||
4. Create another subfolder in Hugo: `C:\Hugo\Sites`.
|
||
|
||
## Technical users
|
||
|
||
1. Download the latest zipped Hugo executable from the [Hugo Releases](https://github.com/spf13/hugo/releases) page.
|
||
2. Extract all contents to your `..\Hugo\bin` folder.
|
||
3. The hugo executable will be named as `hugo_hugo-version_platform_arch.exe`. Rename that executable to `hugo.exe` for ease of use.
|
||
4. In PowerShell or your preferred CLI, add the `hugo.exe` executable to your PATH by navigating to `C:\Hugo\bin` (or the location of your hugo.exe file) and use the command `set PATH=%PATH%;C:\Hugo\bin`. If the `hugo` command does not work after a reboot, you may have to run the command prompt as administrator.
|
||
|
||
## Less technical users
|
||
|
||
1. Go the [Hugo Releases](https://github.com/spf13/hugo/releases) page.
|
||
2. The latest release is announced on top. Scroll to the bottom of the release announcement to see the downloads. They're all ZIP files.
|
||
3. Find the Windows files near the bottom (they're in alphabetical order, so Windows is last) – download either the 32-bit or 64-bit file depending on whether you have 32-bit or 64-bit Windows. (If you don't know, [see here](https://esupport.trendmicro.com/en-us/home/pages/technical-support/1038680.aspx).)
|
||
4. Move the ZIP file into your `C:\Hugo\bin` folder.
|
||
5. Double-click on the ZIP file and extract its contents. Be sure to extract the contents into the same `C:\Hugo\bin` folder – Windows will do this by default unless you tell it to extract somewhere else.
|
||
6. You should now have three new files: hugo executable (example: hugo_0.18_windows_amd64.exe), license.md, and readme.md. (you can delete the ZIP download now.). Rename that hugo executable (hugo_hugo-version_platform_arch.exe) to hugo.exe for ease of use.
|
||
7. Now add Hugo to your Windows PATH settings:
|
||
|
||
### For Windows 10 users:
|
||
|
||
- Right click on the **Start** button.
|
||
- Click on **System**.
|
||
- Click on **Advanced System Settings** on the left.
|
||
- Click on the **Environment Variables...** button on the bottom.
|
||
- In the User variables section, find the row that starts with PATH (PATH will be all caps).
|
||
- Double-click on **PATH**.
|
||
- Click the **New...** button.
|
||
- Type in the folder where `hugo.exe` was extracted, which is `C:\Hugo\bin` if you went by the instructions above. *The PATH entry should be the folder where Hugo lives, not the binary.* Press <kbd>Enter</kbd> when you're done typing.
|
||
- Click OK at every window to exit.
|
||
|
||
> <small>Note that the path editor in Windows 10 was added in the large [November 2015 Update](https://blogs.windows.com/windowsexperience/2015/11/12/first-major-update-for-windows-10-available-today/). You'll need to have that or a later update installed for the above steps to work. You can see what Windows 10 build you have by clicking on the <i class="fa fa-windows"></i> Start button → Settings → System → About. See [here](http://www.howtogeek.com/236195/how-to-find-out-which-build-and-version-of-windows-10-you-have/) for more.)</small>
|
||
|
||
### For Windows 7 and 8.x users:
|
||
|
||
Windows 7 and 8.1 do not include the easy path editor included in Windows 10, so non-technical users on those platforms are advised to install a free third-party path editor like [Windows Environment Variables Editor](http://eveditor.com/) or [Path Editor](https://patheditor2.codeplex.com/).
|
||
|
||
## Verify the executable
|
||
|
||
Run a few commands to verify that the executable is ready to run, and then build a sample site to get started.
|
||
|
||
1. Open a command prompt window.
|
||
|
||
2. At the prompt, type `hugo help` and press the <kbd>Enter</kbd> key. You should see output that starts with:
|
||
|
||
{{< nohighlight >}}hugo is the main command, used to build your Hugo site.
|
||
|
||
Hugo is a Fast and Flexible Static Site Generator
|
||
built with love by spf13 and friends in Go.
|
||
|
||
Complete documentation is available at http://gohugo.io/.
|
||
{{< /nohighlight >}}
|
||
|
||
If you do, then the installation is complete. If you don't, double-check the path that you placed the `hugo.exe` file in and that you typed that path correctly when you added it to your PATH variable. If you're still not getting the output, post a note on the Hugo discussion list (in the `Support` topic) with your command and the output.
|
||
|
||
3. At the prompt, change your directory to the `Sites` directory.
|
||
|
||
{{< nohighlight >}}C:\Program Files> cd C:\Hugo\Sites
|
||
C:\Hugo\Sites>
|
||
{{< /nohighlight >}}
|
||
|
||
4. Run the command to generate a new site. I'm using `example.com` as the name of the site.
|
||
|
||
{{< nohighlight >}}C:\Hugo\Sites> hugo new site example.com
|
||
{{< /nohighlight >}}
|
||
|
||
5. You should now have a directory at `C:\Hugo\Sites\example.com`. Change into that directory and list the contents. You should get output similar to the following:
|
||
|
||
{{< nohighlight >}}C:\Hugo\Sites>cd example.com
|
||
C:\Hugo\Sites\example.com>dir
|
||
Directory of C:\hugo\sites\example.com
|
||
|
||
04/13/2015 10:44 PM <DIR> .
|
||
04/13/2015 10:44 PM <DIR> ..
|
||
04/13/2015 10:44 PM <DIR> archetypes
|
||
04/13/2015 10:44 PM 83 config.toml
|
||
04/13/2015 10:44 PM <DIR> content
|
||
04/13/2015 10:44 PM <DIR> data
|
||
04/13/2015 10:44 PM <DIR> layouts
|
||
04/13/2015 10:44 PM <DIR> static
|
||
1 File(s) 83 bytes
|
||
7 Dir(s) 6,273,331,200 bytes free
|
||
{{< /nohighlight >}}
|
||
|
||
You now have Hugo installed and a site to work with. You need to add a layout (or theme), then create some content. Go to http://gohugo.io/overview/quickstart/ for steps on doing that.
|
||
|
||
## Troubleshooting
|
||
|
||
@dhersam has created a nice video on common issues:
|
||
|
||
{{< youtube c8fJIRNChmU >}}
|