GComm guide

Invite people & create a copyable email

Create one invitation for each device, choose its channel access, and prepare clear instructions for the person joining.

For Server 8.1.0 / Server Manager 2.1.0 and Desktop 10.1.0. English control names are shown; your app may use your Windows language.

From administrator to first connection

1 · CHOOSE ACCESSCheck the device’s channels and create an invitation.
2 · PREPARE THE EMAILEdit instructions, review the preview, then copy and send.
3 · ENROLL DESKTOPThe recipient applies the invitation and enters the passphrase.

Illustrative workflow. No email is sent automatically by GComm.

1. Create an invitation

  1. Open Server Manager as administrator.Use Refresh devices if needed, and check that a seat is available. Save or reload any unsaved configuration changes.
  2. Choose the intended channel checkboxes.For example, check Office for a coworker. Check Office and Family only if the device should have both. Clear General if it would give access to a group you meant to separate. Selecting another device loads that device’s channels, so review the checkboxes immediately before creating an invitation.
  3. Choose Create invitation (24 hours).The new one-use enrollment block appears below the pending invitation list. Its server-side record grants exactly the selected channels. Editing the block does not expand that access.
  4. Choose how to share it.Use Create copyable email for instructions that include the current invitation and passphrase, or use Copy new invitation for only the JSON block and share the passphrase separately.
  5. Create another invitation for the next device.An invitation can enroll one device once and expires after 24 hours. It does not reserve a seat. Capacity must still be available when the device connects.

The invitation includes the host, port, server identity, certificate fingerprint, expiration, and enrollment information. The JSON invitation itself does not contain the shared passphrase. If you use a remote endpoint, configure it before copying the invitation.

2. Use Create copyable email

  1. Create a new, unexpired invitation first.Then choose Create copyable email beneath the enrollment block. If the button is unavailable, check administrator access, saved settings, a configured passphrase, and the invitation’s expiry.
  2. Edit the upper instructions.The top editor is a reusable template. Add a greeting, your support contact, or the location of the Desktop installer. Keep the invitation and passphrase placeholders where the recipient will need them.
  3. Review the lower Email preview.It expands the template using this invitation, the saved server passphrase, expiry time, and channel names. Check the recipient’s intended access and installer instructions before copying.
  4. Choose Copy email.Open your own email application, create a message addressed to the intended recipient, and paste. Add your subject, review the message, and send it there. GComm does not choose a recipient or send mail.
  5. Close the email window.Your edited instructions are saved for this Windows user and this server. Creating another invitation reuses the template with that invitation’s current details.

The email editor has two parts

Hello,
Install GComm Desktop from the location below.
Apply this invitation: {{INVITATION}}
Shared passphrase: {{PASSPHRASE}}
Your wording appears here with the current invitation and passphrase filled in.
Illustration with placeholders only. The real preview contains live credentials.

3. Reuse and customize the instructions

You can edit the surrounding wording and use these exact placeholders, including both pairs of braces:

PlaceholderWhat it inserts
{{INVITATION}}The complete enrollment JSON block for the new device.
{{PASSPHRASE}}The saved shared server passphrase. Omit it if you will deliver the phrase separately.
{{EXPIRES}}The invitation’s expiration, shown in the administrator’s local time.
{{CHANNELS}}The channel names assigned to this invitation.

Restore default instructions replaces the template after confirmation. Templates are saved separately for each Windows user and server identity. Live invitation credentials are normalized to placeholders when saved; the rendered email you copy still contains those credentials.

This example contains placeholders only. Replace the installer-location line with the location you actually provide:

Hello,

Install GComm Desktop from: [your approved installer location]
Open Setup and enter your name in YOUR NAME.

Paste the entire block below into DEVICE ENROLLMENT,
then choose Apply invitation:
{{INVITATION}}

Enter this in SHARED PASSPHRASE:
{{PASSPHRASE}}

Choose Save. Enrollment settings restart the client.
Your channels: {{CHANNELS}}
Use this invitation once, before {{EXPIRES}}.

Contact [your administrator] if you need help.

4. Cancel or replace an invitation

  1. Find the unused invitation under Pending invitations.Select the entry. The list shows its expiry in UTC; the copyable email shows the expiration in the administrator’s local time.
  2. Choose Cancel selected invitation.Use this if it was sent to the wrong recipient, is no longer needed, or had the wrong channels.
  3. Create a fresh invitation if needed.Review the channel checkboxes and prepare a new email. An expired or already-used invitation cannot be reused. For a device that has already enrolled, change its channel access or release the device instead.

Common questions

Why is Create invitation disabled?

Check administrator access, the selected installation, saved settings, a loaded channel list, at least one checked channel, and seat availability. Hover over the disabled control for its explanation.

Can I email one invitation to everyone?

No. It enrolls one device once. Create a separate invitation for every device, including a second device used by the same person.

Can the recipient change the channels in the JSON?

The server’s invitation record controls channel access. Editing the text does not grant more access. An administrator must change membership in Server Manager.

The recipient pasted the whole email into Desktop. What now?

Copy only the complete JSON block, including its outer curly braces, into DEVICE ENROLLMENT. The shared passphrase goes in its own field. See the Desktop guide.

The invitation was used, but now the device should lose access.

Select the registered device and use Release selected device. Cancelling an unused invitation is a different action and does not revoke an already registered device.