FreeCAD crashes, document recovery stalls out.
- Dominant language
- C++
- Stars
- 33.6k
- Forks
- 6k
- Avg merge
- 3d 15h
- Merged PRs (30d)
- 196
Description
### Problem description
FreeCAD crashed. The crash isn't the problem (it crashes every 5 to 30 mins). The problem is that now document recovery stalls out and FreeCAD freezes when it's starting up.
FreeCAD cache folder can be downloaded here: [v1-1.zip](https://github.com/user-attachments/files/29307045/v1-1.zip)
### Workbench affected?
None
### Steps to reproduce
Unpack the supplied freecad cache dir into the appropriate cache directory.
### Expected behavior
FreeCAD doesn't freeze on startup
### Actual behavior
FreeCAD freezes on startup.
### Development version About Info (in Safe Mode)
```shell
OS: Linux Mint 22.3 (X-Cinnamon/cinnamon/xcb)
Architecture: x86_64
Version: 1.1.1.20260414 (Git shallow) AppImage
Build date: 2026/04/14 22:09:59
Build type: Release
Branch: (HEAD detached at 0108fd4b4)
Hash: 0108fd4b4850cc46e625b60e53cea7a7bbe69f8d
Python 3.11.14, Qt 6.8.3, Coin 4.0.3, Vtk 9.3.1, boost 1_86, Eigen3 3.4.0, PySide 6.8.3
shiboken 6.8.3, xerces-c 3.3.0, IfcOpenShell 0.8.4, OCC 7.8.1
Locale: English/United States (en_US)
Navigation Style/Orbit Style/Rotation Mode: Touchpad/Rounded Arcball/Drag at cursor
Stylesheet/Theme/QtStyle: FreeCAD.qss/FreeCAD Dark/
Logical DPI/Physical DPI/Pixel Ratio: 96/208.711/1.59375
Installed mods:
* ava_helpers
* fasteners 0.5.60
```
### Last known good version (optional)
```shell
```
Contributor guide
Research direction
Unpack the supplied v1-1.zip cache into the appropriate cache directory and reproduce the startup freeze on Linux Mint 22.3 using the listed FreeCAD development build. Start by tracing the document recovery path used during startup; done means FreeCAD completes startup without freezing when recovering this document.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- cpp, linux
- Domain
- desktop
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100