By Hitesh Jethva, Alibaba Cloud Tech Share Author. Tech Share is Alibaba Cloud's incentive program to encourage the sharing of technical knowledge and best practices within the cloud community.
Matrix is an open source protocol for real-time communication, Instant Messaging and VoIP. It is specially designed to allow a user with accounts at one communications service provider to communicate with users of a different service provider via online chat and Voice over IP. Matrix uses home servers to store your account information and chat history. Homeserver plays a key role to connect users. You can access Matrix server by either using a web browser or many other clients like, Riot, bots, bridges, servers and other implementations of the Matrix protocol.
Features
In this tutorial, we will learn how to install and configure Matrix Synapse on an Alibaba Cloud Elastic Compute Service (ECS) instance with Ubuntu 16.04.
First, log in to your https://ecs.console.aliyun.com">Alibaba Cloud ECS Console. Create a new ECS instance, choosing Ubuntu 16.04 as the operating system with at least 2GB RAM. Connect to your ECS instance and log in as the root user.
Once you are logged into your Ubuntu 16.04 instance, run the following command to update your base system with the latest available packages.
apt-get update -yBefore starting, you will need to install Nginx web server to your system. You can install Nginx easily by running the following command:
apt-get install nginx -y
Once Nginx is installed, start Nginx service and enable it to start on boot time using the following command:
systemctl start nginx
systemctl enable nginxNext, you can proceed to install Matrix Synapse.
Synapse is written in python but some of the libraries it uses are written in C. So you will need to install C compiler and other dependencies to your system. You can install all of them using the following command:
apt-get install build-essential python2.7-dev libffi-dev python-pip python-setuptools sqlite3 libssl-dev python-virtualenv libjpeg-dev libxslt1-dev -yBy default, Matrix Synapse is not available in Ubuntu 16.04 default repository. So you will need to install it from source.
First, create virtual environment for Synapse using the following command:
virtualenv -p python2.7 ~/.synapse
source ~/.synapse/bin/activateNext, upgrade pip and setup tools with the following command:
pip2.7 install --upgrade pip
pip2.7 install --upgrade setuptoolsFinally, install Synapse from source using the following command:
pip2.7 install https://github.com/matrix-org/synapse/tarball/masterNext, you will need to generate a configuration file for Synapse. First, change the directory to the ~/.synapse and generate configuration file using the following command:
python -m synapse.app.homeserver --server-name example1.com --config-path homeserver.yaml --generate-config --report-stats=yesYou should see the following output:
A config file has been generated in 'homeserver.yaml' for server name 'example1.com' with corresponding SSL keys and self-signed
certificates. Please review this file and customise it to your needs.
If this server name is incorrect, you will need to regenerate the SSL certificatesNext, you will need to create at least one user on your server to use a Matrix client. First, activate the Synapse source and start Synapse service using the following command:
source ~/.synapse/bin/activate
synctl startNext, register a new matrix user using the following command:
register_new_matrix_user -c homeserver.yaml https://localhost:8448You will be asked to enter username and password as shown below:
New user localpart [root]:admin
Password:
Confirm password:
Make admin [no]: Yes
Sending registration request...
Success.Matrix Synapse is now up and listening on port 8448. Now, you will need to configure Nginx to listen for these requests and pass them on to Synapse.
You can do this by creating /etc/nginx/sites-available/matrix.conf file:
nano /etc/nginx/sites-available/matrix.confAdd the following lines:
server {
listen 80;
listen [::]:80;
server_name example1.com www.example1.com;
location /_matrix {
proxy_pass http://localhost:8008;
}
location ~ /.well-known {
allow all;
}
}Save and close the file, when you are finished. Then enable matrix virtual host file using the following command:
ln -s /etc/nginx/sites-available/matrix.conf /etc/nginx/sites-enabled/Next, test the Nginx configuration for any syntax error with the following command:
nginx -tIf everything is fine, you should see the following output:
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successfulFinally, restart Nginx service to apply these changes:
systemctl restart nginxMatrix Synapse and Nginx is now installed and configured, it's time to access Matrix Synapse web interface.
Open your web browser and type the URL http://example1.com:8008, you will be redirected to the following page:
Provide your Matrix username, password and server URL, then click on the Login button. You should see the following page:
Riot is a glossy Matrix client built on top of matrix-react-sdk with an emphasis on performance and usability. Riot is very convenient to use chat applications from the desktop.
By default, Riot is not available in Ubuntu 16.04 default repository. So you will need to add Riot repository to the remote system.
On the remote system. Run the following command:
nano /etc/apt/sources.listAdd the following lines:
deb https://riot.im/packages/debian/ xenial mainSave the file, when you are finished. Then download and add GPG key to APT using the following command:
wget https://riot.im/packages/keys/riot.asc
apt-key add riot.ascFinally, update the APT repository and install Riot using the following command:
apt-get update -y
apt-get install riot-web -yOnce the installation is completed, open Riot from Unity Dash. You should see the following image:
Here, provide your Matrix server URL, username and password. Then click on the Sign In button. You should see the following image:
Congratulations! You have successfully installed Matrix server and Client to your system. All registered user now easily chats with each other using Riot chat client.
Alibaba Cloud Container Service can be integrated with Server Load Balancer, VPC, and other cloud services, allowing you to manage container applications from the console or terminal. The product maintains compatibility with native Kubernetes and provides security, high availability, and stable upgrading services. It is a fully managed cloud container management service that supports native Kubernetes and integrates with other Alibaba Cloud products. It replaces the need to install, operate and scale your container cluster infrastructure. Being a fully-managed service, Container Service for Kubernetes helps you to focus on your applications rather than managing container infrastructure.
Container Registry makes building, running, and maintaining a registry simple. Container Registry allows you to manage images throughout their entire lifecycle by providing secure image hosting, stable image building services as well as convenient image permission features. The product supports image hosting in multiple regions and integrates with other cloud container services, providing a one-stop solution for using Docker in the cloud. Container Registry is available at no cost for Alibaba Cloud account users.
2,605 posts | 747 followers
FollowAlex - June 21, 2019
Alibaba Clouder - July 5, 2019
Alibaba Clouder - June 13, 2019
Alex - June 21, 2019
Alibaba Clouder - March 25, 2019
Alibaba Clouder - August 16, 2019
2,605 posts | 747 followers
FollowLearn More
Learn More
ECS(Elastic Compute Service)
Elastic and secure virtual cloud servers to cater all your cloud hosting needs.
Learn MoreMore Posts by Alibaba Clouder