Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stashy.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
What is Stashy?

Stashy is a self-hosted file storage service with a multi-protocol API. Upload files, share when ready — that’s it.

​
Key Features

Multi-Protocol

One port serves REST, gRPC, Connect, and gRPC-Web.

Pluggable Storage

Memory, local disk, or Google Cloud Storage.

Flexible Database

SQLite out of the box. Postgres when you need a separate database.

Single Binary

One Go binary, zero external dependencies.

​
How It Works

1

Sign in and get an API key

Visit the dashboard (/), sign in with Google, and generate an API key.
2

Upload a file

POST /v1/files with your Bearer token. You get back an id and a direct url. The file is immediately accessible to logged-in users.
3

Make it public

POST /v1/files/{id}/publish to share with anyone — no auth required.

Quickstart

Get running in under 5 minutes

API Reference

Upload and download files