# Testing TUS server implementations

**URL:** <https://community.transloadit.com/t/testing-tus-server-implementations/17638>\
**Category:** Tus\
**Created:** [June 19, 2025, 11:15am UTC](https://community.transloadit.com/t/testing-tus-server-implementations/17638 "2025-06-19T11:15:04Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![ixxie](https://yyz2.discourse-cdn.com/flex032/user_avatar/community.transloadit.com/ixxie/32/1383_2.png) [@ixxie](https://community.transloadit.com/u/ixxie)\
**Post date:** [June 19, 2025, 11:15am UTC](https://community.transloadit.com/t/testing-tus-server-implementations/17638/1 "2025-06-19T11:15:04Z")

</div>

Hey folks,

I’m relatively new to TUS but I ended up contributing some PRs to [GitHub - edihasaj/tuspyserver](https://github.com/edihasaj/tuspyserver) and I wanted to ask the community for advice.

Specifically, I am looking for any test suite or Postman collection to helping me test the server is functioning correctly. I currently us Uppy to test, but its often hard to say _why_ some error occurs without proper tests.

---

<div class="post-metadata">

**Author:** ![Merlijn](https://yyz2.discourse-cdn.com/flex032/user_avatar/community.transloadit.com/merlijn/32/1382_2.png) [@Merlijn](https://community.transloadit.com/u/Merlijn)\
**Post date:** [June 19, 2025, 12:01pm UTC](https://community.transloadit.com/t/testing-tus-server-implementations/17638/2 "2025-06-19T12:01:46Z")

</div>

Unfortunately there is no shared test suite among servers. But I recommend looking at [tus-node-server,](https://github.com/tus/tus-node-server) [tusd](https://github.com/tus/tusd), and [tusdotnet](https://github.com/tusdotnet/tusdotnet) for inspiration. Those are the most tested servers.

---

<div class="post-metadata">

**Author:** ![ixxie](https://yyz2.discourse-cdn.com/flex032/user_avatar/community.transloadit.com/ixxie/32/1383_2.png) [@ixxie](https://community.transloadit.com/u/ixxie)\
**Post date:** [July 6, 2025, 5:53pm UTC](https://community.transloadit.com/t/testing-tus-server-implementations/17638/3 "2025-07-06T17:53:23Z")

</div>

Unfortunate indeed! I’m not sure how much I benefit reading other implementations has over reading the protocol itself, but Ill keep it in mind.

While opening a PR to the protocol repo I noticed an [OpenAPI definition](https://github.com/tus/tus-resumable-upload-protocol/blob/main/OpenAPI/openapi3.yaml) which may be helpful, although when using this in Postman I’m not exactly sure how I would pass chunks of a file.

In practice, we currently test with Uppy, which I understand runs `tus-js-client` under the hood. I think the low hanging fruit is to improve error handling for this library so that it could facilitate end-to-end server testing. Maybe I could get around to opening a PR to this end at some point this summer.

---

<div class="post-metadata">

**Author:** ![marius](https://yyz2.discourse-cdn.com/flex032/user_avatar/community.transloadit.com/marius/32/572_2.png) [@marius](https://community.transloadit.com/u/marius)\
**Post date:** [July 7, 2025, 5:57am UTC](https://community.transloadit.com/t/testing-tus-server-implementations/17638/4 "2025-07-07T05:57:54Z")

</div>

Thanks for the feedback. I recently started more serious work on a tool for testing implementations against protocol compliance. My current focus is on testing servers, but I hope to cover client implementations in the long run as well. It’s still to early to release it, but hopefully it can be released in the near future.

---

<div class="post-metadata">

**Author:** ![ixxie](https://yyz2.discourse-cdn.com/flex032/user_avatar/community.transloadit.com/ixxie/32/1383_2.png) [@ixxie](https://community.transloadit.com/u/ixxie)\
**Post date:** [July 7, 2025, 6:33am UTC](https://community.transloadit.com/t/testing-tus-server-implementations/17638/5 "2025-07-07T06:33:53Z")

</div>

Great to hear @marius, looking forward to try it out!
