Sentinel dVPN
Project setup for developers
Overview
1. Install WireGuard and Sentinel CLI
It uses two rest servers which are included in sentinel-cli. Run the script to install dependencies:
sudo sh scripts/linux/install-dev-dependencies
There is an auto-launching daemon. It may be necessary to restart a system.
2. Install Node.js
Node.js must be 14.17.6 LTS or later. Download.
4. Install Vue CLI
CLI must be v4. Download.
5. Install npm dependencies
yarn install
# OR
npm install
Development
Compiles and hot-reloads for development
yarn electron:serve
Production
Compiles and minifies for production
yarn electron:build
The build will be placed in /dist_electron. There will be the unpacked application and a bundled executable file for your system.
Folder structure
├── dist_electron/
│ ├── bundled/.. # where webpack outputs compiled files
│ ├── linux-unpacked/.. # unpacked Electron app (main app and supporting files)
│ ├── Sentinel dVPN-[version].deb # installer for Electron app
│ ├── index.js # compiled background file used for electron:serve
├── bin/linux/ # additional application binaries
│ ├── sentinelcli-dvpn-desktop # cli-client
├── build/ # build resources directory
│ ├── icons/.. # shortcuts
├── public/.. # Files placed here will be available through __static or process.env.BASE_URL
├── scripts/.. # scripts to install or remove additional binaries and daemons
├── src/
│ ├── background.js # electron entry file (for Electron's main process)
│ ├── main.js # the app's entry file (for Electron's render process)
│ └── ...Troubleshooting
connect ECONNREFUSED 127.0.0.1:10000
The app uses two rest servers from sentinel-cli. The problem is the app uses the hard coded address to connect to the servers. If the host is not available the app won't work. Maybe it'll recognize an available host dynamically in the future.
The first server is a keyring handler. It's launched and closed together with the app.
The host 127.0.0.1 is hard coded for KeyApi.js and must be available.
The port value is taken from ~/.config/Sentinel\ dVPN/config.json keyringRestServerPort.
You can change it manually and restart the app.
There is a command how to run the server manually if the app doesn't launch it by itself.
sentinelcli-dvpn-desktop start --home ${HOME}/.sentinelcli-dvpn-desktop --listen 127.0.0.1:10000 --with-keyring
The second server is a connection service. It's used as a daemon and is installed with the app and started with a system.
The host and the port 127.0.0.1:12000 are hard coded for DvpnApi.js and must be available.
The daemon is described in scripts/linux/sentinelcli-dvpn.service.
You can change it, but you'll have to rebuild the app!
You can change the daemon script and reinstall it. Then change a port value in src/main/rest/dvpn.js. Then rebuild the app.
There is a command how to run the server manually if the daemon doesn't work.
sentinelcli-dvpn-desktop start --home ${HOME}/.sentinelcli-dvpn-desktop --listen 127.0.0.1:12000 --tty --with-service
key with name desktop_dvpn_key_name already added
The easiest way is to reinstall the app.
Or you can remove folder ~/.config/Sentinel\ dVPN, ~/.sentinelcli-dvpn-desktop and kill all sentinelcli-dvpn-desktop processes.