{"record":{"id":"d92d77a4a66d48f5","repo":"zellij-org/zellij","slug":"this-zellij-was-built-without-bundled-plugins-fea","errorCode":null,"errorMessage":"This zellij was built without bundled plugins (feature 'disable_automatic_asset_installation'). Builtin plugins are provided by the distributor of this build and must be placed in the plugin directory, visible in the output of `zellij setup --check`.","messagePattern":"This zellij was built without bundled plugins \\(feature 'disable_automatic_asset_installation'\\)\\. Builtin plugins are provided by the distributor of this build and must be placed in the plugin directory, visible in the output of `zellij setup --check`\\.","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"zellij-utils/src/setup.rs","lineNumber":406,"sourceCode":"\n        if let Some(swap_layout) = &self.dump_swap_layout {\n            dump_specified_swap_layout(swap_layout)?;\n            std::process::exit(0);\n        }\n\n        Ok(())\n    }\n\n    /// Checks the merged configuration\n    pub fn from_cli_with_options(&self, opts: &CliArgs, config_options: &Options) -> Result<()> {\n        if self.check {\n            Setup::check_defaults_config(opts, config_options)?;\n            std::process::exit(0);\n        }\n\n        if let Some(maybe_path) = &self.dump_plugins {\n            if cfg!(feature = \"disable_automatic_asset_installation\") {\n                return Err(anyhow!(\n                    \"This zellij was built without bundled plugins (feature \\\n                     'disable_automatic_asset_installation'). Builtin plugins are provided by the \\\n                     distributor of this build and must be placed in the plugin directory, \\\n                     visible in the output of `zellij setup --check`.\"\n                ))\n                .context(\"failed to dump plugins\");\n            }\n            let data_dir = &opts.data_dir.clone().unwrap_or_else(get_default_data_dir);\n            let dir = match maybe_path {\n                Some(path) => path,\n                None => data_dir,\n            };\n\n            println!(\"Dumping plugins to '{}'\", dir.display());\n            dump_builtin_plugins(&dir)?;\n            std::process::exit(0);\n        }\n","sourceCodeStart":388,"sourceCodeEnd":424,"githubUrl":"https://github.com/zellij-org/zellij/blob/98a0837077492d53dd252ab30bc3e43e41e504f4/zellij-utils/src/setup.rs#L388-L424","documentation":"Returned by Setup::from_cli_with_options when `zellij setup --dump-plugins` is run on a binary compiled with the disable_automatic_asset_installation feature. Such builds embed no plugin assets, so there is nothing to dump; the distributor is expected to ship plugins separately in the plugin directory.","triggerScenarios":"Running `zellij setup --dump-plugins` (with or without a path) on a distro-packaged zellij built with --features disable_automatic_asset_installation.","commonSituations":"Linux distribution packages (Debian/Nix/etc.) that strip bundled WASM assets to avoid duplicating files; users following upstream docs that assume the official release binary.","solutions":["Install the plugins your distribution ships as a separate zellij-plugins package","Verify the plugin directory location with `zellij setup --check` and ensure the plugins are present there","If you need dump-plugins, use an official upstream binary or build without the disable_automatic_asset_installation feature"],"exampleFix":null,"handlingStrategy":"validation","validationCode":"// Shell-level check before attempting the dump:\n// zellij setup --check 2>&1 | grep -i 'plugin dir'\n# then verify the plugin files exist in the reported directory before launching","typeGuard":null,"tryCatchPattern":null,"preventionTips":["On distro builds, install the distributor's separate plugin package before first launch","Run `zellij setup --check` after installation and confirm the plugin directory is populated","If you rely on --dump-plugins, use an upstream binary built without disable_automatic_asset_installation"],"tags":["setup","build-features","plugins","packaging"],"backgroundTag":null,"analyzedSha":"98a0837077492d53dd252ab30bc3e43e41e504f4","analyzedAt":"2026-08-16T13:02:01.396Z","schemaVersion":2},"datasetVersion":"2026-08-16T13:17:31.715Z"}