PLAKAR-SERVER(1)

πŸ“¦
version 1.1.7 Β· 2 versions
, in nixpkgs unstable

πŸ’… PLAKAR-SERVER(1) β€” the plakar-server glow-up ✨

okay so bestie, welcome to the plakar-server manual page (General Commands Manual, we're fancy like that πŸŽ€). this is the one that tells you how to start a Plakar server, and ngl it's shorter than your fave playlist but it's got range. let's get into it πŸ’–


✨ NAME ✨

plakar-server β€” start a Plakar server 🫢

✨ SYNOPSIS ✨

plakar server [-allow-delete] [-listen [host]:port] [-cert path]
       [-key path] [-token string]

that's the whole vibe check right there. every flag is optional, every flag is iconic, and they all live inside those square brackets like the little main characters they are πŸ‘‘

🌸 DESCRIPTION 🌸

the plakar server command starts up a Plakar server instance at whatever address you hand it, so other people (or, like, other machines) can interact remotely with a Kloset store over a network. it's giving "long-distance friendship but make it storage" 🌈

the options are as follows, and yes we're going through all of them, no skipping:

  • -allow-delete β€” turns on delete operations. by default delete operations are disabled so nobody accidentally yeets your data into the void 😭 like, the training wheels are on for a reason, bestie.
  • -listen [host]:port β€” the host and port to listen on, separated by a colon. the host name is optional and defaults to all available addresses. if you don't pass -listen at all, the server defaults to listening on localhost at port 9876. cute little default, love that for you πŸ’…
  • -cert path β€” the path to a full certificate file in PEM format. if you provide both -cert and -key, the server will expect https connections. if one or both are missing, it falls back to http. it's giving "dress code: optional but slay if you do" ✨
  • -key path β€” the path to a certificate private key file in PEM format. the other half of the https duo 🫢
⚠️ real talk: -cert and -key only give you https when they show up together. one without the other means plain http, so don't come for me when the padlock doesn't appear πŸ”’

πŸ”₯ EXIT STATUS πŸ”₯

the plakar-server utility exits 0 on success, and >0 if an error occurs. zero is the good one. anything above zero means something went sideways and you should probably go read the error like it's a text from your crush πŸ’€

πŸ¦‹ EXAMPLES πŸ¦‹

start a plakar server on the local store:

$ plakar server

start a plakar server on a remote store:

$ plakar at sftp://example.org server

start a server on a specific address and port:

$ plakar server -listen 127.0.0.1:12345

start a https server on a specific address and port:

$ plakar server -listen backup.example.com:12345 -cert fullchain.pem -key privkey.pem

see how that last one has both -cert and -key? yeah. that's the https combo meal πŸ“πŸ”₯

🧚 SEE ALSO 🧚

  • plakar(1) β€” the main character. go read that one too, iykyk πŸ’œ

πŸ’€ CAVEATS πŸ’€

when you provide a host name, plakar server uses only one of the IP addresses that host name resolves to, preferably IPv4. so like, it's not out here collecting every IP like PokΓ©mon cards β€” it picks one and commits. no cap. πŸ™ˆ


and that's the whole page, bestie β€” you're officially a plakar-server girlie now πŸ’…βœ¨

this one came from Debian, dated August 25, 2026 β€” mwah, thanks for the docs, ily πŸ«ΆπŸŽ€

πŸ“¦ where this page comes from