Linux

Setting up a QuickMeet.Chat development server on Linux involves several steps, including installing the necessary dependencies, configuring the server, and deploying QuickMeet.Chat. This guide will walk you through the process step by step.

The sample Linux distribution for this guide is Ubuntu. However, the steps are similar for other Linux distributions.

Prerequisites

• At least 12GB RAM is required for building in a development environment. For deployment and other uses, 2GB RAM suffices.

• Use a standard user account (not root) for setup. Avoid using sudo to prevent potential file permission issues.

You may notice build WARNINGs related to peer dependencies or other transitive dependencies. They are typically safe to ignore unless you are coding the required features or modules.

Set up a development environment in Linux

1. Install essential tools required by running this command:

sudo apt install g++ build-essential git curl python3

2. Install Node.js either manually or using a tool like nvm or volta.

Check the local development prerequisite to see the required NodeJS version for QuickMeet.Chat.

3. Install Deno by running:

curl -fsSL https://deno.land/install.sh | sh

For alternative installation scripts, check the official Deno installation documentation.

3. Install Meteor with the command below -  replacing x.x with the correct version number:

curl https://install.meteor.com/?release=x.x | sh

Note: Depending on the QuickMeet.Chat version, you may need to install a specific Meteor version:

• For QuickMeet.Chat <=6.x.x, use Meteor 2.x

• For QuickMeet.Chat >=7.x.x, use Meteor 3.x

Always verify the required Meteor version for your QuickMeet.Chat instance by checking the .meteor/release.

4. Install the yarn package manager with this command.

npm install --global yarn

5. Fork the QuickMeet.Chat repository on GitHub and clone it to your local system.

git clone https://github.com/<your-username>/QuickMeet.Chat.git

To install Git on Linux, see the official guide.

6. Navigate to the project directory and install all the dependencies by running these commands:

cd QuickMeet.Chat
yarn

7. When completed, build and run the server by executing this command:

yarn dsv

The first build can take ten or more minutes, and you may see various warnings or minor errors. Subsequent dev builds will take lesser time.

The server will start on port 3000, displaying the "Server Running" screen. Once running successfully, you can access QuickMeet.Chat on your machine through any browser or the QuickMeet.Chat client app at http://localhost:3000.

Edit QuickMeet.Chat files on Linux

For editing QuickMeet.Chat files,

1. Launch your IDE and navigate to the cloned repository folder.

2. Any modifications to QuickMeet.Chat triggers an automatic server rebuild.

3. Occasionally, changes might cause the server to shut down. In such cases, you can simply restart it to continue.

Given the extensive QuickMeet.Chat codebase, it's necessary to adjust the system parameter on your OS to optimize the efficiency of the file-change watcher.

References

• Development Environment Troubleshooting

Now that your development server is running, you're welcome to contribute to the QuickMeet.Chat server! See participate in QuickMeet.Chat development to learn more about QuickMeet.Chat contributions.