Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

nda-installer

fariz-codes36AGPL-3.00.7.1

An application to deploy NodeJS projects from an internet browser

application, browser, boot start, boot-start, cli, cron, deploy, deployment, devops, forever, forever-monitor, handler, handler, http, https, keep alive, keep process alive, Linux, logging, log management, logs, Mac OS, monitoring, nodemon, process handler, process logs, process logging, process manager, process run, project, project deployment, SSL, start on boot, start-on-boot, Windows

readme

Node Deployment Assistant @ NDA

Now deploy node projects from an internet browser

npm Downloads npm Downloads

Installation

Install NDA as a global package.

npm i nda-installer -g

Tested Operating Systems

  • Windows 11, Mac Monterey, RHEL 7.9, Ubuntu 20.04, Cent OS 7, Fedora 35

Prerequisite

Please complete the following prerequisite before installing the NDA

  • Install an internet browser.

  • Install NodeJS version >= 7.10.1.

About

Dashboard page

NDA helps you to deploy your NodeJS projects in an easier way. Once you configure your project with NDA, then you are only one click away from starting or restarting it.

  • Once a project is started using NDA, it will collects the project's logs & also monitors the CPU usage & status of the project.

  • Since the projects will be started in a keep alive mode, closing the browser window or the terminal (from where the NDA is launched) won't stop your NodeJs projects started by NDA.

How it works

  • When you start NDA, it will run a web application in the machine where it's installed.

  • By accessing that web application, you can handle the deployments of your NodeJS projects.

Demo

Please click here for a detailed explanation video.

Feature: Dashboard

This is the launching page of the NDA.

It provides the options to,

  • Add / Edit / Delete / Clone a project.
  • Run / Stop / Restart a project.
  • See the project logs.
  • Stop all projects (when more than one projects are running).

It has the functionality to,

  • Monitor status of the projects started by NDA & display a popup if a running project is crashed.
  • Update the CPU usage of the running projects periodically.

Feature: Configuration

This page will have the configuration options available for the NDA application.

Start-on-boot

If this is enabled, NDA application will be started during the system startup

Launch-on-boot

This will be available, only if the Start-on-boot option is enabled.

Once this option is enabled, NDA application will be opened in the default internet browser during the system startup.

Bind SSL Certificate

Using this option, a SSL certificate can be added to the NDA application.

Once enabled, NDA will be launched with https protocol.

Feature: Add Project

To start deploying your NodeJS projects, goto to the Add Project page by clicking on the (+) button in the dashboard.

  • In the Add Project page, provide your project's - name, folder path, start file path, port, environment variables & cron jobs.

  • Please check the information provided in the info icon against each inputs in the Add Project page to configure your project without successfully.

Feature: Logs

NDA stores the logs of running projects in a daily basis. To see all the logs available for a project, click the Logs icon under the Actions column against the corresponding project in the dashboard. It will navigate you to the logs list page.

  • The logs list page displays the list of log files created on a daily basis.

  • It provides the information like date, size & last modified time of the log files.

  • It also provides the options to delete or view the logs of a particular day.

  • To view the logs, click on the date against each log file. It will navigate you to the logs page.

  • Logs page displays the log contents based on the date.

  • To avoid overload, logs page is implemented with pagination & lazy load.

  • It displays the logs based on the line count selected in the dropdown near the Fetch button and it will fetch the next set of records when scrolled.

  • To fetch logs after a certain line, provide the line count in the text box near the Fetch button & then click on Fetch.

Available CLI Commands

  • To start NDA in 8055 (NDA's default port)
nda run
  • To start NDA in specific port
nda run <port>
Example: nda run 9000
  • To stop NDA
nda sleep
  • To get running status of NDA
nda status
  • To restart NDA & all the services started by it
nda respawn

Receiving Updates

  • To get the latest version
npm update nda-installer -g
  • To apply the latest changes
nda respawn

CHANGELOG

See Change Logs

DMCA.com Protection Status

License

NDA is licensed under GNU AGPL-3.0

For any queries or support, reach us at (mailto:fariz.codes@gmail.com)

changelog

0.7.0

  • Add options in configuration page to map ssl related files
  • Add functionality in start script to start the app with ssl
  • Handle protocol settings in views based on the ssl binding
  • Handle ssl based errors in app start script
  • Update UI in configuration page
  • Update README.md and package.json files

0.6.2

  • Update dashboard images

0.6.1

  • Functionality changes in logs list & logs content pages
  • Bugfix in logs content page

0.6.0

  • Include Clone option in the dashboard to create a project's copy in the project list
  • Update Readme file

0.5.1

  • Bugfixes in config module
  • Update Prerequisite block in Readme file
  • Updates in Package json file

0.5.0

  • Add functionality to select & delete a list of log files
  • Update content of logs list in Readme file
  • UI Changes in logs list page

0.4.3

  • Update project crash message to display all the crashed projects

0.4.2

  • Bugfixes in project start to ignore failed project starts

0.4.0

  • Add functionality to launch NDA on system boot
  • Add Start on boot option in the Add project page
  • Add functionality to run boot start enabled projects when NDA is launched
  • Update Readme file content

0.3.0

  • Add Configuration option in the Dashboard page
  • Add functionality to start NDA on system boot

0.2.7

  • Do code clean
  • Update package json file

0.2.4

  • Changes in Readme file

0.2.3

  • Bugfixes based on Mac OS
  • Bugfix in dashboard page
  • Use npm packages to check port availability & process kill

0.2.1

  • Fix for project start issue in Ubuntu OS (Modify port availability checking function to work based on OS type & version)

0.2.0

  • Fix issues in project starting for linux OS

  • Add nda respawn functionality

  • Increase interval time to receive project updates in dashboard page

  • Update readme file content

0.1.3

  • Fix alignment issues based on screen resolution in dashboard & logs pages

  • Update readme file content