Advanced usage

Using multiple configurations

The agent supports multiple configuration files. When multiple configurations are found by the agent, the tray icon menu is expanded to contain the different configurations:

The default config.ini file contains common configurations, every other config file inherit from it.

To create multiple configuration files:

1. Click the Arduino Create Agent tray bar icon.
2. Select Quit Agent from the menu.
3. Find the config.ini file that is present in the arduino-create-agent installation folder.
4. Copy config.ini or create a new ini file (e.g. example.ini) with content:

   name = your configuration name

   add in this file other configuration options (you can override inherited values from config.ini)
5. Restart the agent.
6. Click the tray bar icon.
7. 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 supports working behind a proxy, but manual configuration is required (there is no support for automatic proxy discovery).

To add proxy configuration:

1. Click the Arduino Create Agent tray bar icon.
2. Select Quit Agent from the menu.
3. Find the config.ini file that is present in the arduino-create-agent installation folder.
4. Copy config.ini to a new file (e.g. proxy.ini) with content:

   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
5. Restart the agent.
6. Select the proper Proxy profile as in the image.

Your agent will now work behind a proxy.