FreeCAD / FreeCAD/FreeCAD

FreeCAD crashes, document recovery stalls out.

Open
#30,967 7 comments 0 reactions 0 assignees View on GitHub
Status: Needs confirmation Status: Needs example file Status: Needs test on dev version Type: Crash
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.