Registration

Generate an SSH key pair

You will need to configure an RSA key pair in order to register the proxy. This acts as the proxy's identity with the Snap proxy.

This can be done automatically:

sudo snap-proxy generate-keys

Or you can manually generate a key pair, in OpenSSH format (e.g., via ssh-keygen) and set explicitly:

sudo snap-proxy config \
    proxy.key.public="<public key data>" \
    proxy.key.private="<private key data>"

This key is your proxy's identity and should be recorded securely. To view keys generated by the generate-keys command, you can run:

sudo snap-proxy config proxy.key.public proxy.key.private

Initial registration

To register the proxy, you will need to provide Ubuntu SSO credentials for the desired account you wish to link the proxy with, and answer some simple questions about your deployment:

sudo snap-proxy register

You can examine your proxy's registration status with:

snap-proxy status

This will show the registration status of your proxy, as well as local status information of this server.

For evaluation purposes, we automatically grant the use of up to 5 devices.

At this point, your proxy will be assigned a Store ID, which can be retrieved with the status command. This will be used in later commands and to identify your proxy for support purposes.

Next step

Once your proxy is approved, you will be able to configure devices.