JetBrains Space Help

Administration of Space On-Premises

There are several administration activities specific only to Space On-Premises:

  1. Uploading a Space product license.

  2. Enabling push notification for mobile clients.

Otherwise, in terms of administration, Space On-Premises is no different from its cloud version – refer to https://www.jetbrains.com/help/space/administrator-s-guide.html for basic administration instructions.

Activate your Space On-Premises instance

  1. In a browser, open your clean Space On-Premises installation. In case of a Docker Compose installation, the default URL is http://127.0.0.1:8084.

  2. Under the License field, click the link to log in to your JetBrains Account.

  3. On your account page, copy the license string and return back to Space.

  4. Paste the string to the License field.

  5. Fill other fields if required and click Get started.

Enable push notifications for mobile clients

Space provides mobile clients for iOS and Android. To send push notifications to mobile clients, your Space On-Premises instance must use a proxy server from JetBrains. The proxy server delivers the notifications to end users through the corresponding Apple and Google services.

To enable the proxy server for push notifications

  1. Make sure your Space instance has access to https://on-premises.service.jetbrains.space.

  2. On the main menu, click administration.png Administration and choose Notifications Proxy.

  3. Choose JetBrains Proxy and click Save.

Configure mail server

Space On-Premises comes without a mail server. This means that, by default, Space won't be able to send emails like user invitations, chat notifications, and so on.

To enable Space email notifications, you must create a mail server on your own and provide its settings to Space. Typically, you can provide the settings either during the installation or later, in the Space administration UI. For the Docker Compose installation in AWS, the Space UI is the only option.

Note that the mail server settings specified in the Space UI override the settings specified during the installation.

  1. On the main menu, click administration.png Administration and choose SMTP Settings.

  2. Specify the mail server settings:

    • Encryption: the encryption type supported by your mail server (STARTTLS, SSL/TLS, or None).

    • Host and Port: the host name and the port number of your mail server.

    • Username and Password: the credentials to access your mail server.

    • Email "From" address: the email address that will be used as the sender address for Space notifications.

  3. Click Save.

Last modified: 11 September 2023