hugo/docs/content/commands/hugo_server.md

84 lines
4 KiB
Markdown
Raw Normal View History

---
2016-12-20 08:39:12 +00:00
date: 2016-12-20T09:38:40+01:00
title: "hugo server"
slug: hugo_server
url: /commands/hugo_server/
---
## hugo server
2015-11-25 22:11:16 +00:00
A high performance webserver
### Synopsis
2015-11-25 22:11:16 +00:00
Hugo provides its own webserver which builds and serves the site.
While hugo server is high performance, it is a webserver with limited options.
Many run it in production, but the standard behavior is for people to use it
in development and use a more full featured server such as Nginx or Caddy.
'hugo server' will avoid writing the rendered and served content to disk,
preferring to store it in memory.
By default hugo will also watch your files for any changes you make and
automatically rebuild the site. It will then live reload any open browser pages
and push the latest content to them. As most Hugo sites are built in a fraction
of a second, you will be able to save and see your changes nearly instantly.
```
hugo server
```
### Options
```
2016-12-20 08:39:12 +00:00
--appendPort append port to baseURL (default true)
2016-04-09 21:01:55 +00:00
-b, --baseURL string hostname (and path) to the root, e.g. http://spf13.com/
--bind string interface to which the server will bind (default "127.0.0.1")
-D, --buildDrafts include content marked as draft
2016-06-22 12:03:18 +00:00
-E, --buildExpired include expired content
2016-04-09 21:01:55 +00:00
-F, --buildFuture include content with publishdate in the future
--cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
--canonifyURLs if true, all relative URLs will be canonicalized using baseURL
--cleanDestinationDir Remove files from destination not found in static directories
-c, --contentDir string filesystem path to content directory
-d, --destination string filesystem path to write files to
2016-06-22 12:03:18 +00:00
--disable404 Do not render 404 page
2016-04-09 21:01:55 +00:00
--disableLiveReload watch without enabling live browser reload on rebuild
--disableRSS Do not build RSS files
--disableSitemap Do not build Sitemap file
2016-12-20 08:39:12 +00:00
--enableGitInfo Add Git revision, date and author info to the pages
2016-04-09 21:01:55 +00:00
--forceSyncStatic Copy all files when static is changed.
2016-10-05 08:23:45 +00:00
--i18n-warnings Print missing translations
2016-06-22 12:03:18 +00:00
--ignoreCache Ignores the cache directory
2016-04-09 21:01:55 +00:00
-l, --layoutDir string filesystem path to layout directory
2016-10-05 08:23:45 +00:00
--meminterval string interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")
2016-04-09 21:01:55 +00:00
--memstats string log memory usage to this file
--noChmod Don't sync permission mode of files
2016-04-09 21:01:55 +00:00
--noTimes Don't sync modification time of files
--pluralizeListTitles Pluralize titles in lists using inflect (default true)
-p, --port int port on which the server will listen (default 1313)
--preserveTaxonomyNames Preserve taxonomy names as written ("Gérard Depardieu" vs "gerard-depardieu")
--renderToDisk render to Destination path (default is render to memory & serve from there)
-s, --source string filesystem path to read files relative from
--stepAnalysis display memory and timing of different steps of the program
-t, --theme string theme to use (located in /themes/THEMENAME/)
--uglyURLs if true, use /filename.html instead of /filename/
-w, --watch watch filesystem for changes and recreate as needed (default true)
```
### Options inherited from parent commands
```
2016-10-05 08:23:45 +00:00
--config string config file (default is path/config.yaml|json|toml)
2016-04-09 21:01:55 +00:00
--log Enable Logging
--logFile string Log File path (if set, logging enabled automatically)
2016-12-20 08:39:12 +00:00
--quiet build in quiet mode
2016-04-09 21:01:55 +00:00
-v, --verbose verbose output
--verboseLog verbose logging
```
### SEE ALSO
* [hugo](/commands/hugo/) - hugo builds your site
2016-12-20 08:39:12 +00:00
###### Auto generated by spf13/cobra on 20-Dec-2016