Platform Manager

Plaform Manager aka. PMNG is a NodeJS program to manage dockerized projects on a physical machine or a virtual server, including Docker management, admin panel, Git server and many more...

Requirements

This project requires a Unix-based operating system (Windows and MacOS are not supported) running NodeJS v15.0.0 or above and Yarn.

The only officially supported platform is Ubuntu, but any other should work including Debian.

This program also requires a MariaDB server and Docker (these can run on another device). They can be installed using the following command on Debian and its derivatives (as root):

apt install mariadb-server docker

Installation

PMNG starts as root but drops its privileges after all the port bindings are done, so make sure to have a user ready for that, like pmng.

As root, create a directory for the program and clone the program inside the newly created directory:

mkdir /etc/pmng && cd /etc/pmng
git clone https://github.com/th0m4s/platform_manager.git .

Now edit with your favorite editor the .env conf file:

nano .env

Check .env.sample for a list of all available settings. Further edits of this file should be done as your program user to avoid permission errors.

Only when your configuration is ready and still as root, run the checkinstall Yarn command to install some system files, check permissions and install node packages inside node_modules with:

yarn run checkinstall

Then your setup is ready, you can start the service as root with:

service pmng start

And stop or restart it with (still as root):

service pmng (stop|restart)

Update

You need to pull the files (not as root) from the repository with:

git pull

If you see that yarn.lock, package.json or a file inside /utils was modified, please run as root the checkinstall Yarn command to update system files and/or node_modules:

yarn run checkinstall

When you're ready, restart the service (as root) with:

service pmng restart