Need help with tusdotnet?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

393 Stars 48 Forks MIT License 245 Commits 6 Opened issues


.NET server implementation of the Tus protocol for resumable file uploads. Read more at

Services available


Need anything else?

Contributors list


NuGet NuGet codecov

"Our aim is to solve the problem of unreliable file uploads once and for all. tus is a new open protocol for resumable uploads built on HTTP. It offers simple, cheap and reusable stacks for clients and servers. It supports any language, any platform and any network." -

tusdotnet is a .NET server implementation of the protocol that runs on both .NET 4.x and .NET Core!

Comments, ideas, questions and PRs are welcome :)


  • Runs on OWIN and ASP.NET Core (on both .NET Framework and .NET Core)
  • Full support for tus 1.0.0 including all major extensions (checksum, concatenation, creation, upload-defer-length, expiration and termination)
  • Fast and reliable
  • Easy to configure
  • Customizable data storage
  • MIT licensed


Visual Studio

PM> Install-Package tusdotnet


> dotnet add tusdotnet


Create your Startup class as you would normally do. Add a using statement for

and run
on the app builder. More options and events are available on the wiki.
app.UseTus(httpContext => new DefaultTusConfiguration
    // This method is called on each request so different configurations can be returned per user, domain, path etc.
    // Return null to disable tusdotnet for the current request.

// c:\tusfiles is where to store files
Store = new TusDiskStore(@"C:\tusfiles\"),
// On what url should we listen for uploads?
UrlPath = "/files",
Events = new Events
    OnFileCompleteAsync = async eventContext =>
        ITusFile file = await eventContext.GetFileAsync();
        Dictionary<string metadata> metadata = await file.GetMetadataAsync(ctx.CancellationToken);
        Stream content = await file.GetContentAsync(ctx.CancellationToken);

        await DoSomeProcessing(content, metadata);


Test sites

If you just want to play around with tusdotnet/the tus protocol, clone the repo and run one of the test sites. They each launch a small site running tusdotnet and the official JS client so that you can test the protocol on your own machine.

Test sites are available for:

  • ASP.NET Core 6 (.NET 6.0)
  • ASP.NET Core 3.1 (.NET Core 3.1)
  • ASP.NET Core 3.1 (.NET Core 3.1)
  • ASP.NET Core 3.0 (.NET Core 3.0)
  • ASP.NET Core 2.2 (.NET Core 2.2)
  • ASP.NET Core 2.2 (.NET Framework 4.6.2)
  • ASP.NET Core 2.1 (.NET Core 2.1)
  • OWIN (.NET Framework 4.5.2)

Clients keeps a list of clients for a number of different platforms (Android, Java, JS, iOS etc). tusdotnet should work with all of them as long as they support version 1.0.0 of the protocol.


This project is licensed under the MIT license, see LICENSE.

Want to know more?

Check out the wiki, create an issue or contact me :)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.