JEKYLL_SERVE(1)

💖 JEKYLL_SERVE — the bestie manual page 💖

okay so real talk: this is the jekyll_serve manual page, part of the Jekyll family of docs. Jekyll is a blog-aware, static site generator — yes she builds whole sites out of vibes and Markdown, and yes she's iconic for it. 🎀

This page is specifically about the serve subcommand, aka the one that spins up a local server so you can actually look at your site instead of just trusting the process. 👑

✨ USAGE ✨

jekyll { s | serve | server } [options...]

three ways to say the same thing, pick whichever one feels most main-character to you 🫶

🌸 OPTIONS 🌸

bestie listen. the serve command supports all the options of the build command — yes, all of them — plus these extra ones just for serving. so if you're looking for something and it's not here, go read jekyll-build(1), she has it. 💅

• -H, --host [HOST] — the local server hostname she should listen to. default is 127.0.0.1 or localhost. 🏠
• -P, --port [PORT] — the local server port to bind to. default is 4000. no cap. 🔢
• --ssl-cert [CERT] — the X.509 (SSL) certificate. that's the fancy security paper. 📜
• --ssl-key [KEY] — the X.509 (SSL) private key. keep this one secret, she's the VIP. 🔐
• -B, --detach — run the server in the background. she's independent, she doesn't need you hovering. 💫
• --skip-initial-build — skip the initial site build that normally happens before the server starts. lowkey a time-saver when you already built. ⏭️
• -o, --open-url — launch the site in a browser. automatic. iconic behaviour. 🌐
• --show-dir-listing — show a directory listing instead of loading the index file. nosy mode, activated. 👀
• -l, --livereload — use LiveReload to automatically refresh the browser. you edit, she refreshes, you never touch ⌘R again. the way that this just works. 🔄
• --livereload-ignore ignore GLOB1[,GLOB2[,...]] — files for LiveReload to ignore. ⚠️ the values must be quoted so the shell won't expand them. like actually, quote them, or your shell will do something unhinged and you'll be confused. 🙈
• --livereload-min-delay [SECONDS] — minimum reload delay. patience, babe. ⏳
• --livereload-max-delay [SECONDS] — maximum reload delay. okay now she's waited long enough. ⏰
• --livereload-port [PORT] — port for LiveReload to listen on. 🚪

for a list of general options please read the jekyll(1) manual page. she's the mothership. go say hi. 🛸

🦋 SEE ALSO 🦋

• jekyll-build(1)
• jekyll(1)

the whole friend group, honestly. 💜

👑 AUTHOR 👑

this manual page was written by Daniel Leidert <dleidert@debian.org>, for the Debian GNU/Linux system — but may be used by others. shoutout to Daniel for real, doing the Lord's work. 🫶

and that's the whole page bestie!! Jekyll 3.9, dated 2020-10-30. that's the version, that's the date, and that's your sign-off. go build something cute, you've got this. mwah. 💖✨🎀🦋🌸💅