CLI Installation

Search…
CLI Installation
Soketi is based on uWebSocket.js, a Node.js-based WebSocket server, transpiled from C language. Before installing the CLI version, make sure you have the required dependencies to build soketi: Python 3.x, GIT, the gcc compiler and the dependencies for build.
The following example works for Ubuntu. For other distributions, consider using the equivalents.
1
apt install -y git python3 gcc build-essential
Copied!
Due to uWebSocket.js limitations, Soketi does not work on CentOS 7, but it works on CentOS 8. Check the Github issue.
Installing with NPM
Node.js LTS (14.x, 16.x, so on) is required due to uWebSockets.js build limitations.
soketi may be easily installed via the NPM CLI:
1
npm install -g @soketi/soketi
Copied!
After installation, a soketi server using the default configuration may be started using the start command:
1
soketi start
Copied!
By default, this will start a soketi server at 127.0.0.1:6001 with an application ID of app-id, application key of app-key, and application secret of app-secret.
Supervisor
To keep the soketi server alive permanently, you should consider installing a process manager such as supervisor, a daemon that can run and restart processes in the background. After installing Supervisor, you may use the following example configuration as a good starting point for launching a soketi server:
1
[program:soketi]
2
process_name=%(program_name)s_%(process_num)02d
3
command=soketi start
4
autostart=true
5
autorestart=true
6
stopasgroup=true
7
killasgroup=true
8
user=ubuntu
9
numprocs=1
10
redirect_stderr=true
11
stdout_logfile=/var/log/soketi-supervisor.log
12
stopwaitsecs=60
13
stopsignal=sigint
14
minfds=10240
Copied!
As you can see in the configuration above, a single soketi server will be started, and this server will auto-restart on failure. Logs will be written to /var/log/soketi-supervisor.log.
It's important to note that the stopwaitsecs and stopsignal configuration options should be set as in the example above. If necessary, you can increase stopwaitsecs to a larger value. This is the number of seconds Supervisor will allow soketi to gracefully close all connections when the server is stopping or restarting.
In Linux environments, everything is a file, including active sockets. To track socket connections, soketi is creating file descriptor for each connection. In some cases, you may run into a soft limit on file descriptors set by your operating system. In this situation, you can set the Supervisor minfds configuration option to a higher value to allow the operating system to handle more connections.
Scaling across threads with PM2
Node.js is meant to be ran on one CPU at a given time. This means that multi-threading isn't actually multi-threading in its common sense. To fix this problem, you may use the PM2-ready binary that is shipped with any soketi installation:
1
soketi-pm2 start
Copied!
The only remaining caveat is that the processes are like they are horizontally scaled. You may want to configure horizontal scaling with the cluster adapter, unless you are also scaling across multiple different instances, in which Redis is the recommended adapter.
Getting started - Previous
Installation
Docker
Last modified 1mo ago
Copy link
Contents
Installing with NPM
Supervisor
Scaling across threads with PM2