Skip to main content

How to Reset / Move FreeCAD to Default Settings (Windows, Linux)

FreeCAD stores user settings in configuration files that are often hidden from plain view. If your FreeCAD setup becomes unstable, like toolbars disappearing, settings not saving, or weird startup behavior, resetting these files can help return the program to its default state.

This guide will walk you through how to reset your FreeCAD preferences on Windows and other platforms, plus how to move them between installations.

🔧 What Are FreeCAD Configuration Files?

FreeCAD saves custom settings like:

  • User interface layout (toolbars, themes)

  • Recently opened files

  • Preferences and tool configurations

These are stored in small files called user.cfg and system.cfg. Sometimes, these files can get corrupted after updates or crashes.

💥 When Should You Reset FreeCAD Settings?

You might want to reset your settings if:

  • FreeCAD doesn’t open correctly

  • Menus or workbenches are missing

  • Custom UI changes have broken something

  • You're troubleshooting a weird bugs

Backup Your FreeCAD Config Files

Close FreeCAD before proceeding.

  1. Find the Configuration Folder:

    • On Windows: Go to C:\Users\<your_username>\AppData\Roaming\FreeCAD. If you don’t see the AppData folder, you might need to enable the option to show hidden files.  Note: this can also be found by using %USERPROFILE%\AppData\Roaming\FreeCAD\

    • On Linux/macOS: The folder is usually at ~/.config/FreeCAD or  /home/username/.FreeCAD/

    • There are normally two files that contain: User settings: user.cfg and System settings: system.cfg on Linux the Toolbar configuration is stored separately in: $HOME/.config/FreeCAD/FreeCAD.conf

  2. Backup the Folder:

    • Copy the entire FreeCAD folder and save it somewhere safe.

  3. Restore When Needed:

    • If you're installing a new version or setting up on another computer, just copy the saved FreeCAD folder back to its original spot in your user profile.


Do You Want To Move / Restore?

If you want to move your settings to, say, another computer or you want to replace your current settings with the backed up version just copy them into the relevant places.

Do You Want To Reset?

To reset FreeCAD to its default state (including UI and toolbars) after you have backed up the files you can delete the originals from your, follow these steps:

For convenience, you can save these commands in a batch file (e.g., fc3dReset.bat) to create a one-click solution i.e for windows if you wanted to delete the files or change the script to, say, rename them .

del %AppData%\FreeCAD\system.cfg

del %AppData%\FreeCAD\user.cfg

By following these steps, you can reset FreeCAD to its default state. Save the relevant commands in a script for ease of use if needed.

Note: This may not reset the colour theme which can be reset from the preferences.

✅ Summary

Resetting FreeCAD settings can fix a wide range of issues and is a safe, beginner-friendly solution. Just remember to make a backup before deleting any files.

Comments

Post a Comment

Popular posts from this blog

Beginners FreeCAD: Exercise 5.1 & 5.2 (Reference Images)

Welcome to the total beginners course to FreeCAD 0.20. In this is a two part lesson we will practice our tracing skill in the form of a mini project. Using the below reference photos we will create a more complex part which will consist of repeating features. We will utilise the symmetry tools to ease construction in both FreeCAD sketcher and Part Design workbench. This project work will help teach the fundamentals of freeCAD allowing a understanding of the basics but delivering this information via teaching you different workflows. In this tutorial we will be tracing photos imported into FreeCAD via the image workbench https://wiki.freecadweb.org/Image_Workbench JUMP TO IMAGES Do you want to purchase the complete series along with others and keep forever?  Check out my shop https://ko-fi.com/mang0/shop The story of this tutorial The idea and first attempt at creating this tutorial was back in FreeCAD 0.18.  The physical part itself, well, I have no idea what really it is, i...
5 comments
Read more

FreeCAD For Beginners: CAD Thinking Part 1

Step-by-Step CAD Thinking FreeCAD Tutorial: Modeling a Latch Part (Part 1) Learning how to turn real life objects into CAD Models. Using FreeCAD we explain at a beginner level how to break down a physical object into its primitive shapes to digitise it into a 3D model, with this episode we are looking at a multi-part assembly, modelling each piece individually. The series aims to open your eyes and mind giving you the ground skills to pick the correct profiles, geometry and workflow when it comes to modelling your parts. This is not just for FreeCAD but for all CAD packages out there. Introduction This tutorial is the first in a series guiding you through modeling a latch assembly in FreeCAD (version 0.21) using the Part Design and A2Plus workbenches. It focuses on modeling the first part (a slotted component) by selecting the top profile to create a slot and adding side arcs, emphasizing CAD thinking to break down complex shapes into primitives. The tutorial highlights model stability...
2 comments
Read more

Beginner FreeCAD Tutorial 14: Reference Document for Exercise 1

This tutorial focuses on modelling a deck eye plate. These items are normally made of stainless steel with some kind of galvanised coating to stop corrosion. They are used in many industries but are most commonly found around boats, ships, sail lofts and docks where they play an important part in marine industry. Finding their use in many applications, they are often wall mounted acting as lashing points for mooring and for tying down sails or canopies. They can even be used for domestic use around the house and garden, for example to anchor ropes, cords and lines. So if your into 3D printing your finished creations, you can make use of the finished result.   Disclaimer : The strength of the part will depend on the internal structure, settings of the slicer and the material it has been printed on.  This will limit its application as failure of the part, damage to property and injury is a possibility.  These items are normally made of steel and are tested to take a...
1 comment
Read more