Troubleshooting Bunny Stream Video Uploads

This guide will help you troubleshoot common issues when uploading videos to Bunny Stream. While the platform is designed to make uploads easy and reliable, there are cases where problems can arise due to upload methods, file size, internet speed, or transcoding queues.

Step 1: Identify Your Upload Method

Before troubleshooting, it’s important to know how you’re uploading your videos:

• Dashboard: Uploading directly from the Bunny.net control panel (dash.bunny.net)

• Direct Upload API: Using Bunny’s API to upload videos. Reference: https://docs.bunny.net/reference/video_uploadvideo

• TUS Uploads: Uploading videos using the TUS protocol (resumable uploads). Reference: https://docs.bunny.net/reference/tus-resumable-uploads

Understanding the method helps narrow down potential causes.

Issue: Upload Not Finishing or Stuck in “Uploading”

If your video stays in the “Uploading” state or never finishes:

If you’re using Dashboard uploads

• Check your internet connection speed, especially upload speed. Use a tool like Speedtest.net to verify.

• Large files (especially over 2 GB) may take longer to upload and process.

• If the issue persists, try renaming the file and re-uploading it. This resets the context and restarts the upload cleanly.

If you’re using the Direct Upload API or TUS

1. Is this a new implementation?

   • If so, review the relevant documentation to ensure proper setup:

     • Direct Upload API Docs

     • TUS Uploads Guide

   • Common issues include:

     • 401 Unauthorized: Often due to an invalid API key or improperly signed token.

     • Incorrect or missing headers.

     • Expired or malformed upload token.

2. If it was previously working, review recent code changes or environment updates that may affect request formatting.

Issue: Upload Stuck in “Processing”

After uploading, Bunny Stream transcodes videos into multiple resolutions. While this usually begins shortly after upload, some factors can delay processing:

Potential reasons for delays:

• The video file is large (2 GB+).

• Your library has many encoding options enabled (e.g., multiple resolutions, multiple codecs), increasing processing time.

• The shared transcoding queue may be temporarily busy, especially during peak upload periods.

Bunny Stream uses a fair queueing system to ensure all users get processing resources, but brief delays can still occur.

What to do:

• Wait a few minutes, most files begin processing shortly.

• If the video stays in “Processing” for more than a few hours, contact Bunny.net support, and we’ll help investigate.

Want Faster Processing?

If you prefer priority access to transcoding resources and want to skip the queue, consider upgrading to a Premium Encoding plan. This ensures your videos are processed faster, even during high-traffic periods.

Summary

💬 Need Help?

Still having trouble? Reach out to our support team, we’re happy to assist! Submit a Support Request