diff --git a/README.md b/README.md index 4dddceeda..ffae287f1 100644 --- a/README.md +++ b/README.md @@ -4,14 +4,69 @@ arduino-create-agent ## Installation Get the latest version of the Agent for all supported platforms: -* [Windows](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-windows-installer.exe) -* [MacOSX](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-osx-installer.dmg) -* [Linux x64](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-linux-x64-installer.run) +### Windows +* [Windows with Edge](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-windows-installer-edge.exe) +* [Windows with Chrome](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-windows-installer-chrome.exe) +* [Windows with Firefox](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-windows-installer-firefox.exe) + +### MacOSX +* [MacOSX with Safari](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-osx-installer-safari.dmg) +* [MacOSX with Chrome](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-osx-installer-chrome.dmg) +* [MacOSX with Firefox](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-osx-installer-firefox.dmg) + +### Linux +* [Linux x64 with Chrome](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-linux-x64-installer-chrome.tar.gz) +* [Linux x64 with Firefox](http://downloads.arduino.cc/CreateBridgeStable/ArduinoCreateAgent-1.1-linux-x64-installer-firefox.tar.gz) arduino-create-agent is a fork of @johnlauer's serial-port-json-server (which we really want to thank for his kindness and great work) The history has been rewritten to keep the repo small (thus removing all binaries committed in the past) + + +## Using multiple configurations + +The agent support multiple configuration files. When multiple configurations are found by the agent, the tray icon menu is expanded to contain the different configurations: + +![Agent multiple configuration tray icon](https://raw.githubusercontent.com/arduino/arduino-create-agent/devel/images/linux/tray-icon-multiple-profiles.png) + +The default `config.ini` file contains common configurations, every other config file inherit from it. + +To create multiple configuration files: +- stop the agent: tray bar icon -> pause then tray bar icon -> kill +- find the `config.ini` file that is present in the `arduino-create-agent` installation folder +- copy `config.ini` or create a new ini file (e.g. `example.ini`) with content: + ```ini + name = your configuration name + ``` + add in this file other configuration options (you can override inherited values from `config.ini`) +- restart the agent +- click the tray bar icon and select the new configuration + +**Tip**: you can also use the multiple configurations feature to create a new configuration with the proxy settings. This way you can have multiple proxies configured and disable proxy configuration with ease. + +## When behind a proxy + +The agent support working behind a proxy, but manual configuration is required ( there is no support for automatic proxy discovery ). + +To add proxy configuration: +- stop the agent: tray bar icon -> pause then tray bar icon -> kill +- find the `config.ini` file that is present in the `arduino-create-agent` installation folder +- copy `config.ini` to a new file (e.g. `proxy.ini`) with content: + ```ini + name = Proxy Enabled + [env] + http_proxy=your.proxy.here + https_proxy=your.https.proxyhere + ``` +- please note spaces are not allowed before and after the string `http_proxy` +- restart the agent +- select the proper Proxy profile as in the image +- your agent will now work behind a proxy + +![Agent multiple configuration tray icon](https://raw.githubusercontent.com/arduino/arduino-create-agent/devel/images/linux/tray-icon-multiple-profiles.png) + + ## Disable Autostart ### Windows diff --git a/images/linux/tray-icon-multiple-profiles.png b/images/linux/tray-icon-multiple-profiles.png new file mode 100644 index 000000000..120bd9610 Binary files /dev/null and b/images/linux/tray-icon-multiple-profiles.png differ diff --git a/info.go b/info.go index 8a66ca474..8a84e479a 100644 --- a/info.go +++ b/info.go @@ -18,6 +18,8 @@ func infoHandler(c *gin.Context) { "https": "https://localhost" + portSSL, "ws": "ws://" + host + port, "wss": "wss://localhost" + portSSL, + "origins": origins, + "update_url": updateUrl, }) }