Configuring HipChat Server

Configuring HipChat Server in the UI

  1. Browse to the newly created instance by entering the IPv4 address or the hostname as the URL. For example:
    https://IPv4 or https://hipchat.fully-qualified-domain-name.com
  2. The first time you browse to your HipChat Server web UI a configuration wizard will guide you through the initial configuration.
  3. Follow the steps in the configuration wizard to finish installing HipChat Server. 
    Hint: When you're finished you'll have to wait a few minutes for the settings to be applied and services to restart. Afterwards your browser may redirect to the sign In page, but for an ideal experience...
  4. Browse to the new fully qualified domain name you've configured for your server, e.g. https://hipchat.yourcompany.com
  5. Log into the HipChat Server web user interface (UI) using your administrator email and password you configured during the setup wizard.

Updating your HipChat Server's SSL key and certificate

  1. Create or obtain an SSL key and certificate pair in PEM format.
    Important:  Do not encrypt the key. Remove the passphrase, if necessary.
  2. Log in to HipChat Server
  3. Click the Server admin tab at the top of the page.
  4. Click the SSL tab in the middle of the page.
  5. Paste in the PEM format private key and certificate text.
  6. Click Modify to apply the key and certificate pair.
    Note: Services are restarted with the new SSL. They can take a few minutes to restart.

Updating your HipChat Server's Fully Qualified Domain Name 

  1. Log in to HipChat Server. For example: 
    https://hipchat.fully-qualified-domain-name.com  or  https://IPv4
  2. Click the Server admin tab at the top of the page.
  3. Click the Network tab in the middle of the page.
  4. Update the hostname and domain name.
  5. Click Save to apply the new hostname and domain name.
    Note: Services are restarted with the new FQDN. They can take a few minutes to restart.
  6. Ensure your DNS services are correctly pointing traffic for your new FQDN to the HipChat Server IP Address or via CNAME.

Limiting filtering and relay rejection

Optionally, you can configure the system to use an SMTP smarthost or relay host to limit filtering and relay rejection.

  1. Click the Server admin tab.
  2. Click the Email tab
  3. In the Smart Relay Host field, enter the SMTP server's domain (and port, if necessary). For example, smtp.example.com:587
    Note: To disable using an SMTP relay, altogether, leave the field empty.
  4. In the Smart Relay User and password fields, enter the SASL authentication credentials.
  5. In the Sender Email Address field, enter the email address from which you are sending emails.

Changing the default group name

By default, the group name in HipChat is "Everyone." You can change it to the name of your organization.

Click the Group admin tab, then update the Group name, Everyone, to the name of your organization.

Inviting other evaluators

You can share the Invite URL with other evaluators.

  1. Click the Group admin tab.
  2. Click the Features tab.
  3. Scroll to the bottom of the page.
  4. Copy the Invite URL and share it with other evaluators.

Configure your user directories for use with HipChat Server

When Restoring HipChat Server from an export archive file, configuring external user directories should be performed after Importing your HipChat Data to ensure data consistency.

You can use your organization's user directories, including popular LDAP directories, Active Directory, Crowd, and JIRA applications, with HipChat Server. For the full list of supported user directories and instructions on configuring them with HipChat Server, see Configuring User Directories.

Next Step: Test your Installation

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport