MINIQUARK(1)

📦
version 3.3 · 2 versions
, in alpine 3.24

💅 MINIQUARK(1) — like, the manual page, but make it make sense 🦋

okay so bestie, welcome to miniquark, the tiniest little web server you ever did see ✨ this page lives in the General Commands Manual section, and honestly? it's giving "small but mighty" and we're obsessed.

🌸 NAME 🌸

miniquark — a minimal web server for retrieving files 🎀 no cap, that's literally it. tiny server, big slay.

✨ SYNOPSIS ✨

miniquark -p port [-h host] [-d dir]

that's the whole vibe check right there 👑 you must give it a port, everything else is optional.

💖 DESCRIPTION 💖

so miniquark is a web server, right? and it supports GET/HEAD requests 🫶 the whole point of it is that it's easily launched as an unprivileged user to provide HTTP access to a local directory — no root drama, no sudo moment, just you and your files living their best life 💅

🎀 the options, fr 🎀

  • -p port — the port to listen on for incoming connections 🔥 this one's required, so don't forget it bestie.
  • -d dir — switch to the specified directory 📁 (yes, that's where it'll serve stuff from).
  • -h host — set the hostname or IP address to listen on. the default is 'localhost' 🌈 so if you don't say anything, it's staying local, periodt.

🦋 FEATURES 🦋

the following request headers are recognized 👀 like, it knows these ones by name:

  • Range: — returns 206 Partial Content and the Content-Range header is set ⭐ so you get your partial file and it's all official about it.
  • If-Modified-Since: — returns 304 Not Modified or "200 OK" based on the file timestamp ⏰ iykyk, caching behaviour that just works.
  • User-Agent: — used for log messages 📝 that's it, it's just there for the logs, no thoughts head empty.

🌈 HISTORY 🌈

miniquark was based on https://git.suckless.org/quark 🧚 and it was bundled with rset(1) in July 2020 💜 ok history lesson over, go serve some files.

ngl if you made it this far you're a real one 💀 go read rset(1) next, it's right there in SEE ALSO energy.

that's the whole page bestie 🎀 this cutie came to you from Debian, version/date stamp January 17, 2026 — mwah 💋 see u in the group chat ✨👑💖

📦 where this page comes from