[{"data":1,"prerenderedAt":1625},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Freference\u002Fmaven-reference":314,"\u002Fdocs\u002Freference\u002Fmaven-reference-surround":1620},[4,38,86,149,176,219,257,273],{"title":5,"path":6,"stem":7,"children":8,"icon":37},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started\u002F1.index",[9,12,17,22,27,32],{"title":10,"path":6,"stem":7,"icon":11},"Getting started","i-lucide-flag",{"title":13,"path":14,"stem":15,"icon":16},"Modules overview","\u002Fdocs\u002Fgetting-started\u002Fmodules-overview","1.docs\u002F1.getting-started\u002F2.modules-overview","i-lucide-boxes",{"title":18,"path":19,"stem":20,"icon":21},"Installation","\u002Fdocs\u002Fgetting-started\u002Finstallation","1.docs\u002F1.getting-started\u002F3.installation","i-lucide-download",{"title":23,"path":24,"stem":25,"icon":26},"License configuration","\u002Fdocs\u002Fgetting-started\u002Flicense-configuration","1.docs\u002F1.getting-started\u002F4.license-configuration","i-lucide-key-round",{"title":28,"path":29,"stem":30,"icon":31},"Your first app","\u002Fdocs\u002Fgetting-started\u002Ffirst-app","1.docs\u002F1.getting-started\u002F5.first-app","i-lucide-square-play",{"title":33,"path":34,"stem":35,"icon":36},"Project setup","\u002Fdocs\u002Fgetting-started\u002Fproject-setup","1.docs\u002F1.getting-started\u002F6.project-setup","i-lucide-package",false,{"title":39,"path":40,"stem":41,"children":42,"icon":45},"Core Concepts","\u002Fdocs\u002Fconcepts","1.docs\u002F2.concepts\u002F1.index",[43,46,51,56,61,66,71,76,81],{"title":44,"path":40,"stem":41,"icon":45},"Core concepts","i-lucide-book-open",{"title":47,"path":48,"stem":49,"icon":50},"Architecture","\u002Fdocs\u002Fconcepts\u002Farchitecture","1.docs\u002F2.concepts\u002F2.architecture","i-lucide-layers",{"title":52,"path":53,"stem":54,"icon":55},"Exactly-once semantics","\u002Fdocs\u002Fconcepts\u002Fexactly-once","1.docs\u002F2.concepts\u002F3.exactly-once","i-lucide-shield-check",{"title":57,"path":58,"stem":59,"icon":60},"Lanes and parallelism","\u002Fdocs\u002Fconcepts\u002Flanes-and-parallelism","1.docs\u002F2.concepts\u002F4.lanes-and-parallelism","i-lucide-split",{"title":62,"path":63,"stem":64,"icon":65},"State and thread-safety","\u002Fdocs\u002Fconcepts\u002Fstate-and-thread-safety","1.docs\u002F2.concepts\u002F5.state-and-thread-safety","i-lucide-lock",{"title":67,"path":68,"stem":69,"icon":70},"Event time and watermarks","\u002Fdocs\u002Fconcepts\u002Fevent-time-and-watermarks","1.docs\u002F2.concepts\u002F6.event-time-and-watermarks","i-lucide-clock",{"title":72,"path":73,"stem":74,"icon":75},"The configuration model","\u002Fdocs\u002Fconcepts\u002Fconfiguration-model","1.docs\u002F2.concepts\u002F7.configuration-model","i-lucide-sliders-horizontal",{"title":77,"path":78,"stem":79,"icon":80},"The error-handling model","\u002Fdocs\u002Fconcepts\u002Ferror-handling-model","1.docs\u002F2.concepts\u002F8.error-handling-model","i-lucide-triangle-alert",{"title":82,"path":83,"stem":84,"icon":85},"How StoatFlow differs from Kafka Streams","\u002Fdocs\u002Fconcepts\u002Fhow-stoatflow-differs-from-ks","1.docs\u002F2.concepts\u002F9.how-stoatflow-differs-from-ks","i-lucide-arrow-left-right",{"title":87,"path":88,"stem":89,"children":90,"icon":93},"Building Topologies","\u002Fdocs\u002Fbuilding","1.docs\u002F3.building\u002F1.index",[91,94,99,104,109,114,119,124,129,134,139,144],{"title":92,"path":88,"stem":89,"icon":93},"Building topologies","i-lucide-blocks",{"title":95,"path":96,"stem":97,"icon":98},"Error handling and DLQ","\u002Fdocs\u002Fbuilding\u002Ferror-handling-dlq","1.docs\u002F3.building\u002F10.error-handling-dlq","i-lucide-circle-x",{"title":100,"path":101,"stem":102,"icon":103},"State stores","\u002Fdocs\u002Fbuilding\u002Fstate-stores","1.docs\u002F3.building\u002F11.state-stores","i-lucide-database",{"title":105,"path":106,"stem":107,"icon":108},"Testing topologies","\u002Fdocs\u002Fbuilding\u002Ftesting","1.docs\u002F3.building\u002F12.testing","i-lucide-flask-conical",{"title":110,"path":111,"stem":112,"icon":113},"Sources and sinks","\u002Fdocs\u002Fbuilding\u002Fstreams-builder","1.docs\u002F3.building\u002F2.streams-builder","i-lucide-import",{"title":115,"path":116,"stem":117,"icon":118},"KStream and KTable operations","\u002Fdocs\u002Fbuilding\u002Fkstream-ktable","1.docs\u002F3.building\u002F3.kstream-ktable","i-lucide-waypoints",{"title":120,"path":121,"stem":122,"icon":123},"Aggregations","\u002Fdocs\u002Fbuilding\u002Faggregations","1.docs\u002F3.building\u002F4.aggregations","i-lucide-sigma",{"title":125,"path":126,"stem":127,"icon":128},"Windowing","\u002Fdocs\u002Fbuilding\u002Fwindowing","1.docs\u002F3.building\u002F5.windowing","i-lucide-calendar-clock",{"title":130,"path":131,"stem":132,"icon":133},"Joins","\u002Fdocs\u002Fbuilding\u002Fjoins","1.docs\u002F3.building\u002F6.joins","i-lucide-git-merge",{"title":135,"path":136,"stem":137,"icon":138},"The Processor API","\u002Fdocs\u002Fbuilding\u002Fprocessor-api","1.docs\u002F3.building\u002F7.processor-api","i-lucide-cpu",{"title":140,"path":141,"stem":142,"icon":143},"Scheduled sources","\u002Fdocs\u002Fbuilding\u002Fscheduled-sources","1.docs\u002F3.building\u002F8.scheduled-sources","i-lucide-timer",{"title":145,"path":146,"stem":147,"icon":148},"Serdes and Avro","\u002Fdocs\u002Fbuilding\u002Fserdes","1.docs\u002F3.building\u002F9.serdes","i-lucide-binary",{"title":150,"path":151,"stem":152,"children":153,"icon":75},"Configuration","\u002Fdocs\u002Fconfiguration","1.docs\u002F4.configuration\u002F1.index",[154,156,161,166,171],{"title":155,"path":151,"stem":152,"icon":75},"How configuration works",{"title":157,"path":158,"stem":159,"icon":160},"Engine configuration (:core)","\u002Fdocs\u002Fconfiguration\u002Fcore-config","1.docs\u002F4.configuration\u002F2.core-config","i-lucide-settings-2",{"title":162,"path":163,"stem":164,"icon":165},"Runtime configuration (:runtime)","\u002Fdocs\u002Fconfiguration\u002Fruntime-config","1.docs\u002F4.configuration\u002F3.runtime-config","i-lucide-server-cog",{"title":167,"path":168,"stem":169,"icon":170},"Defaults, adaptivity, and presets","\u002Fdocs\u002Fconfiguration\u002Fdefaults-and-presets","1.docs\u002F4.configuration\u002F4.defaults-and-presets","i-lucide-gauge",{"title":172,"path":173,"stem":174,"icon":175},"Kafka client configuration","\u002Fdocs\u002Fconfiguration\u002Fkafka-client-config","1.docs\u002F4.configuration\u002F5.kafka-client-config","i-lucide-plug",{"title":177,"path":178,"stem":179,"children":180,"icon":183},"Running in Production","\u002Fdocs\u002Fruntime","1.docs\u002F5.runtime\u002F1.index",[181,184,189,194,199,204,209,214],{"title":182,"path":178,"stem":179,"icon":183},"The runtime","i-lucide-server",{"title":185,"path":186,"stem":187,"icon":188},"The REST API","\u002Fdocs\u002Fruntime\u002Frest-api","1.docs\u002F5.runtime\u002F2.rest-api","i-lucide-globe",{"title":190,"path":191,"stem":192,"icon":193},"Health checks","\u002Fdocs\u002Fruntime\u002Fhealth-checks","1.docs\u002F5.runtime\u002F3.health-checks","i-lucide-heart-pulse",{"title":195,"path":196,"stem":197,"icon":198},"Metrics","\u002Fdocs\u002Fruntime\u002Fmetrics","1.docs\u002F5.runtime\u002F4.metrics","i-lucide-activity",{"title":200,"path":201,"stem":202,"icon":203},"Pause and resume","\u002Fdocs\u002Fruntime\u002Fpause-unpause","1.docs\u002F5.runtime\u002F5.pause-unpause","i-lucide-pause",{"title":205,"path":206,"stem":207,"icon":208},"Plugins and lifecycle hooks","\u002Fdocs\u002Fruntime\u002Fplugins","1.docs\u002F5.runtime\u002F6.plugins","i-lucide-puzzle",{"title":210,"path":211,"stem":212,"icon":213},"Docker images","\u002Fdocs\u002Fruntime\u002Fdocker","1.docs\u002F5.runtime\u002F7.docker","i-lucide-container",{"title":215,"path":216,"stem":217,"icon":218},"GraalVM native image","\u002Fdocs\u002Fruntime\u002Fnative-image","1.docs\u002F5.runtime\u002F8.native-image","i-lucide-zap",{"title":220,"path":221,"stem":222,"children":223,"icon":226},"Deploying & Operating","\u002Fdocs\u002Foperating","1.docs\u002F6.operating\u002F1.index",[224,227,232,237,242,247,252],{"title":225,"path":221,"stem":222,"icon":226},"Deploying and operating","i-lucide-life-buoy",{"title":228,"path":229,"stem":230,"icon":231},"Running on Kubernetes","\u002Fdocs\u002Foperating\u002Fkubernetes","1.docs\u002F6.operating\u002F2.kubernetes","i-lucide-ship",{"title":233,"path":234,"stem":235,"icon":236},"High availability","\u002Fdocs\u002Foperating\u002Fhigh-availability","1.docs\u002F6.operating\u002F3.high-availability","i-lucide-copy",{"title":238,"path":239,"stem":240,"icon":241},"Liveness and readiness probes","\u002Fdocs\u002Foperating\u002Fprobes","1.docs\u002F6.operating\u002F4.probes","i-lucide-stethoscope",{"title":243,"path":244,"stem":245,"icon":246},"Observability","\u002Fdocs\u002Foperating\u002Fobservability","1.docs\u002F6.operating\u002F5.observability","i-lucide-telescope",{"title":248,"path":249,"stem":250,"icon":251},"Tuning under load","\u002Fdocs\u002Foperating\u002Ftuning","1.docs\u002F6.operating\u002F6.tuning","i-lucide-sliders",{"title":253,"path":254,"stem":255,"icon":256},"Production checklist","\u002Fdocs\u002Foperating\u002Fproduction-checklist","1.docs\u002F6.operating\u002F7.production-checklist","i-lucide-clipboard-check",{"title":258,"path":259,"stem":260,"children":261,"icon":85},"Migrating from Kafka Streams","\u002Fdocs\u002Fmigration","1.docs\u002F7.migration\u002F1.index",[262,263,268],{"title":258,"path":259,"stem":260,"icon":85},{"title":264,"path":265,"stem":266,"icon":267},"Migration without carrying state","\u002Fdocs\u002Fmigration\u002Fwithout-data-migration","1.docs\u002F7.migration\u002F2.without-data-migration","i-lucide-sparkles",{"title":269,"path":270,"stem":271,"icon":272},"Migration carrying state","\u002Fdocs\u002Fmigration\u002Fwith-data-migration","1.docs\u002F7.migration\u002F3.with-data-migration","i-lucide-database-backup",{"title":274,"path":275,"stem":276,"children":277,"icon":279},"Reference","\u002Fdocs\u002Freference","1.docs\u002F8.reference\u002F1.index",[278,280,285,290,295,300,305,309],{"title":274,"path":275,"stem":276,"icon":279},"i-lucide-list",{"title":281,"path":282,"stem":283,"icon":284},"Configuration reference","\u002Fdocs\u002Freference\u002Fconfiguration-reference","1.docs\u002F8.reference\u002F2.configuration-reference","i-lucide-table",{"title":286,"path":287,"stem":288,"icon":289},"REST API reference","\u002Fdocs\u002Freference\u002Frest-api-reference","1.docs\u002F8.reference\u002F3.rest-api-reference","i-lucide-network",{"title":291,"path":292,"stem":293,"icon":294},"Gradle plugin reference","\u002Fdocs\u002Freference\u002Fgradle-plugin-reference","1.docs\u002F8.reference\u002F4.gradle-plugin-reference","i-lucide-box",{"title":296,"path":297,"stem":298,"icon":299},"Maven reference","\u002Fdocs\u002Freference\u002Fmaven-reference","1.docs\u002F8.reference\u002F5.maven-reference","i-simple-icons-apachemaven",{"title":301,"path":302,"stem":303,"icon":304},"Kafka Streams compatibility matrix","\u002Fdocs\u002Freference\u002Fks-compatibility-matrix","1.docs\u002F8.reference\u002F6.ks-compatibility-matrix","i-lucide-table-2",{"title":306,"path":307,"stem":308,"icon":170},"Metrics reference","\u002Fdocs\u002Freference\u002Fmetrics-reference","1.docs\u002F8.reference\u002F7.metrics-reference",{"title":310,"path":311,"stem":312,"icon":313},"Glossary","\u002Fdocs\u002Freference\u002Fglossary","1.docs\u002F8.reference\u002F8.glossary","i-lucide-book-a",{"id":315,"title":296,"body":316,"description":1613,"extension":1614,"meta":1615,"navigation":1616,"pageType":1617,"path":297,"seo":1618,"stem":298,"__hash__":1619},"docs\u002F1.docs\u002F8.reference\u002F5.maven-reference.md",{"type":317,"value":318,"toc":1602},"minimark",[319,336,341,430,434,437,589,636,688,692,849,853,860,1111,1161,1165,1262,1266,1349,1400,1404,1411,1488,1492,1498,1557,1570,1574,1598],[320,321,322,323,327,328,332,333,335],"p",{},"StoatFlow gives Maven projects the same build conventions as the ",[324,325,326],"a",{"href":292},"Gradle plugin",", through three published artifacts under ",[329,330,331],"code",{},"io.stoatflow",". This page enumerates them; for the setup walkthrough see ",[324,334,33],{"href":34},".",[337,338,340],"h2",{"id":339},"the-three-artifacts","The three artifacts",[342,343,344,357],"table",{},[345,346,347],"thead",{},[348,349,350,354],"tr",{},[351,352,353],"th",{},"Artifact",[351,355,356],{},"What it is",[358,359,360,378,410],"tbody",{},[348,361,362,371],{},[363,364,365],"td",{},[366,367,368],"strong",{},[329,369,370],{},"io.stoatflow:stoatflow-bom",[363,372,373,374,377],{},"A Maven BOM (",[329,375,376],{},"\u003CdependencyManagement>"," import) that aligns the StoatFlow modules with their tested kafka-clients \u002F rocksdbjni \u002F micrometer versions and imports the JUnit BOM.",[348,379,380,387],{},[363,381,382],{},[366,383,384],{},[329,385,386],{},"io.stoatflow:stoatflow-parent",[363,388,389,390,393,394,397,398,401,402,405,406,409],{},"The convention parent POM — JDK 25 + ",[329,391,392],{},"--enable-preview",", kotlin-maven jvmTarget 25, the shade fat JAR, the surefire\u002Ffailsafe ",[329,395,396],{},"IntegrationTest"," tag-split, ",[329,399,400],{},"exec:exec"," run, and the ",[329,403,404],{},"stoatflow-docker"," \u002F ",[329,407,408],{},"stoatflow-native"," profiles. Imports the BOM for you.",[348,411,412,419],{},[363,413,414],{},[366,415,416],{},[329,417,418],{},"io.stoatflow:stoatflow-maven-plugin",[363,420,421,422,425,426,429],{},"Four goals (prefix ",[329,423,424],{},"stoatflow",") for the things XML can't express: RocksDB auto-detection, the staged native ",[329,427,428],{},"docker build",", and the forked preview-flag run.",[337,431,433],{"id":432},"set-up","Set up",[320,435,436],{},"Inherit from the parent and declare your dependency (its version comes from the BOM the parent imports — so you omit it):",[438,439,444],"pre",{"className":440,"code":441,"language":442,"meta":443,"style":443},"language-xml shiki shiki-themes vitesse-light","\u003C!-- pom.xml -->\n\u003Cparent>\n  \u003CgroupId>io.stoatflow\u003C\u002FgroupId>\n  \u003CartifactId>stoatflow-parent\u003C\u002FartifactId>\n  \u003Cversion>REPLACE-WITH-CURRENT-RELEASE\u003C\u002Fversion>   \u003C!-- literal — Maven can't resolve a property in \u003Cparent> -->\n  \u003CrelativePath\u002F>\n\u003C\u002Fparent>\n\n\u003Cproperties>\n  \u003Cstoatflow.mainClass>com.example.Main\u003C\u002Fstoatflow.mainClass>\n\u003C\u002Fproperties>\n\n\u003Cdependencies>\n  \u003Cdependency>\n    \u003CgroupId>io.stoatflow\u003C\u002FgroupId>\n    \u003CartifactId>stoatflow-runtime\u003C\u002FartifactId>\n    \u003C!-- version managed by the imported stoatflow-bom -->\n  \u003C\u002Fdependency>\n  \u003Cdependency>\n    \u003CgroupId>io.stoatflow\u003C\u002FgroupId>\n    \u003CartifactId>stoatflow-test-utils\u003C\u002FartifactId>\n    \u003Cscope>test\u003C\u002Fscope>\n  \u003C\u002Fdependency>\n\u003C\u002Fdependencies>\n","xml","",[329,445,446,454,460,466,472,478,484,490,497,503,509,515,520,526,532,538,544,550,556,561,566,572,578,583],{"__ignoreMap":443},[447,448,451],"span",{"class":449,"line":450},"line",1,[447,452,453],{},"\u003C!-- pom.xml -->\n",[447,455,457],{"class":449,"line":456},2,[447,458,459],{},"\u003Cparent>\n",[447,461,463],{"class":449,"line":462},3,[447,464,465],{},"  \u003CgroupId>io.stoatflow\u003C\u002FgroupId>\n",[447,467,469],{"class":449,"line":468},4,[447,470,471],{},"  \u003CartifactId>stoatflow-parent\u003C\u002FartifactId>\n",[447,473,475],{"class":449,"line":474},5,[447,476,477],{},"  \u003Cversion>REPLACE-WITH-CURRENT-RELEASE\u003C\u002Fversion>   \u003C!-- literal — Maven can't resolve a property in \u003Cparent> -->\n",[447,479,481],{"class":449,"line":480},6,[447,482,483],{},"  \u003CrelativePath\u002F>\n",[447,485,487],{"class":449,"line":486},7,[447,488,489],{},"\u003C\u002Fparent>\n",[447,491,493],{"class":449,"line":492},8,[447,494,496],{"emptyLinePlaceholder":495},true,"\n",[447,498,500],{"class":449,"line":499},9,[447,501,502],{},"\u003Cproperties>\n",[447,504,506],{"class":449,"line":505},10,[447,507,508],{},"  \u003Cstoatflow.mainClass>com.example.Main\u003C\u002Fstoatflow.mainClass>\n",[447,510,512],{"class":449,"line":511},11,[447,513,514],{},"\u003C\u002Fproperties>\n",[447,516,518],{"class":449,"line":517},12,[447,519,496],{"emptyLinePlaceholder":495},[447,521,523],{"class":449,"line":522},13,[447,524,525],{},"\u003Cdependencies>\n",[447,527,529],{"class":449,"line":528},14,[447,530,531],{},"  \u003Cdependency>\n",[447,533,535],{"class":449,"line":534},15,[447,536,537],{},"    \u003CgroupId>io.stoatflow\u003C\u002FgroupId>\n",[447,539,541],{"class":449,"line":540},16,[447,542,543],{},"    \u003CartifactId>stoatflow-runtime\u003C\u002FartifactId>\n",[447,545,547],{"class":449,"line":546},17,[447,548,549],{},"    \u003C!-- version managed by the imported stoatflow-bom -->\n",[447,551,553],{"class":449,"line":552},18,[447,554,555],{},"  \u003C\u002Fdependency>\n",[447,557,559],{"class":449,"line":558},19,[447,560,531],{},[447,562,564],{"class":449,"line":563},20,[447,565,537],{},[447,567,569],{"class":449,"line":568},21,[447,570,571],{},"    \u003CartifactId>stoatflow-test-utils\u003C\u002FartifactId>\n",[447,573,575],{"class":449,"line":574},22,[447,576,577],{},"    \u003Cscope>test\u003C\u002Fscope>\n",[447,579,581],{"class":449,"line":580},23,[447,582,555],{},[447,584,586],{"class":449,"line":585},24,[447,587,588],{},"\u003C\u002Fdependencies>\n",[320,590,591,592,595,596,599,600,603,604,607,608,611,612,615,616,619,620,623,624,627,628,631,632,635],{},"The current release is ",[593,594],"stoatflow-version",{}," — substitute it for the ",[329,597,598],{},"REPLACE-WITH-CURRENT-RELEASE"," placeholder (the ",[329,601,602],{},"\u003Cparent>"," version must be a ",[366,605,606],{},"literal","; Maven does not interpolate properties in parent coordinates). For a Kotlin project, point Maven at ",[329,609,610],{},"src\u002Fmain\u002Fkotlin",", add the ",[329,613,614],{},"kotlin-stdlib"," (version ",[329,617,618],{},"${kotlin.version}",", from the parent), and use the ",[329,621,622],{},"…Kt"," main class — the parent already configures ",[329,625,626],{},"kotlin-maven-plugin"," (jvmTarget 25) and binds its ",[329,629,630],{},"compile","\u002F",[329,633,634],{},"test-compile"," phases.",[637,638,641,662,682],"callout",{"color":639,"icon":640},"info","i-lucide-terminal",[320,642,643,650,651,653,654,657,658,661],{},[366,644,645,646,649],{},"Short goal prefix (",[329,647,648],{},"mvn stoatflow:…",")."," To call the plugin's standalone goals by their short prefix, add ",[329,652,331],{}," to ",[329,655,656],{},"\u003CpluginGroups>"," in your ",[329,659,660],{},"~\u002F.m2\u002Fsettings.xml",":",[438,663,665],{"className":440,"code":664,"language":442,"meta":443,"style":443},"\u003CpluginGroups>\n  \u003CpluginGroup>io.stoatflow\u003C\u002FpluginGroup>\n\u003C\u002FpluginGroups>\n",[329,666,667,672,677],{"__ignoreMap":443},[447,668,669],{"class":449,"line":450},[447,670,671],{},"\u003CpluginGroups>\n",[447,673,674],{"class":449,"line":456},[447,675,676],{},"  \u003CpluginGroup>io.stoatflow\u003C\u002FpluginGroup>\n",[447,678,679],{"class":449,"line":462},[447,680,681],{},"\u003C\u002FpluginGroups>\n",[320,683,684,685,335],{},"Without it, use full coordinates — e.g. ",[329,686,687],{},"mvn io.stoatflow:stoatflow-maven-plugin:run",[337,689,691],{"id":690},"what-the-parent-configures","What the parent configures",[342,693,694,704],{},[345,695,696],{},[348,697,698,701],{},[351,699,700],{},"Convention",[351,702,703],{},"Detail",[358,705,706,722,734,755,775,800,827],{},[348,707,708,713],{},[363,709,710],{},[366,711,712],{},"Compiler",[363,714,715,718,719,721],{},[329,716,717],{},"--release 25"," + ",[329,720,392],{}," (javac).",[348,723,724,729],{},[363,725,726],{},[366,727,728],{},"Kotlin",[363,730,731,733],{},[329,732,626],{}," jvmTarget 25 (no preview flag — that's javac-only).",[348,735,736,741],{},[363,737,738],{},[366,739,740],{},"Fat JAR",[363,742,743,746,747,750,751,754],{},[329,744,745],{},"maven-shade-plugin"," produces a ",[329,748,749],{},"\u003CfinalName>-all.jar"," with the ",[329,752,753],{},"Main-Class"," manifest + merged service files.",[348,756,757,762],{},[363,758,759],{},[366,760,761],{},"Unit tests",[363,763,764,767,768,771,772,335],{},[329,765,766],{},"maven-surefire-plugin"," on JUnit Platform with the preview\u002Fnative-access JVM args; ",[366,769,770],{},"excludes"," ",[329,773,774],{},"@Tag(\"IntegrationTest\")",[348,776,777,782],{},[363,778,779],{},[366,780,781],{},"Integration tests",[363,783,784,787,788,771,791,793,794,405,797,335],{},[329,785,786],{},"maven-failsafe-plugin"," runs ",[366,789,790],{},"only",[329,792,774],{},", bound to ",[329,795,796],{},"integration-test",[329,798,799],{},"verify",[348,801,802,807],{},[363,803,804],{},[366,805,806],{},"Run",[363,808,809,812,813,815,816,819,820,822,823,826],{},[329,810,811],{},"exec-maven-plugin"," configured for ",[329,814,400],{}," — a ",[366,817,818],{},"forked"," JVM so ",[329,821,392],{}," applies (",[329,824,825],{},"exec:java"," runs in Maven's own JVM and can't).",[348,828,829,834],{},[363,830,831],{},[366,832,833],{},"Profiles",[363,835,836,838,839,842,843,845,846,848],{},[329,837,404],{}," (Jib image at ",[329,840,841],{},"package","), ",[329,844,408],{}," (native compile at ",[329,847,841],{},"), and host-arch selection.",[337,850,852],{"id":851},"properties-reference","Properties reference",[320,854,855,856,859],{},"Set these in your ",[329,857,858],{},"\u003Cproperties>",". Defaults come from the parent.",[342,861,862,875],{},[345,863,864],{},[348,865,866,869,872],{},[351,867,868],{},"Property",[351,870,871],{},"Default",[351,873,874],{},"Description",[358,876,877,897,918,933,948,963,981,1008,1027,1042,1068,1093],{},[348,878,879,884,890],{},[363,880,881],{},[329,882,883],{},"stoatflow.mainClass",[363,885,886],{},[887,888,889],"em",{},"(required)",[363,891,892,893,896],{},"Application entry point. ",[329,894,895],{},"stoatflow:configure"," fails the build if unset.",[348,898,899,904,909],{},[363,900,901],{},[329,902,903],{},"stoatflow.docker.imageName",[363,905,906],{},[329,907,908],{},"${project.artifactId}",[363,910,911,912,718,915,335],{},"Image name. Tagged ",[329,913,914],{},"latest",[329,916,917],{},"\u003Cversion>",[348,919,920,925,930],{},[363,921,922],{},[329,923,924],{},"stoatflow.docker.port",[363,926,927],{},[329,928,929],{},"8080",[363,931,932],{},"Exposed container port.",[348,934,935,940,945],{},[363,936,937],{},[329,938,939],{},"stoatflow.docker.user",[363,941,942],{},[329,943,944],{},"1000:1000",[363,946,947],{},"Non-root run-as user.",[348,949,950,955,960],{},[363,951,952],{},[329,953,954],{},"stoatflow.docker.baseImage",[363,956,957],{},[329,958,959],{},"eclipse-temurin:25-jre-noble",[363,961,962],{},"JVM base image.",[348,964,965,970,975],{},[363,966,967],{},[329,968,969],{},"stoatflow.docker.stateDir",[363,971,972],{},[329,973,974],{},"\u002Fdata\u002Fstate",[363,976,977,978,335],{},"RocksDB state dir → ",[329,979,980],{},"STOATFLOW_STATE_DIR",[348,982,983,988,993],{},[363,984,985],{},[329,986,987],{},"stoatflow.docker.rocksdbMb",[363,989,990],{},[887,991,992],{},"empty = auto-detect",[363,994,995,996,999,1000,1003,1004,1007],{},"Off-heap RocksDB MiB → ",[329,997,998],{},"STOATFLOW_ROCKSDB_MB",". Empty = ",[366,1001,1002],{},"256 if RocksDB on the classpath, else omitted","; set a value to force; ",[329,1005,1006],{},"0"," omits.",[348,1009,1010,1015,1020],{},[363,1011,1012],{},[329,1013,1014],{},"stoatflow.docker.reproducibleBuild",[363,1016,1017],{},[329,1018,1019],{},"true",[363,1021,1022,1023,1026],{},"Pin ",[329,1024,1025],{},"creationTime"," to the HEAD commit.",[348,1028,1029,1034,1039],{},[363,1030,1031],{},[329,1032,1033],{},"stoatflow.docker.jvmFlags",[363,1035,1036],{},[329,1037,1038],{},"-XX:+UseG1GC",[363,1040,1041],{},"Container GC flag (preview\u002Fnative-access always added).",[348,1043,1044,1049,1054],{},[363,1045,1046],{},[329,1047,1048],{},"stoatflow.nativeImage.gc",[363,1050,1051],{},[887,1052,1053],{},"empty",[363,1055,1056,1059,1060,1063,1064,1067],{},[329,1057,1058],{},"--gc"," value for the native ",[366,1061,1062],{},"docker"," build (e.g. ",[329,1065,1066],{},"G1","; needs Oracle GraalVM).",[348,1069,1070,1075,1080],{},[363,1071,1072],{},[329,1073,1074],{},"stoatflow.nativeImage.runtimeTarget",[363,1076,1077],{},[329,1078,1079],{},"runtime",[363,1081,1082,1083,1086,1087,1089,1090,649],{},"Docker target stage for ",[329,1084,1085],{},"native-docker-build"," (",[329,1088,1079],{}," or ",[329,1091,1092],{},"runtime-lean",[348,1094,1095,1100,1104],{},[363,1096,1097],{},[329,1098,1099],{},"stoatflow.nativeImage.removeInitializeAtRunTime",[363,1101,1102],{},[887,1103,1053],{},[363,1105,1106,1107,1110],{},"Comma-separated ",[329,1108,1109],{},"--initialize-at-run-time"," entries to drop from the curated base.",[637,1112,1114],{"color":639,"icon":1113},"i-lucide-info",[320,1115,1116,1128,1129,1131,1132,771,1135,1138,1139,1141,1142,1145,1146,1149,1150,771,1153,1156,1157,649],{},[366,1117,1118,1121,1122,1124,1125,1127],{},[329,1119,1120],{},"docker.rocksdbMb",", ",[329,1123,1025],{},", and the docker executable carry no ",[329,1126,858],{}," default."," Maven's model interpolator bakes ",[329,1130,858],{}," into the plugin ",[329,1133,1134],{},"\u003Cconfiguration>",[887,1136,1137],{},"before"," any Mojo runs, which would override the auto-detection — so these stay undefined and resolve live from ",[329,1140,895],{},". To ",[366,1143,1144],{},"add"," native flags (the counterpart of Gradle's ",[329,1147,1148],{},"additionalInitializeAtRunTime","), extend the ",[329,1151,1152],{},"native-maven-plugin",[329,1154,1155],{},"\u003CbuildArgs>"," in your POM, or ship reachability metadata with your value classes (see ",[324,1158,1160],{"href":1159},"\u002Fdocs\u002Fruntime\u002Fnative-image#custom-serde-metadata","Native image → Custom serde metadata",[337,1162,1164],{"id":1163},"goals","Goals",[342,1166,1167,1180],{},[345,1168,1169],{},[348,1170,1171,1174,1177],{},[351,1172,1173],{},"Goal",[351,1175,1176],{},"Bound to",[351,1178,1179],{},"Purpose",[358,1181,1182,1206,1225,1246],{},[348,1183,1184,1188,1194],{},[363,1185,1186],{},[329,1187,895],{},[363,1189,1190,1193],{},[329,1191,1192],{},"initialize"," (both profiles)",[363,1195,1196,1197,1199,1200,1202,1203,335],{},"Auto-detects RocksDB → ",[329,1198,998],{},", probes the docker executable (macOS), computes the reproducible ",[329,1201,1025],{},", stages the effective native argfile, and validates ",[329,1204,1205],{},"mainClass",[348,1207,1208,1213,1219],{},[363,1209,1210],{},[329,1211,1212],{},"stoatflow:copy-entrypoint",[363,1214,1215,1218],{},[329,1216,1217],{},"prepare-package"," (docker profile)",[363,1220,1221,1222,335],{},"Stages the container-aware heap entrypoint into ",[329,1223,1224],{},"target\u002Fjib-extra\u002Fapp\u002F",[348,1226,1227,1232,1237],{},[363,1228,1229],{},[329,1230,1231],{},"stoatflow:native-docker-build",[363,1233,1234],{},[887,1235,1236],{},"standalone",[363,1238,1239,1240,1243,1244,335],{},"Stages the native build context (prebuilt JAR + argfile + ",[329,1241,1242],{},"Dockerfile.native"," + entrypoint) and runs the host-arch ",[329,1245,428],{},[348,1247,1248,1253,1257],{},[363,1249,1250],{},[329,1251,1252],{},"stoatflow:run",[363,1254,1255],{},[887,1256,1236],{},[363,1258,1259,1260,335],{},"Forks a JVM with the preview flags + your runtime classpath + ",[329,1261,1205],{},[337,1263,1265],{"id":1264},"build-commands","Build commands",[342,1267,1268,1278],{},[345,1269,1270],{},[348,1271,1272,1275],{},[351,1273,1274],{},"Command",[351,1276,1277],{},"Result",[358,1279,1280,1293,1307,1320,1337],{},[348,1281,1282,1287],{},[363,1283,1284],{},[329,1285,1286],{},"mvn package",[363,1288,1289,1290,335],{},"Compiles + the fat JAR ",[329,1291,1292],{},"target\u002F\u003Cname>-\u003Cversion>-all.jar",[348,1294,1295,1300],{},[363,1296,1297],{},[329,1298,1299],{},"mvn -Pstoatflow-docker package",[363,1301,1302,1303,1306],{},"Fat JAR ",[366,1304,1305],{},"and"," a Jib image to your local Docker daemon — one command.",[348,1308,1309,1314],{},[363,1310,1311],{},[329,1312,1313],{},"mvn -Pstoatflow-native package",[363,1315,1316,1317,1319],{},"A GraalVM native binary via ",[329,1318,1152],{}," (host toolchain).",[348,1321,1322,1327],{},[363,1323,1324],{},[329,1325,1326],{},"mvn stoatflow:native-docker-build",[363,1328,1329,1330,1333,1334,1336],{},"A native ",[366,1331,1332],{},"image"," built inside Docker from the prebuilt fat JAR (run ",[329,1335,1286],{}," first).",[348,1338,1339,1344],{},[363,1340,1341],{},[329,1342,1343],{},"mvn stoatflow:run",[363,1345,1346,1347,335],{},"The app in a forked JVM with ",[329,1348,392],{},[637,1350,1352],{"color":1351,"icon":80},"warning",[320,1353,1354,1363,1364,1367,1368,1370,1371,1374,1375,1378,1379,1382,1383,1386,1387,1389,1390,1393,1394,1396,1397,1399],{},[366,1355,1356,1357,1360,1361,335],{},"Profiles are activated with ",[329,1358,1359],{},"-P",", not POM ",[329,1362,858],{}," Maven ",[329,1365,1366],{},"\u003Cactivation>"," reads system\u002Fuser properties, not your project's ",[329,1369,858],{}," — so a ",[329,1372,1373],{},"\u003Cstoatflow.docker.enabled>"," flag does ",[366,1376,1377],{},"not"," turn the build on. Activate with ",[329,1380,1381],{},"mvn -Pstoatflow-docker …"," (or ",[329,1384,1385],{},"-Dstoatflow.docker.enabled=true","). The ",[329,1388,404],{}," profile binds the Jib ",[329,1391,1392],{},"dockerBuild"," goal to ",[329,1395,841],{},", which is why ",[329,1398,1299],{}," is the whole image build.",[337,1401,1403],{"id":1402},"using-just-the-bom","Using just the BOM",[320,1405,1406,1407,661],{},"If you don't want the parent POM (you already have a corporate parent, say), import the BOM directly for version alignment and configure the toolchain + flags yourself — the DIY path is in ",[324,1408,1410],{"href":1409},"\u002Fdocs\u002Fgetting-started\u002Finstallation#option-b-configure-it-yourself","Installation → Option B",[438,1412,1414],{"className":440,"code":1413,"language":442,"meta":443,"style":443},"\u003Cproperties>\n  \u003Cstoatflow.version>REPLACE-WITH-CURRENT-RELEASE\u003C\u002Fstoatflow.version>\n\u003C\u002Fproperties>\n\n\u003CdependencyManagement>\n  \u003Cdependencies>\n    \u003Cdependency>\n      \u003CgroupId>io.stoatflow\u003C\u002FgroupId>\n      \u003CartifactId>stoatflow-bom\u003C\u002FartifactId>\n      \u003Cversion>${stoatflow.version}\u003C\u002Fversion>\n      \u003Ctype>pom\u003C\u002Ftype>\n      \u003Cscope>import\u003C\u002Fscope>\n    \u003C\u002Fdependency>\n  \u003C\u002Fdependencies>\n\u003C\u002FdependencyManagement>\n",[329,1415,1416,1420,1425,1429,1433,1438,1443,1448,1453,1458,1463,1468,1473,1478,1483],{"__ignoreMap":443},[447,1417,1418],{"class":449,"line":450},[447,1419,502],{},[447,1421,1422],{"class":449,"line":456},[447,1423,1424],{},"  \u003Cstoatflow.version>REPLACE-WITH-CURRENT-RELEASE\u003C\u002Fstoatflow.version>\n",[447,1426,1427],{"class":449,"line":462},[447,1428,514],{},[447,1430,1431],{"class":449,"line":468},[447,1432,496],{"emptyLinePlaceholder":495},[447,1434,1435],{"class":449,"line":474},[447,1436,1437],{},"\u003CdependencyManagement>\n",[447,1439,1440],{"class":449,"line":480},[447,1441,1442],{},"  \u003Cdependencies>\n",[447,1444,1445],{"class":449,"line":486},[447,1446,1447],{},"    \u003Cdependency>\n",[447,1449,1450],{"class":449,"line":492},[447,1451,1452],{},"      \u003CgroupId>io.stoatflow\u003C\u002FgroupId>\n",[447,1454,1455],{"class":449,"line":499},[447,1456,1457],{},"      \u003CartifactId>stoatflow-bom\u003C\u002FartifactId>\n",[447,1459,1460],{"class":449,"line":505},[447,1461,1462],{},"      \u003Cversion>${stoatflow.version}\u003C\u002Fversion>\n",[447,1464,1465],{"class":449,"line":511},[447,1466,1467],{},"      \u003Ctype>pom\u003C\u002Ftype>\n",[447,1469,1470],{"class":449,"line":517},[447,1471,1472],{},"      \u003Cscope>import\u003C\u002Fscope>\n",[447,1474,1475],{"class":449,"line":522},[447,1476,1477],{},"    \u003C\u002Fdependency>\n",[447,1479,1480],{"class":449,"line":528},[447,1481,1482],{},"  \u003C\u002Fdependencies>\n",[447,1484,1485],{"class":449,"line":534},[447,1486,1487],{},"\u003C\u002FdependencyManagement>\n",[337,1489,1491],{"id":1490},"version-compatibility","Version compatibility",[320,1493,1494,1495,1497],{},"The parent pins the build plugins it uses. As of ",[593,1496],{}," the pins are:",[342,1499,1500,1510],{},[345,1501,1502],{},[348,1503,1504,1507],{},[351,1505,1506],{},"Plugin",[351,1508,1509],{},"Version",[358,1511,1512,1520,1528,1535,1542,1549],{},[348,1513,1514,1517],{},[363,1515,1516],{},"Maven",[363,1518,1519],{},"3.8+ (3.9.x recommended)",[348,1521,1522,1525],{},[363,1523,1524],{},"jib-maven-plugin",[363,1526,1527],{},"3.5.1",[348,1529,1530,1532],{},[363,1531,1152],{},[363,1533,1534],{},"1.1.0",[348,1536,1537,1539],{},[363,1538,745],{},[363,1540,1541],{},"3.6.0",[348,1543,1544,1546],{},[363,1545,626],{},[363,1547,1548],{},"2.4.0",[348,1550,1551,1554],{},[363,1552,1553],{},"surefire \u002F failsafe",[363,1555,1556],{},"3.5.2",[637,1558,1559],{"color":639,"icon":1113},[320,1560,1561,1562,1565,1566,1569],{},"jib-",[366,1563,1564],{},"maven","-plugin (3.5.1) trails the jib-",[366,1567,1568],{},"gradle","-plugin (3.5.2) — that's their independent release cadence, not a defect; both produce equivalent images.",[337,1571,1573],{"id":1572},"related","Related",[1575,1576,1577,1583,1588],"ul",{},[1578,1579,1580,1582],"li",{},[324,1581,33],{"href":34}," — the setup walkthrough (Gradle and Maven).",[1578,1584,1585,1587],{},[324,1586,291],{"href":292}," — the same conventions for Gradle projects.",[1578,1589,1590,1593,1594,1597],{},[324,1591,1592],{"href":211},"Docker"," · ",[324,1595,1596],{"href":216},"Native image"," — the container and GraalVM build guides.",[1599,1600,1601],"style",{},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":443,"searchDepth":456,"depth":456,"links":1603},[1604,1605,1606,1607,1608,1609,1610,1611,1612],{"id":339,"depth":456,"text":340},{"id":432,"depth":456,"text":433},{"id":690,"depth":456,"text":691},{"id":851,"depth":456,"text":852},{"id":1163,"depth":456,"text":1164},{"id":1264,"depth":456,"text":1265},{"id":1402,"depth":456,"text":1403},{"id":1490,"depth":456,"text":1491},{"id":1572,"depth":456,"text":1573},"StoatFlow's Maven support — the stoatflow-bom, the stoatflow-parent convention POM, and the stoatflow-maven-plugin. The three artifacts, every \u003Cproperties> key, the four goals, and the pinned plugin versions.","md",{},{"icon":299},"reference",{"title":296,"description":1613},"rcjkwITRKw61GUws8uLTqgJRYiXzbgLG0J8qkyz3eQU",[1621,1623],{"title":291,"path":292,"stem":293,"description":1622,"icon":294,"children":-1},"The io.stoatflow convention plugin — the full stoatflow { } extension DSL, the plugins and JVM flags it applies, the tasks it contributes, and the Docker and native-image defaults.",{"title":301,"path":302,"stem":303,"description":1624,"icon":304,"children":-1},"Operator-by-operator parity between the StoatFlow DSL and the Kafka Streams DSL — implemented, partial, not yet implemented, deprecated, incompatible, and StoatFlow extensions.",1783713364715]