--- title: Quick hack: Setting up a ChromiumOS dev environment description: A concise step-by-step guide for setting up a ChromiumOS development environment on actual Chromebook hardware. Covers installing depot_tools, syncing the... canonical: https://daily.dev/posts/quick-hack-setting-up-a-chromiumos-dev-environment-mys8upevf twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Quick hack: Setting up a ChromiumOS dev environment | daily.dev og:description: A concise step-by-step guide for setting up a ChromiumOS development environment on actual Chromebook hardware. Covers installing depot_tools, syncing the... og:url: https://daily.dev/posts/quick-hack-setting-up-a-chromiumos-dev-environment-mys8upevf og:image: https://api.daily.dev/og/posts/mYS8uPEVF.png og:image:alt: Quick hack: Setting up a ChromiumOS dev environment og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Quick hack: Setting up a ChromiumOS dev environment **[Collabora Blog](https://daily.dev/sources/collabora)** · 3 min read · 0 upvotes · 0 comments ## Summary A concise step-by-step guide for setting up a ChromiumOS development environment on actual Chromebook hardware. Covers installing depot_tools, syncing the ChromiumOS repo, building packages and images, flashing to a USB device, enabling dev-mode on the Chromebook, installing the build, and setting up remote GDB debugging via gdbserver on port 1234. Includes both x86 and ARMv7 cross-compilation instructions for GDB. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### How do I build and flash ChromiumOS to a Chromebook from source? Set up depot_tools, sync the ChromiumOS manifest repo with `repo sync`, then run `cros_sdk -- ./build_packages --board=` and `cros_sdk -- ./build_image --board=`. Flash the image to a USB drive with `cros_sdk -- cros flash --board= usb:/`, boot the Chromebook in dev-mode, and run `/usr/sbin/chromeos-install` from the Crosh shell to install it. _Developers working with ChromiumOS builds track environment setup tips and toolchain changes on daily.dev._ ### How do I set up remote GDB debugging for Chrome on a Chromebook? On the Chromebook, remount root read-write, open port 1234 in iptables, and run `sudo gdbserver :1234 chrome`. On the dev machine, emerge the cross-architecture GDB (i686 or ARMv7), then connect with `i686-pc-linux-gnu-gdb`, set the sysroot to `/build//`, and issue `target remote :1234` followed by `continue`. _Engineers debugging low-level Chromebook software find cross-compilation and GDB workflow discussions on daily.dev._ ## Similar posts on daily.dev - [Setting Up a macOS Development Environment](https://daily.dev/posts/setting-up-a-macos-development-environment-1js0iw3z4) · Medium · 0 upvotes · 0 comments - [Hardened Mobile Dev: A Termux \+ Docker Guide for GrapheneOS](https://daily.dev/posts/hardened-mobile-dev-a-termux-docker-guide-for-grapheneos-fp0tsuscz) · SitePoint · 0 upvotes · 0 comments - [My favorite device is a Chromebook, without ChromeOS — kokada](https://daily.dev/posts/my-favorite-device-is-a-chromebook-without-chromeos-kokada-x1gprcax7) · Lobsters · 0 upvotes · 0 comments - [I switched from Mac to a Lenovo Chromebook, and you can too](https://daily.dev/posts/i-switched-from-mac-to-a-lenovo-chromebook-and-you-can-too-nfr1nnjbu) · Hacker News · 0 upvotes · 0 comments - [I installed real Linux apps on my Android phone, and it got dangerously close to replacing my laptop](https://daily.dev/posts/i-installed-real-linux-apps-on-my-android-phone-and-it-got-dangerously-close-to-replacing-my-laptop-6a4trcv3s) · XDA Developers · 1 upvotes · 0 comments --- Tags: [#embedded](https://daily.dev/tags/embedded) [View this post on daily.dev](https://daily.dev/posts/quick-hack-setting-up-a-chromiumos-dev-environment-mys8upevf) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Quick hack: Setting up a ChromiumOS dev environment","url":"https://daily.dev/posts/quick-hack-setting-up-a-chromiumos-dev-environment-mys8upevf","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/quick-hack-setting-up-a-chromiumos-dev-environment-mys8upevf"},"datePublished":"2026-08-11T08:57:08.010Z","dateModified":"2026-08-11T09:20:00.559Z","description":"A concise step-by-step guide for setting up a ChromiumOS development environment on actual Chromebook hardware. Covers installing depot_tools, syncing the...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/e6255c74aab14260b55a14486aa34bf4?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/e6255c74aab14260b55a14486aa34bf4?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Collabora Blog","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Collabora Blog","logo":"https://media.daily.dev/image/upload/s--ZGZ0FjqS--/f_auto,q_auto/v1786438306/logos/collabora?_a=BAMAMicg0","url":"https://daily.dev/sources/collabora"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/quick-hack-setting-up-a-chromiumos-dev-environment-mys8upevf","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"embedded","timeRequired":"PT3M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Collabora Blog","item":"https://daily.dev/sources/collabora"},{"@type":"ListItem","position":3,"name":"Quick hack: Setting up a ChromiumOS dev environment"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/quick-hack-setting-up-a-chromiumos-dev-environment-mys8upevf#faq","mainEntity":[{"@type":"Question","name":"How do I build and flash ChromiumOS to a Chromebook from source?","acceptedAnswer":{"@type":"Answer","text":"Set up depot_tools, sync the ChromiumOS manifest repo with `repo sync`, then run `cros_sdk -- ./build_packages --board=` and `cros_sdk -- ./build_image --board=`. Flash the image to a USB drive with `cros_sdk -- cros flash --board= usb:/`, boot the Chromebook in dev-mode, and run `/usr/sbin/chromeos-install` from the Crosh shell to install it. Developers working with ChromiumOS builds track environment setup tips and toolchain changes on daily.dev."}},{"@type":"Question","name":"How do I set up remote GDB debugging for Chrome on a Chromebook?","acceptedAnswer":{"@type":"Answer","text":"On the Chromebook, remount root read-write, open port 1234 in iptables, and run `sudo gdbserver :1234 chrome`. On the dev machine, emerge the cross-architecture GDB (i686 or ARMv7), then connect with `i686-pc-linux-gnu-gdb`, set the sysroot to `/build//`, and issue `target remote :1234` followed by `continue`. Engineers debugging low-level Chromebook software find cross-compilation and GDB workflow discussions on daily.dev."}}]} ```