Installation

First of all, check it completely according to requirement.

  1. Clone NetCoCo-UI.

     # git clone https://github.com/mrzack99s/netcoco-ui
  2. Install dependency.

    • Yarn (Recommend)

       # yarn install
    • NPM

       # npm install
  3. Change base URL of API at file .env.production.

     VUE_APP_VERSION=<NetCoCo-version>
     VUE_APP_ROOT_API=http://<Domain or Hostname>:8080
  4. Build NetCoCo-UI with production.

    • Yarn (Recommend)

       # yarn build --mode production
    • NPM

       # npm build --mode production
  5. Make NetCoCo directory and create sub-directory

    • Linux

       |usr
          |share
             |netcoco
                |templates
                   |dist
                   | .......
                |config.yaml
                |netcoco-linux-amd64

      Make directory with sudo mkdir /usr/share/netcoco

    • Windows

       |NetCoCo
          |templates
             |dist
             | .......
          |config.yaml
          |netcoco-windows.exe
  6. Download templates and executable file from Github releases

  7. Untar or unzip templates

  8. Copy /dist of NetCoCo-UI to /templates of NetCoCo.

  9. Create config.yaml in NetCoCo directory with executable file. (In linux: /usr/share/netcoco)

      netcoco:
          port: <port-number> #(default: 8080)
          db:
              sql:
              hostname: <db-hostname>:<db-port>
              username: <db-username>
              password: <db-password>
              db_name: <db-name>
          security:
              salt: <salt-in-hex-32digit>
  10. Edit main.js in NetCoCo directory. (In linux: /usr/share/netcoco/templates/js)

      const BASE_API_URL = 'http://<Hostname or Domain name>:<port>/v1.0-alpha/secure/api';
  11. On Linux, must install the netcoco service

    • Download service file

       # sudo curl -L https://raw.githubusercontent.com/mrzack99s/netcoco/main/netcoco.service -o /etc/systemd/system/netcoco.service
    • Enable and start service

       # sudo systemctl enable --now netcoco
    • Enable sysctl ping

      # sudo sysctl -w net.ipv4.ping_group_range="0 2147483647"
  12. On Windows, run executable file.

Last updated