Zrok public share - Interstitial page removal

Hi there to all !

I am trying to crate an iframe component and share it with zrok.
I am self-hosting Zrok at the moment and would like to remove the 'interstitial' page that shows up on the front-end.
Is there a way to achieve this through the command line perhaps ?

Maybe when using --> zrok reserve public ??

I would like a back-end solution to this. Maybe there is a config file I can change ?

I looked into it at the Docs but I can't follow what is described there.
I am using zrok v1

Hi @MoiraAI2024, welcome to zrok and OpenZiti! You can configure the interstitial. The docs tell you to enable/disable them for the frontend

#interstitial:
#  # Enable or disable interstitial pages on this frontend.
#  #
#  enabled: true

That wasn't clear?

1 Like

Hello again!
Thanks for the quick response !

I am a novice to this. Where and how can configure this settings file?
I run Zrok self-hosted locally. Is this file generated already ?

Thanks alot !

By the way I have followed this install guide:


Linux binary option

Manually install in ~/bin/zrok

You'll need the information in the help document that @TheLumberjack sent you above, and here's an example configuration YAML file for the zrok frontend. That's where you will configure a specific zrok frontend to present the interstial page for public shares it serves.

Thanks for letting us know which guide you're following. Since you're self-hosting everything and you followed the zrok (CLI binary) install guide for Linux, I'm guessing you might have also followed the self-hosting guide for Linux, i.e., for running a zrok controller or frontend or both on Linux. That will work! Still, if you're cloud-friendly, the available self-hosting help for Docker
and Kubernetes is substantially more developed and complete.

1 Like

Hi and thanks again for these great resources !
I have not followed the [Self-Hosting Guide for Linux | zrok].

I only installed the binary and went on to create public/private shares...
Running zrok status gives me this output:

Config:

 CONFIG           VALUE                   SOURCE 
 apiEndpoint      https://api-v1.zrok.io  binary 
 defaultFrontend  public                  binary 
 headless         false                   binary 

Which means that I'm running -- NETFoundry's zrok instance correct?
Therefore I am using the default public frontend which included the interstitial page.

I need to run the zero controller and frontend locally to be fully self-hosted correct ?

Thanks a lot for this help. I am very new to this as you can tell.

We completely misunderstood you! :rofl:

Okay, you're a zrok.io user (NetFoundry's zrok-as-a-service) using zrok in Linux who wants to bypass the interstitial for a particular public share, not a zrok self-hosting user needing to configure your zrok frontend to never present interstitial pages for all public shares of zrok accounts.

TL;DR You can bypass the interstitial page when sending web requests to the public share by using a command-line client/user-agent, like cURL, or by including a special HTTP header, skip_zrok_interstitial.

Here's a blog post about the why and the what of interstitial pages: zrok is Growing Up

If you want to know more, here's how it works on the zrok frontend server side: Interstitial Pages | zrok

Is it not possible to disable the interstitial page using zrok.io without the need for headers? One use case of mine is to test Apple ID Oauth from a server running locally, and it is not possible to configure custom headers on the callback URL.

Upgrading to any paid account removes the interstitial. There is a $0 account that requires a credit card, which also removes the interstitial.

Oh interesting, I will try that out, thanks!

That didn’t seem to do the trick for me. I upgraded to the Starter Plan. Is there any local configuration that needs to be done after that?

There shouldn’t be, no. Try creating a new share and see if that behaves any differently?

Thanks a lot for this info !

Really useful !

I don’t believe the Starter plan removes the interstitial page: Pricing - zrok

Basic & Pro should though - Its listed on the features of each package