Skip to content

Commit 6c2129a

Browse files
Document "Configuration folder" and "User Data folder" (#299)
* Add additional folders * Additional info about the Configuration and User Data folders * Apply suggestions from code review Co-authored-by: Renat0Ribeir0 <[email protected]> * Update content/Software Support/Installation/Uninstall-Arduino-IDE.md Co-authored-by: Renat0Ribeir0 <[email protected]> --------- Co-authored-by: Renat0Ribeir0 <[email protected]>
1 parent cd7cc5c commit 6c2129a

File tree

2 files changed

+83
-4
lines changed

2 files changed

+83
-4
lines changed

content/Software Support/IDE Settings/Find-sketches-libraries-board-cores-and-other-files-on-your-computer.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -143,6 +143,34 @@ Generally, the contents of this folder should not be changed.
143143
144144
---
145145
146+
## Configuration folder (.arduinoIDE)
147+
148+
The **.arduinoIDE** folder contains configuration files like `settings.json` and `arduino-cli.yaml`.
149+
150+
Default location:
151+
152+
* **Windows:** `C:\Users\{username}\.arduinoIDE` (hidden)
153+
* **macOS:** `/Users/{username}/.arduinoIDE` (hidden)
154+
* **Linux:** `/home/{username}/.arduinoIDE` (hidden)
155+
156+
This folder is only used by Arduino IDE 2.
157+
158+
---
159+
160+
## User data folder (arduino-ide)
161+
162+
The **arduino-ide** folder contains various temporary files. Removing this folder can sometimes resolve problems with Arduino IDE.
163+
164+
Default location:
165+
166+
* **Windows:** `C:\Users\{username}\AppData\Roaming\arduino-ide\`
167+
* **macOS:** `~/Library/Application Support/arduino-ide/`
168+
* **Linux:** `~/.config/arduino-ide/`
169+
170+
This folder is only used by Arduino IDE 2.
171+
172+
---
173+
146174
## Further reading
147175
148176
* [Where can I find the Arduino15 folder?](https://support.arduino.cc/hc/en-us/articles/360018448279-Where-can-I-find-the-Arduino15-folder-)

content/Software Support/Installation/Uninstall-Arduino-IDE.md

Lines changed: 55 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -22,17 +22,68 @@ Learn how to uninstall Arduino IDE.
2222

2323
## Removing additional files
2424

25-
Arduino IDE saves your sketches, library files and board cores outside the application folder. This way, they will still be available if you're updating Arduino IDE to a different version, or if you reinstall it later. Optionally, you can also remove these files:
25+
Arduino IDE saves your sketches, library files and board cores outside the application folder. This way, they will still be available if you're updating Arduino IDE to a different version, or if you reinstall it later. Optionally, you can also remove these files.
2626

27-
[The Sketchbook](https://support.arduino.cc/hc/en-us/articles/4412950938514) contains your saved sketches and installed libraries. It is located in your Documents folder by default, inside the `Arduino` subfolder.
27+
**If you're reinstalling Arduino IDE as a troubleshooting procedure, try the following:**
28+
29+
* To resolve console errors that appear when compiling or uploading sketches, remove the [Arduino15](#Arduino15) and [libraries subfolder](#sketchbook) and restart Arduino IDE.
30+
* To resolve problems with Arduino IDE itself, remove the [User data folder](#user-data-folder) and restart Arduino IDE.
31+
32+
<a id="sketchbook"></a>
33+
34+
### Sketchbook
35+
36+
The [Sketchbook](https://support.arduino.cc/hc/en-us/articles/4412950938514) contains your saved sketches and installed libraries.
37+
38+
Default Sketchbook location:
2839

2940
* **Windows:** `C:\Users\{username}\Documents\Arduino`
3041
* **macOS:** `/Users/{username}/Documents/Arduino`
3142
* **Linux:** `/home/{username}/Arduino`
3243

33-
[The Arduino15 folder](https://support.arduino.cc/hc/en-us/articles/360018448279). Located in these locations by default:
44+
Default libraries subfolder location:
45+
46+
* **Windows:** `C:\Users\{username}\Documents\Arduino\libraries`
47+
* **macOS:** `/Users/{username}/Documents/Arduino/libraries`
48+
* **Linux:** `/home/{username}/Arduino/libraries`
49+
50+
<a id="Arduino15"></a>
51+
52+
### Arduino15 folder
53+
54+
The [Arduino15 folder](https://support.arduino.cc/hc/en-us/articles/360018448279) contains installed board packages and tools.
55+
56+
Default location:
3457

3558
* **Windows:** `C:\Users\{username}\AppData\Local\Arduino15`. Open your Users folder in Explorer and look for a folder called `AppData`.
3659
* This folder is hidden by default. In newer versions of Windows, you can display hidden items by clicking the **View** tab, and checking _Hidden items_.
37-
* **macOS:** `/Users/{username}/Library/Arduino15` Open Finder and navigate to the home folder `(/Users/{username})`. From the Finder menu bar, click on `View > Show View Options`, and tick _Show Library Folder_. The `Arduino15` folder can now be found in `{username}/Library`.
60+
* **macOS:** `/Users/{username}/Library/Arduino15`. Open Finder and navigate to the home folder `(/Users/{username})`. From the Finder menu bar, click on `View > Show View Options`, and tick _Show Library Folder_. The `Arduino15` folder can now be found in `{username}/Library`.
3861
* **Linux:** The folder is located in `home/{username}/.arduino15` and is hidden by default. To show it, click the hamburger button and check Show Hidden Files.
62+
63+
### Configuration folder (.arduinoIDE)
64+
65+
The **.arduinoIDE** folder contains configuration files like `settings.json` and `arduino-cli.yaml`.
66+
67+
Default location:
68+
69+
* **Windows:** `C:\Users\{username}\.arduinoIDE` (hidden)
70+
* **macOS:** `/Users/{username}/.arduinoIDE` (hidden)
71+
* **Linux:** `/home/{username}/.arduinoIDE` (hidden)
72+
73+
This folder is only used by Arduino IDE 2.
74+
75+
<a id="user-data-folder"></a>
76+
77+
### User data folder (arduino-ide)
78+
79+
The **arduino-ide** folder contains various temporary files. Removing this folder can sometimes resolve problems with Arduino IDE.
80+
81+
Default location:
82+
83+
* **Windows:** `C:\Users\{username}\AppData\Roaming\arduino-ide\`
84+
* **macOS:** `~/Library/Application Support/arduino-ide/`
85+
* **Linux:** `~/.config/arduino-ide/`
86+
87+
This folder is only used by Arduino IDE 2.
88+
89+
<!-- NOTE: https://forum.arduino.cc/t/how-to-disable-opening-last-sketch-on-startup/1037122/2 -->

0 commit comments

Comments
 (0)