Skip to main content

Use Another zrok Instance

note

This guide is relevant if you are self-hosting or using a friend's zrok instance instead of using zrok-as-a-service from zrok.io.

The zrok command on your computer uses a zrok instance over the network.

The default instance API endpoint for the zrok command is api.zrok.io. Set the API endpoint to another instance's API endpoint:

zrok config set apiEndpoint https://zrok.example.com
Output
[WARNING]: unable to open environment metadata; ignoring

zrok configuration updated
note

The WARNING about environment metadata is expected when you run zrok config set before zrok enable.

You can use the zrok status command to inspect the state of your local environment. zrok refers to each shell where you install and enable a copy of zrok as an environment.

zrok status
Output
Config:

 CONFIG       VALUE                      SOURCE 
 apiEndpoint  https://zrok.mydomain.com  config 

[WARNING]: Unable to load your local environment!

To create a local environment use the zrok enable command.

The zrok status command shows the configured API service that your environment is using, as well as the SOURCE where the setting was retrieved. In this case, config means that the setting was set into the environment using the zrok config command.