zx import realm RealmFile
Configure the local system for access to the realm indicated by the provided RealmFile.
ZX and Zomp can only see realms for which they are configured. Both Zomp and ZX use the same realm configuration, so configuring ZX for a realm also configures Zomp. Every realm has a "realm file" (also known as a ".zrf file") as mentioned in the file section of the manual page and the "Adding a realm" quickstart page. You need this file to configure your local system to see a new realm.
All ZX realms are configured for the default "otpr" realm by default, and for most cases this is sufficient. For special cases, however, such as use of proprietary software from private or keyed realms, use of packages from forked maintenance realms, and especially for use of organizational, infrastructure, or devops realms and internal mirrors it is necessary to install a realm file.
For public realms useful to end-users the typical procedure is to receive the realm file in an email from a vendor or download it from the realm's website. For realms used to satisfy project dependencies not provided by otpr it is common to use a utility to get the .zrf file from a URI from an internal location (usually as part of a configuration script). In the below example wget is used to download a realm file and install it (note, the "-q" quiet option is not necessary):
ceverett@takoyaki:~$ zx list realms ao ao_testing otpr tsuriai ceverett@takoyaki:~$ wget -q https://zxq9.com/zomp/example_realm.zrf ceverett@takoyaki:~$ zx add realm example_realm.zrf ceverett@takoyaki:~$ zx list realms ao ao_testing example_realm otpr tsuriai ceverett@takoyaki:~$