Skip to main content

Setting up Your Server Instance

Welcome to the Q root node server setup guide. This document provides comprehensive instructions on setting up a server to run a Q root node. There are several options available for running your node, and we will explore these alternatives in the following sections, providing clear steps for each approach.

Server Requirements​

The Q node is packaged as a Docker container, which means you can deploy and run it on any machine that supports Docker. Before starting the setup process, please ensure that your server or machine meets the following recommended requirements:

  • 2(v)Cores (x86)
  • 30 GB storage
  • 4 GB RAM

These specifications should ensure a smooth operation for your node. Furthermore, please ensure that you have opened the following port ranges on your machine:

  • Custom port range 30300-30400: These are necessary for external node connections.
  • Port range 8000-8999: These are required for running an RPC and WSS endpoint.

While these ports are generally open by default, it's recommended to verify these settings to prevent any potential connectivity issues.

Setup Options​

Local Machine​

You can run the Q node directly on your local machine. This setup is generally straightforward and convenient for testing or development purposes. It is not suited for a permanent and stable node operation on Q mainnet, especially if you lack professional node hosting experience.

Virtual Private Server (VPS)​

For those without prior node hosting experience, we recommend using a Virtual Private Server (VPS). These servers can be rented from various reliable cloud service providers, such as AWS, Google Cloud, or Digital Ocean. However, there are many other excellent alternatives available. We encourage you to conduct your research and contribute to the decentralization of the Q network by selecting a service provider of your choice.

Running your root node on a VPS has several advantages:

  • Stability: VPSs generally have higher uptime, and providers ensure regular maintenance and updates.
  • Scalability: It's easier to upgrade or downgrade your server resources (CPU, RAM, storage) based on your node's requirements.
  • Managed Services: VPS providers often include additional features like monitoring tools and security measures.

When setting up your root node on a VPS, we recommend choosing a server with the latest available Linux OS (Debian or Ubuntu) that meets the aforementioned requirements.

Once you've set up the server instance, you can proceed to learn how to access your server or directly start with the Root Node Server Setup.

We hope this guide aids you in establishing your server instance successfully. For additional assistance or any queries, please reach out to our support channels. Enjoy hosting on the Q network!