ZX: import realm

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:~$