[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"problem-detail-error-rust-build-failed-gtk-gdk-system-library-is":3},{"stack":4,"error":5,"seoName":6,"seoStack":7,"seo":8,"breadcrumb":10,"titlePrefix":18,"titleAccent":19,"lead":20,"facts":28,"why":43,"log":62,"fix":93,"engine":122,"related":133,"pitch":143},"rust","rust-build-failed-gtk-gdk-system-library-is","Rust build failed","Rust",{"description":9},"The Rust dependency `gdk-sys v0.18.2` could not be built (it compiles or links a C library). The full output is in the deploy log.",[11,14,16],{"label":12,"href":13},"App Installations","\u002Fapps",{"label":7,"href":15},"\u002Fapps\u002Fstacks\u002Frust",{"label":17},"Rust build failed: GTK\u002FGDK system library is missing","Rust build failed: ","GTK\u002FGDK system library is missing",[21,23,26],{"text":22},"The Rust dependency ",{"text":24,"code":25},"gdk-sys v0.18.2",true,{"text":27}," could not be built (it compiles or links a C library). The full output is in the deploy log.",[29,34,37,39],{"label":30,"value":31,"tone":32,"tooltip":33},"Type","Error","err","An error that occurred in the deployed application. It is not necessarily a PanelAlpha Engine error, but we keep working on improvements so you run into fewer of them.",{"label":35,"value":36},"Seen","2 times",{"label":38,"value":7},"Where",{"label":40,"value":41,"tooltip":42},"Status","Observed","Our team will look into this soon, verify the cause and try to fix it in an upcoming release.",{"heading":44,"body":45},"Why it happens",[46,47,48,50,52,54,56,58,60],{"text":22},{"text":24,"code":25},{"text":49}," needs the native GTK\u002FGDK 3 library during compilation. The build environment could not find ",{"text":51,"code":25},"gdk-3.0.pc",{"text":53}," through ",{"text":55,"code":25},"pkg-config",{"text":57},", and ",{"text":59,"code":25},"PKG_CONFIG_PATH",{"text":61}," was not set. This is a missing system dependency, not a Cargo registry or source checkout failure.",{"heading":63,"block":64},"What the log looks like",{"header":65,"lines":66},"Deploy log",[67,71,75,77,81,85,89],{"segments":68},[69],{"text":70},"Compiling gdk-sys v0.18.2",{"segments":72},[73],{"text":74},"error: failed to run custom build command for `gdk-sys v0.18.2`",{"segments":76,"blank":25},[],{"segments":78},[79],{"text":80},"pkg-config exited with status code 1",{"segments":82},[83],{"text":84},"The system library `gdk-3.0` required by crate `gdk-sys` was not found.",{"segments":86},[87],{"text":88},"The file `gdk-3.0.pc` needs to be installed and the PKG_CONFIG_PATH environment variable must contain its parent directory.",{"segments":90},[91],{"text":92},"The PKG_CONFIG_PATH environment variable is not set.",{"heading":94,"steps":95,"block":119},"How to fix it",[96],[97,99,100,102,103,105,107,109,110,112,113,115,117],{"text":98},"Add the required GTK\u002FGDK development packages and ",{"text":55,"code":25},{"text":101}," to the Rust build image or install step. On Debian\u002FUbuntu, this commonly includes the package that provides ",{"text":51,"code":25},{"text":104}," (such as ",{"text":106,"code":25},"libgtk-3-dev",{"text":108},") plus ",{"text":55,"code":25},{"text":111},"; verify the package name for the selected base image. If the library is installed in a nonstandard location, set ",{"text":59,"code":25},{"text":114}," to its ",{"text":116,"code":25},".pc",{"text":118}," directory, then redeploy.",{"header":120,"lines":121},"Fix by hand",[],{"heading":123,"body":124,"block":130},"How PanelAlpha Engine solves it",[125,127,128],{"text":126},"For Rust builds, detect native-library failures from ",{"text":55,"code":25},{"text":129}," and surface the missing package and build-image context before the generic build failure. Where the build strategy supports it, provide a documented way to declare OS-level build dependencies.",{"header":131,"lines":132},"",[],{"heading":134,"items":135},"Apps affected",[136,140],{"title":137,"badge":138,"tone":32,"href":139},"Commet","1 occurrence","\u002Fapps\u002Fcommetchat\u002Fcommet",{"title":141,"badge":138,"tone":32,"href":142},"Hoard","\u002Fapps\u002Frleeon\u002Fhoard",{"heading":144,"body":145,"footNote":146,"docsLabel":147,"docsHref":148},"Try PanelAlpha Engine yourself.","The easiest way to turn your server into a safe, controlled environment for your AI agent. Deploy, manage and maintain any project from Claude Code, Cursor, Codex or any other MCP client. Open source under Apache 2.0, free to run.","Requires Ubuntu 24.04 or 26.04 · 2 GB RAM · 1 CPU","Read the documentation","https:\u002F\u002Fpanelalpha.com\u002Fdocs"]