Giter VIP home page Giter VIP logo

superadmin's Introduction

MIT License

Support

Installation

IMPORTANT

  • SuperAdmin is running on port 9999 which can be changed in run.sh script in /www/superadmin/run.sh
  • SuperAdmin is auto-generating port numbers for new applications starting from 8000. So for 100 apps you need to make sure ports 8000-8099 are free.
  • SuperAdmin must be run as root

Install requirements:

  • curl
  • openssl

SuperAdmin requirements:

  • bash
  • lsof
  • ps
  • netstat
  • ifconfig
  • uptime
  • grep
  • awk
  • wc
  • du
  • cat
  • free
  • df
  • tail
  • last
  • tar
  • cp
  • mkdir
  • npm

To install SuperAdmin run commands bellow:

$ wget https://cdn.totaljs.com/superadmin.sh && sudo bash superadmin.sh
  • login user: admin, password: admin (credentials are stored in /www/superadmin/config)
  • manually run (if you didn't register cron in the installation) $ cd /www/superadmin/ and $ bash run.sh

How do I translate SuperAdmin?

  • install Total.js as global module npm install -g total.js
  • then open SuperAdmin directory cd superadmin
  • then perform this command totaljs --translate
  • translate translated file translate.resource
  • and copy the content to /resources/default.resource
  • run app

Where does SuperAdmin store data?

All data are stored in /superadmin/databases/ directory. Applications are stored in application.json.


How to upload my application?

SuperAdmin uses a Total.js package mechanism. The mechanism creates a package file with a complete directory structure and all files.

  • first you have to install Total.js framework as a global module $ npm install -g total.js
  • then perform a command below:
$ cd myapplication
$ tpm create myapp.package
  • tpm creates a package file
  • and this file you can upload via SuperAdmin

Upload a new application


How to upgrade my older SuperAdmin version?

Don't worry, it's very easy.

  • backup file /databases/applications.json
  • backup your credentials in /config file (only credentials, nothing more)
  • copy all directories and files from a new version of SuperAdmin to your server
  • restore your backup file /databases/applications.json
  • restore your credentials in /config
  • you have to update SSL generator to latest version via bash /www/superadmin/ssl.sh --update
  • restart SuperAdmin bash run.sh
  • clear cache in your web browser

Nice to know

Bash script superadmin/ssl.sh can create or renew certificate manually:

# CREATE:
$ bash ssl.sh superadmin.mydomain.com

# RENEW:
$ bash ssl.sh superadmin.mydomain.com --renew

Uninstall SuperAdmin

  • stop all apps in SuperAdmin
  • kill SuperAdmin using this command $ kill -9 $(lsof -i :9999 | grep "total" | awk {'print $2'}) > /dev/null
  • to replace nginx.conf with backed up file use this command $ cp /etc/nginx/nginx.conf.backup /etc/nginx/nginx.conf
  • reload nginx service nginx reload and/or just stop it $ service nginx stop
  • if you added a cron job to start apps at system startup then remove this line @reboot /bin/bash /www/superadmin/run.sh from crontab using $ crontab -e command
  • remove /www/ folder, this will remove all ssl certificates, nginx conf files, all applications, etc.
  • to remove node.js run $ apt-get remove -y nodejs
  • to remove nginx run $ apt-get remove -y nginx
  • to remove graphicsmagick run $ apt-get remove -y graphicsmagick

## Contributors

superadmin's People

Contributors

athuli7 avatar jodumont avatar molda avatar petersirka avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.