Slashboard Pulsar
A lightweight node js app designed to work with the Slashboard desktop client
Built using Node.js
Installation
-
Clone this repository somewhere safe on your server (
/var/wwwis often a good choice)cd /var/www # replace /var/www with the path you prefer if necessary git clone https://github.com/l3alr0g/Slashboard-pulsar.git
-
Install all the necessary dependencies
cd Slashboard-pulsar npm install
Automated installation (Linux only)
-
Run the installation script for your OS (only available for linux at the moment)
./scripts/install.sh
This script will :
- setup nodejs if necessary
- install pm2 (used to daemonize the app)
- generate a pairing key for your server, which will be later required by the desktop client
- at the end, it will ask you if you want to run Pulsar on system startup (recommended), if you answer yes, the script will give you a command, which you should paste and run in the terminal manually (I am working on automating this, but until now, this is mandatory)
Manual installation (Linux)
-
Setup pm2 :
npm install pm2 -g
-
Choose an authentification key and a server-specific secret :
nano config/default.json5
By default, the generated keys are 64 characters long, but you can choose shorter ones. When you'll open the file for the first time, The fields will contain the word "default". Erase it and write your key.
The field
serverKeyis the local server secret, andsharedSecretis the key used by the client to connect to your server. It will be later required when registering the server in the desktop app.Warning : no special characters allowed, only alphanumeric characters. Example :
CRml6VcWMGlH8UQ1XjintL1Tu71IA5ktbA5I8g0HzwrhF4E0hNE50O1ep7W2eNOu -
Allow traffic through port
6033:sudo ufw allow 6033
-
Start the app :
pm2 start ecosystem.config.js --env production
-
Tell pm2 to run it on system startup :
pm2 startup # execute the command pm2 gives you
Manual installation (Windows server)
-
Download nodejs and npm
-
Install pm2
npm install pm2 -g
-
Install pm2-windows-startup
npm install pm2-windows-startup -g pm2-startup install
-
Open
config/default.json5with your favorite editor, delete the default keys and write your own (see linux manual installation for more details).Warning : no special characters allowed, only alphanumeric characters. Example :
CRml6VcWMGlH8UQ1XjintL1Tu71IA5ktbA5I8g0HzwrhF4E0hNE50O1ep7W2eNOu -
Start the app:
pm2 start ecosystem.config.js --env production -
Setup pm2 to relaunch the app on system startup :
pm2 save
Accessing your server from anywhere on the internet
If you want to access your server's dashboard from outside its local network, you will probably need to forward a port in your router's configuration. Here's a quick guide to port forwarding, although I suggest that you look for something more specific, because router configuration really depends on your internet provider.
As for the port you need to forward, Pulsar runs on port 6033 by default (cannot be easily changed for now)
Uninstalling Pulsar
Simply run :
./scripts/uninstall.sh
or :
pm2 delete Pulsar
npm uninstall pm2 -g
sudo ufw delete allow 6033 # linux only
![[Bug]: Can't run Pulser](https://avatars.githubusercontent.com/u/59510695?v=4)
9 Jul 20, 2022
19 Jul 28, 2022
6 Oct 16, 2022
6 Oct 17, 2022
9 Aug 23, 2022
12 Jul 8, 2022
16 Mar 9, 2022
1 Feb 3, 2022
11 Mar 22, 2022
8 May 7, 2022
8 May 23, 2022
12 Jul 21, 2022
3 Aug 11, 2022
6 Dec 23, 2022
8 Sep 2, 2022
44 Dec 14, 2022
8 Dec 27, 2022
2 Feb 16, 2021