Skip to content
v2.1These docs are for deaddrop 2.1: serve local files, stdin and URLs, allow-listed clients, expiring tickets, resumable fetches and seven new notifiers.What's new in 2.1 →

Allowing specific clients

Normally anyone who has the ticket can download. To let in only the people you mean, each of them runs deaddrop id once and sends you the id it prints.

  1. On the client, create an identity and print its id:

    Terminal window
    $ deaddrop id
    aedfde36826e82dc8a3d4900dc5960d785374b4867b37c5e05e7b498b3b8414d
  2. On the server, allow that id:

    Terminal window
    deaddrop serve x.torrent --allow aedfde36826e82dc8a3d4900dc5960d785374b4867b37c5e05e7b498b3b8414d
  3. On the client, fetch as usual. fetch uses the identity automatically.

The server checks the id right after the encrypted handshake, which proves it, and turns everyone else away before they can list or download anything. fetch then stops at once with a message saying it isn’t on the allow list, and which id to allow, instead of retrying. Resets aren’t affected; they have their own token.

Repeat --allow, set DEADDROP_ALLOW=id1,id2, or list them in the config file:

[serve]
allow = ["aedfde36…", "5c1a90b2…"]

--allow and DEADDROP_ALLOW replace the config file’s list.

  • The id isn’t secret. The identity file is: it holds the key that proves the id (~/.local/share/deaddrop/identity.key on Linux, mode 600). Anyone who has a copy can pass as that client.
  • Once the file exists, every fetch uses it, so every server you fetch from sees the same id. Without it, each fetch uses a new random id.
  • Delete the file to go back to random ids, or keep it elsewhere and point at it only when needed with --identity <FILE>, DEADDROP_IDENTITY, or identity under [fetch] in the config file.
  • deaddrop id --new replaces the identity. Servers that allowed the old id won’t accept this client any more.
Where Flag / env / config Meaning
serve --allow <ID>, DEADDROP_ALLOW, serve.allow Only let these clients download or list. Repeatable.
fetch, id --identity <FILE>, DEADDROP_IDENTITY, fetch.identity Identity file to use.
id --new Replace the identity with a new one.