Guidance on usage: Rocket.Chat on Ubuntu 18.04 Minimal

Configuration and launching Rocket.Chat on Linux Ubuntu 18.04 Minimal

Before creating a VM, review the system requirements for the Rocket.Chat server: Hardware Requirements – Rocket.Chat Docs

  1. Start VM through Azure Portal. The Rocket.Сhat service is run automatically when the VM starts.
  1. For the connection to the server, you should know the IP address of the VM. You can find it in the personal account of Azure. (You need to select the virtual machine from the list. By clicking the item “Overview”, your IP is displayed in the line “Public IP Address”).
  1. To work, you must open port 3000 (TCP) in the network properties in the Azure firewall.
  1. For the initial server configuration, go to the following address http://*vm_ip:3000 with any browser.
  1. In the first step, you need to fill in the data for the administrator account – your name (1), username (2), email (3) and password (4). Then click ‘Next’ (5)
  1. In the second step, you must enter information about the organization where Rocket.Сhat will be used. Filling data fields can be skipped and then press ‘Next’.
  1. In the third step, confirm your agreement to the Terms, Conditions and Privacy Policy (1). This item can be also left unchanged and press ‘Register’ (2).
  1. Confirm changing IP
  1. You have been sent an email confirming your registration
  1. Go to your mail client and confirm registration
  1. You have been redirected to the next page
  1. Return to your Rocket.Chat page – it’s ready.
  1. The server setup is complete. You can invite new members using the link
  1. You can use it through the application client that will be most convenient for you (you can find a list of them on the Rocket.Chat website) or the web version.

Connect to a VM using PuTTy

  1. To manage with a server you should connect to a VM.
    1. With OpenSSH

In the Windows 10 operating system (starting with version 1809 ), an OpenSSH client is available, with which you can connect to Linux servers via SSH. If Windows 10 is suitable and the OpenSSH client is installed, you can start connecting via SSH. To do this, launch a normal Windows command prompt and enter the command “ssh user@*vm_ip*” (1), where “user” is the username that was specified while creating the virtual machine and “*vm_ip*” is the VM IP address.

Then type “Yes” (2) and enter a password (3) that was specified while creating the virtual machine.

  1. With the PuTTy application 

To do this you need the PuTTy application to connect via ssh. You can download it at the following link – Download

Run Putty, enter the VM address in the “Host” field (1) and click “Open” (2) to connect.

In the opened console you will need to enter a username (1) and password (2) that were specified while the VM was being created (you’ll not see the password in the console while entering it). 

  1. Enter the next commands:

sudo service snap.rocketchat-server.rocketchat-server status – checking server service status

sudo service snap.rocketchat-server.rocketchat-server restart – server service restart

Official instructions for configuring and working with Rocket.Chat:

User Guides

Administrator Guides