godrop

GoDrop

GoDrop is a small self-hosted file host. You upload a file with a token and get back a URL that nobody can guess. Anyone with the URL can download it; no token is needed to read.

Setup

Two values are all you need:

export GODROP_URL=https://files.example.com
export GODROP_TOKEN=gd_...

If only the URL is known, curl $GODROP_URL/llms.txt returns the API and the instance's actual limits.

Upload a file

curl -sS -X POST \
  -H "Authorization: Bearer $GODROP_TOKEN" \
  -F "[email protected]" \
  "$GODROP_URL/upload"

Response (201):

{
  "files": [
    {
      "url": "https://files.example.com/f/20260815-143022-8f4e…/report.pdf",
      "name": "report.pdf",
      "size_bytes": 12345
    }
  ]
}

Read .files[0].url for the single-file case:

url=$(curl -sS -X POST -H "Authorization: Bearer $GODROP_TOKEN" \
        -F "[email protected]" "$GODROP_URL/upload" | jq -r '.files[0].url')
echo "$url"

The response has one shape whatever was sent, so there is no branching to do. The same URL is in the Location header, for when there is no JSON parser.

Put a screenshot in a pull request or an issue

GitHub has no supported API for attaching an image, so upload it here and paste the URL: it needs no token to open, and GitHub renders it inline for everyone on the thread.

url=$(curl -sS -X POST -H "Authorization: Bearer $GODROP_TOKEN" \
        -H "X-Expires-In: 30d" -F "file=@screenshots/checkout.png" \
        "$GODROP_URL/upload" | jq -r '.files[0].url')

gh pr comment 42 --body "Checkout, after the fix:

![checkout]($url)"

The same URL works in an issue, a review comment, a commit message or a chat message. Add X-Expires-In when the picture is only interesting while the pull request is open.

Upload several files

curl -sS -X POST -H "Authorization: Bearer $GODROP_TOKEN" \
  -F "[email protected]" -F "[email protected]" \
  "$GODROP_URL/upload" | jq -r '.files[].url'

The request is all-or-nothing: if one file is rejected, none are stored. At most 20 files per request by default.