DRAWPILE-SRV(1)

📦 version 2.3.0, in alpine 3.24

💖 drawpile-srv — like, the whole manual, bestie 💖

okay so this is the manual page for drawpile-srv(1), from the Drawpile standalone server family — and yes, I folded that in instead of copy-pasting the header line because we're cute like that 🎀

✨ SYNOPSIS ✨

drawpile-srv [OPTIONS]

that's it. that's the whole vibe check. she takes options and she runs 💅

🌸 DESCRIPTION 🌸

so basically drawpile-srv is a standalone server for Drawpile. no cap, that's the whole description. iconic of them honestly 🫶

👑 OPTIONS 👑

bestie, there are SO many and they're all important, so we're doing every single one. no skipping. periodt.

  • --help, -h — shows the help text. your "what is even happening" button 💖
  • --version, -v — prints the program version number. knowing what you're running is main character energy ✨
  • --gui — runs in graphical mode. literally just used with GUI-specific command line arguments 🖥️
  • --port, -p port — listen on the port you picked instead of the default one 🍓
  • --listen, -l address — bind to the address you specify. and if you don't give a listening address at all? drawpile-srv just listens on all addresses. she's spacious like that 💫
  • --local-host hostname — the local server hostname to use in the session announcement 📢
  • --announce-port port — local server hostname to use in the session announcement (yes, same description as the one above — I'm not making this up, that's what it says, and I refuse to invent lore 🫡)
  • --ssl-cert cert.pem — picks the SSL certificate file 🔐
  • --ssl-key key.pem — picks the SSL private key file. important: this must be used together with --ssl-cert to enable SSL support. team effort only, no solo acts 🤝
  • --record, -r filename pattern — records sessions to files 📼. placeholders in the filename pattern get expanded to make the actual filename. if you hand it a directory, it'll use a default filename pattern instead. the supported placeholders are: %d (date), %t (time) and %i (session ID). iykyk 🗓️
  • --web-admin-port port — enables the web admin API and listens on this port 🌐
  • --web-admin-auth username:password — enables HTTP BASIC Authentication on the web admin API. keep it secret, keep it safe 🔒
  • --web-admin-access address/subnet|all — allows access to the web admin API from hosts other than localhost. so like, guests are allowed now 🚪
  • --database path — the configuration database to use 🗄️
  • --config, -c path — the configuration file to use. mutually exclusive with --database — pick one, bestie, you can't have both, it's giving "choose your fighter" 💀
  • --sessions path — where to store file-backed sessions. and if you don't specify it? sessions are kept in memory 🧠✨
  • --templates, -t path — where to look for session templates 🎨
  • --extauth url — the Extauth server URL 🔗
  • --report-url url — the abuse report handler URL 🚩

🔌 SOCKET ACTIVATION 🔌

okay this part matters, pay attention bestie 👀

drawpile-srv supports systemd socket activation. when the server is started by systemd and a socket is passed, these parameters get ignored:

  • --listen
  • --port
  • --web-admin-port

the listening address must be configured in the drawpile-srv.socket unit file instead. and if two sockets are passed? the second one gets used for the web admin API 🧚

fr fr, those three flags do nothing in socket activation mode — don't come for me, that's just what the page says 💅

🦋 AUTHOR 🦋

written by Calle Laakkonen <laakkonenc@gmail.com> and the Drawpile contributors. legends, honestly 👑

Copyright © Calle Laakkonen <laakkonenc@gmail.com> and Drawpile contributors

This is Free Software; this software is licensed under the GPL version 3, as published by the Free Software Foundation. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE 😭

like... genuinely no warranty. zero. none. don't say nobody warned you 💀

and that's the whole page, bestie 🫶 this was drawpile-srv, version dated 2025-11-18 — go forth and host, you absolute icon ⭐🎀💜

📦 where this page comes from