Skip to content

Commit 2d79cf8

Browse files
authored
Merge pull request #234 from endorama/devel
Update README with multiple configuration and proxy informations
2 parents 66d8927 + 9b2a406 commit 2d79cf8

File tree

2 files changed

+36
-0
lines changed

2 files changed

+36
-0
lines changed

README.md

+36
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,42 @@ $ nohup $HOME/ArduinoCreateAgent-1.1/Arduino_Create_Bridge &
7575
```
7676
or in the location selected during the installation
7777

78+
## Using multiple configurations
79+
80+
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:
81+
82+
![Agent multiple configuration tray ycon](https://raw.githubusercontent.com/arduino/arduino-create-agent/devel/images/linux/tray-icon-multiple-profiles.png)
83+
84+
The default `config.ini` file contains common configurations, every other config file inherit from it.
85+
86+
To create multiple configuration files:
87+
- stop the agent: tray bar icon -> pause then tray bar icon -> kill
88+
- find the `config.ini` file that is present in the `arduino-create-agent` installation folder
89+
- copy `config.ini` or create a new ini file (e.g. `example.ini`) with content:
90+
```ini
91+
name = your configuration nanem
92+
```
93+
add in this file other configuration options (you can override inherited values from `config.ini`)
94+
- restart the agent
95+
- click the tray bar icon and select the new configuration
96+
97+
## When behind a proxy
98+
99+
The agent support working behind a proxy, but manual configuration is required ( there is no support for automatic proxy discovery ).
100+
101+
To add proxy configuration:
102+
- stop the agent: tray bar icon -> pause then tray bar icon -> kill
103+
- find the `config.ini` file that is present in the `arduino-create-agent` installation folder
104+
- edit the `config.ini` file adding this lines under the `[env]` section ( create it if not present ):
105+
```ini
106+
http_proxy=yourproxyhere
107+
https_proxy=yourhttpsproxyhere
108+
```
109+
- restart the agent
110+
111+
**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.
112+
113+
78114
# Contributing
79115

80116
Please use the current latest version:
9.87 KB
Loading

0 commit comments

Comments
 (0)