IDE won't start if proxy configuration is invalid

[Toy-Jie]

Describe the problem

Stuck on load page, My last configuration is to set the proxy service

To reproduce

Set the proxy service 127.0.0.1, but the proxy is unavailable. Click Update Library, and it will be stuck on the start page after restart

Expected behavior

Arduino IDE starts up even if unable to access the network due to an invalid proxy configuration.

The user is able to correct their proxy configuration.

Arduino IDE version

2.0.2

Operating system

Windows

Operating system version

win10 21H2

Additional context

Additional reports

• https://forum.arduino.cc/t/arduino-2-0-will-not-start-past-the-loading-screen/1049023/13

Related

• IDE doesn't start when proxy configuration is required to access network #1438
• First run hangs if IDE fails to download assets #2042
• Unable to start Arduino IDE #2740

Issue checklist

• I searched for previous reports in the issue tracker
• I verified the problem still occurs when using the latest nightly build
• My report contains all necessary details

[per1234]

Hi @Toy-Jie. Thanks for your report.

The fault is the same as #1438. However, the path to the fault is different in that #1438 is about the IDE not starting due to not having a required proxy configured (which might be solved for most users by adding an automatic proxy configuration capability: #29), while your issue is about the IDE not starting because the user's manual proxy configuration is invalid. In this case, the only solution is to make the IDE resilient enough to this condition to allow the user to access the Preferences dialog to update the manual proxy configuration.

Workaround

1. Select File > Quit from the Arduino IDE menus if it is running.
2. Use any text editor to open the file at the following path:
   • Windows:

     C:\Users\<username>\.arduinoIDE\arduino-cli.yaml
     

     (where <username> is your Windows username)
   • Linux:

     ~/.arduinoIDE/arduino-cli.yaml
     

     ❗ The ~/.arduinoIDE/ folder may be hidden by default in your file manager and terminal.
   • macOS:

     ~/.arduinoIDE/arduino-cli.yaml
     

     ❗ The ~/.arduinoIDE/ folder is hidden by default. You can make it visible by pressing the Command+Shift+. keyboard shortcut.
3. Update the lines in the file that have this format:

   network:
     proxy: <proxy scheme>://<username>:<password>@<proxy address>:<port>
     user_agent_ext: daemon

   Where the placeholders are:
   • <proxy scheme>: the URL scheme for your proxy server.
     One of the following;
     • http
     • socks5
   • <username>: the username of your proxy server credentials.
   • <password>: the password of your proxy server credentials.
   • <proxy address>: the address of your proxy server.
   • <port>: the port of your proxy server.
     ⓘ If you no longer need to use a proxy, just delete those lines entirely.
4. Save the file.
5. Start Arduino IDE.