Skip to content

Take control over your live stream video by running it yourself. Streaming + chat out of the box.

fix(test): use pinggy for test-local.sh tunnels since localhost.run stopped forwarding

Gabe Kangas87e87ef3112b
diff --git a/test/test-local.sh b/test/test-local.sh
index b2b2b34539..7c21589546 100755
--- a/test/test-local.sh
+++ b/test/test-local.sh
@@ -3,8 +3,17 @@
# This script will make your local Owncast server available at a public URL.
# It's particularly useful for testing on mobile devices or want to test
# activitypub integration.
+#
+# By default it uses pinggy.io, which requires no account. Anonymous tunnels
+# last 60 minutes, and browsers are shown a one-click interstitial page
+# before the first visit (scripted clients can skip it by sending a
+# "X-Pinggy-No-Screen: true" header).
+#
# Pass a custom domain as an argument if you have previously set it up at
-# localhost.run. Otherwise, a random hostname will be generated.
+# localhost.run. Otherwise, a random hostname will be generated via pinggy.
+# Note: localhost.run has been observed accepting tunnels without actually
+# forwarding any traffic to them (2026-07-09), so it is only used for
+# custom domains, a feature pinggy's free tier doesn't offer.
# DOMAIN=me.example.com ./test/test-local.sh
# Pass a port number as an argument if you are running Owncast on a different port.
# By default, it will use port 8080.
@@ -23,9 +32,9 @@ fi
if [ -n "$DOMAIN" ]; then
echo "Attempting to use custom domain: $DOMAIN"
- ssh -R "$DOMAIN":80:localhost:"$PORT" localhost.run
+ ssh -o ServerAliveInterval=30 -o ExitOnForwardFailure=yes -R "$DOMAIN":80:localhost:"$PORT" localhost.run
else
echo "Using auto-generated hostname for tunnel."
- ssh -R 80:localhost:"$PORT" localhost.run
+ ssh -p 443 -o ServerAliveInterval=30 -o ExitOnForwardFailure=yes -R 0:localhost:"$PORT" a.pinggy.io
fi