DioxusLabs/dioxus · error

failed to create directories for settings file

Error message

failed to create directories for settings file: {e}

What it means

Filesystem guard in CliSettings::save: creating the parent directory chain for the global CLI settings file (via fs::create_dir_all) failed, so the serialized settings cannot be written. This is an environment/permissions failure on the settings directory path — the input at fault is the settings file's parent path reported alongside the OS error.

Solutions

1. The settings directory cannot be created. Check permissions on the config directory.

When it happens

Trigger: Thrown at packages/cli/src/settings.rs:92 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of DioxusLabs/dioxus@24f6a829df (2026-08-23). Data as JSON: /api/errors/e9033152a325f2ef. Report an issue: GitHub.

Appendix: source

Thrown at packages/cli/src/settings.rs:92

    /// This does not save to project-level settings.
    pub(crate) fn save(&self) -> Result<()> {
        let path = Self::get_settings_path();

        let data = toml::to_string_pretty(&self).map_err(|e| {
            error!(dx_src = ?TraceSrc::Dev, ?self, "failed to parse config into toml");
            anyhow::anyhow!("failed to parse config into toml: {e}")
        })?;

        // Create the directory structure if it doesn't exist.
        let parent_path = path.parent().unwrap();
        if let Err(e) = fs::create_dir_all(parent_path) {
            error!(
                dx_src = ?TraceSrc::Dev,
                ?data,
                ?path,
                "failed to create directories for settings file"
            );
            bail!("failed to create directories for settings file: {e}");
        }

        // Write the data.
        let result = fs::write(&path, data.clone());
        if let Err(e) = result {
            error!(?data, ?path, "failed to save global cli settings");
            bail!("failed to save global cli settings: {e}");
        }

        Ok(())
    }

    /// Modify the settings toml file - doesn't change the settings for this session
    pub(crate) fn modify_settings(with: impl FnOnce(&mut CliSettings)) -> Result<()> {
        let mut _settings = CliSettings::load();
        let settings: &mut CliSettings = Arc::make_mut(&mut _settings);
        with(settings);
        settings.save()?;

View on GitHub (pinned to 24f6a829df)