tusd-v2

Configure tusd v2 servers for resumable uploads with S3 storage and HTTP hooks.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/sncollective/snc-platform --skill tusd-v2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tusd-v2
Source: https://github.com/sncollective/snc-platform/tree/main/.claude/skills/tusd-v2
Command: npx skills add https://github.com/sncollective/snc-platform --skill tusd-v2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

tusd v2 is the reference server for the tus resumable upload protocol, but configuring it for S3 storage, hook integration, and production deployment can be complex and error‑prone. This Skill consolidates all necessary configuration details, environment variables, CLI flags, and best‑practice guidance into a single, easily searchable reference.

Core Features & Use Cases

  • S3 Backend Configuration – Shows required AWS credentials, bucket settings, and compatibility notes for Garage S3.
  • Hook System – Documents pre‑create, post‑finish, and other HTTP hook types, including payload schemas and response handling.
  • Docker Compose Example – Provides a ready‑to‑run service definition that integrates tusd with Garage, the API, and Caddy/Nginx reverse proxies.
  • Operational Gotchas – Highlights CORS handling, proxy settings, temporary disk requirements, and security considerations for resumable uploads.

Quick Start

Ask for a Docker Compose snippet that runs tusd with a Garage S3 backend and enables post‑finish hooks.

Frequently Asked Questions about tusd-v2

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure tusd for resumable uploads to an S3 backend?

To configure tusd for resumable uploads to S3, set AWS credentials, S3 bucket, and endpoint flags. The server receives large files via the tus protocol and stores them in an S3-compatible backend.

What HTTP hooks does tusd v2 support for custom processing?

tusd v2 supports pre-create, post-finish, and other HTTP hook types. You configure hook endpoints to receive payloads for custom processing when resumable uploads complete or initialize.

Can I use tusd with Garage S3 storage?

Yes, tusd works with Garage S3 storage. The Skill documents AWS credentials, bucket settings, and compatibility notes for Garage S3 backend integration.

How do I deploy tusd using Docker Compose?

Deploy tusd using Docker Compose with a ready-to-run service definition. It integrates tusd with Garage, the API, and Caddy or Nginx reverse proxies for production use.

What are common operational gotchas when running a tus resumable upload server?

Common operational gotchas for tus resumable upload servers include CORS handling, proxy settings, temporary disk requirements, and security considerations for large file uploads.

Do I need a reverse proxy for tusd in production?

A reverse proxy is recommended for tusd in production. The Docker Compose example integrates Caddy or Nginx to handle proxy settings and CORS for resumable upload traffic.