Install with container image

Install on Linux - Docker

Steps to install on your linux machine with docker

  • create directory for MyController server data and other usages
    mkdir -p /opt/apps/mycontroller/mc_home
    mkdir -p /opt/apps/mycontroller/mc_home/secure_share
    mkdir -p /opt/apps/mycontroller/mc_home/insecure_share
  • copy mycontroller.yaml file
    cd /opt/apps/mycontroller
    curl \
      --output mycontroller.yaml

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 influx_database 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 host ip address
          disabled: false
          type: influxdb
          uri: # must be updated with your host ip address
          bucket_name: mycontroller
          flush_interval: 5s
  • Optional - update bus configuration as follows in your mycontroller.yaml, if you plan to use external bus

    • server should be installed and running
    • server installation guide
    • IMPORTANT server_url - must point to the server ip address.
        type: natsio
        topic_prefix: mc_communication_bus
        server_url: nats:// # must be updated with your host ip address
        insecure: false
        connection_timeout: 10s
  • Start the MyController server

    docker run --detach --name mycontroller \
      --publish 8080:8080 \
      --publish 8443:8443 \
      --publish 9443:9443 \
      --volume $PWD/mc_home:/mc_home \
      --volume $PWD/mycontroller.yaml:/app/mycontroller.yaml \
      --env TZ="Asia/Kolkata" \
      --restart unless-stopped \
  • Access MyController server Web UI

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

To see the logs

  • Prints all available logs
    docker logs mycontroller
  • Prints and tails the logs, to get exit do Ctrl+C
    docker logs --follow mycontroller


docker stop mycontroller


docker restart mycontroller


docker stop mycontroller
docker rm mycontroller
Last modified June 20, 2023: fix 2.0.0 tags (0c5e0b6)