Install with executable binary

Install on Linux - Executable Binary


Steps to install the executable binary on your linux machine

Download Options

Choose the right executable bundle

Download the executable bundle that matches to your operating system architecture

Architectures

  • linux-arm - 32 bit ARM Linux
  • linux-arm64 - 64 bit ARM Linux
  • linux-386 - 32 bit Linux
  • linux-amd64 - 64 bit Linux
  • windows-386 - 32 bit Windows
  • windows-amd64 - 64 bit Windows

Download

  • create a directories to keep MyController server data and executable
    mkdir -p /opt/apps/mycontroller/mc_home  # directory to hold data
    mkdir -p /opt/apps/mycontroller/executable # directory to hold executable
    
    # create directories to keep image files to show it MyController dashboard
    # Example, camera stream image
    mkdir -p /opt/apps/mycontroller/mc_home/secure_share
    mkdir -p /opt/apps/mycontroller/mc_home/insecure_share
    
    # download the bundle and extract on executable directory
    cd /opt/apps/mycontroller
    wget https://download.mycontroller.org/v2/master/mycontroller-server-master-linux-arm.tar.gz
    tar xzf mycontroller-server-master-linux-arm.tar.gz  --strip-components=1 --directory /opt/apps/mycontroller/executable
    
  • now we have isolated MyController server data and executables, the expected result will be as follows,
  • NOTE: still, we have to keep the configuration file (mycontroller.yaml) file on the executable directory
    $ ls /opt/apps/mycontroller/mc_home  # MyController server data location
    insecure_share  secure_share
    
    $ ls /opt/apps/mycontroller/executable # MyController server executable location
    LICENSE.txt  logs  mcctl.sh  mycontroller-server  mycontroller.yaml  README.txt  web_console
    

Update mycontroller.yaml file

  • IMPORTANT: update your secret on the mycontroller.yaml file. DO NOT USE THE DEFAULT SECRET

  • secret can between 1 to 32 characters length

  • This secret used to encrypt your third party password, tokens used on this server

    secret: 5a2f6ff25b0025aeae12ae096363b51a # !!! WARNING: CHANGE THIS SECRET !!!
    
  • update influxdb configuration as follows in your mycontroller.yaml

    • prior to this step, influxdb should be installed and running with a database called mycontroller in influxdb
    • Influxdb installation guide
    • IMPORTANT uri - must point to the influxdb ip address. if you have installed on the same host, you can leave it as 127.0.0.1
    • update other fields as per your influxdb setup
      database:
        metric:
          disabled: false
          type: influxdb
          uri: http://127.0.0.1:8086 # must be updated with your host ip address
          token:
          username:
          password:
          organization_name:
          bucket_name: mycontroller
          batch_size:
          flush_interval: 5s
      
  • if you plan to use https with ACME(Letsencrypt) follow the detailed guide

  • Optional - if you plan to use external bus, update bus configuration as follows in your mycontroller.yaml

    • nats.io server should be installed and running
    • nats.io server installation guide
    • IMPORTANT server_url - must point to the nats.io server ip address. if you have installed on the same host, leave it as 127.0.0.1
      bus:
        type: natsio
        topic_prefix: mc_server
        server_url: nats://127.0.0.1:4222 # must be updated with your host ip address
        insecure: false
        connection_timeout: 10s
      
  • Start the MyController server

    cd /opt/apps/mycontroller
    executable/mcctl.sh start
    
  • Access MyController server Web UI

    • http: http://<host-ip>:8080 (example: http://192.168.1.21:8080)
    • https: https://<host-ip>:8443 (example: https://192.168.1.21:8443)

To see the logs

  • MyController log file is placed in the executable directory
    cd /opt/apps/mycontroller
    cat executable/logs/mycontroller.log
    
  • Prints and tails the logs, to get exit do Ctrl+C
    cd /opt/apps/mycontroller
    tail --follow executable/logs/mycontroller.log
    

Stop

cd /opt/apps/mycontroller
executable/mcctl.sh stop

Restart

cd /opt/apps/mycontroller
executable/mcctl.sh stop
executable/mcctl.sh start

Uninstall from your system

cd /opt/apps/mycontroller
executable/mcctl.sh stop
rm /opt/apps/mycontroller/executable --recursive --force
Last modified August 17, 2022: disable feedback and enable read time (c92e0f0)