[{"data":1,"prerenderedAt":2757},["ShallowReactive",2],{"navigation_docs":3,"-docs-deployment-v1-single-node":364,"-docs-deployment-v1-single-node-surround":2752},[4,8,34,64,90,139,157,171,193,227,241,266,312,342],{"title":5,"path":6,"stem":7},"Documentation","\u002Fdocs","docs\u002Findex",{"title":9,"path":10,"stem":11,"children":12},"Getting started","\u002Fdocs\u002Fgetting-started","docs\u002F01.getting-started\u002Findex",[13,14,18,22,26,30],{"title":9,"path":10,"stem":11},{"title":15,"path":16,"stem":17},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002F01.getting-started\u002F01.introduction",{"title":19,"path":20,"stem":21},"Concepts","\u002Fdocs\u002Fgetting-started\u002Fconcepts","docs\u002F01.getting-started\u002F02.concepts",{"title":23,"path":24,"stem":25},"Quickstart (5 minutes)","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F01.getting-started\u002F03.quickstart",{"title":27,"path":28,"stem":29},"Local development","\u002Fdocs\u002Fgetting-started\u002Flocal-development","docs\u002F01.getting-started\u002F04.local-development",{"title":31,"path":32,"stem":33},"FAQ","\u002Fdocs\u002Fgetting-started\u002Ffaq","docs\u002F01.getting-started\u002F05.faq",{"title":35,"path":36,"stem":37,"children":38},"Architecture","\u002Fdocs\u002Farchitecture","docs\u002F02.architecture\u002Findex",[39,40,44,48,52,56,60],{"title":35,"path":36,"stem":37},{"title":41,"path":42,"stem":43},"Architecture overview","\u002Fdocs\u002Farchitecture\u002Foverview","docs\u002F02.architecture\u002F01.overview",{"title":45,"path":46,"stem":47},"Services","\u002Fdocs\u002Farchitecture\u002Fservices","docs\u002F02.architecture\u002F02.services",{"title":49,"path":50,"stem":51},"Request lifecycle","\u002Fdocs\u002Farchitecture\u002Frequest-lifecycle","docs\u002F02.architecture\u002F03.request-lifecycle",{"title":53,"path":54,"stem":55},"Data model","\u002Fdocs\u002Farchitecture\u002Fdata-model","docs\u002F02.architecture\u002F04.data-model",{"title":57,"path":58,"stem":59},"Status and evidence","\u002Fdocs\u002Farchitecture\u002Fstatus-and-evidence","docs\u002F02.architecture\u002F05.status-and-evidence",{"title":61,"path":62,"stem":63},"Target architecture and authority","\u002Fdocs\u002Farchitecture\u002Ftarget-architecture","docs\u002F02.architecture\u002F06.target-architecture",{"title":65,"path":66,"stem":67,"children":68},"Auth","\u002Fdocs\u002Fauth","docs\u002F03.auth\u002Findex",[69,70,74,78,82,86],{"title":65,"path":66,"stem":67},{"title":71,"path":72,"stem":73},"Overview","\u002Fdocs\u002Fauth\u002Foverview","docs\u002F03.auth\u002F01.overview",{"title":75,"path":76,"stem":77},"Organization and agent model","\u002Fdocs\u002Fauth\u002Forg-project-model","docs\u002F03.auth\u002F02.org-project-model",{"title":79,"path":80,"stem":81},"Issuing API keys","\u002Fdocs\u002Fauth\u002Fissuing-api-keys","docs\u002F03.auth\u002F03.issuing-api-keys",{"title":83,"path":84,"stem":85},"Multi-tenant RLS","\u002Fdocs\u002Fauth\u002Fmulti-tenant-rls","docs\u002F03.auth\u002F04.multi-tenant-rls",{"title":87,"path":88,"stem":89},"Operator sessions and step-up","\u002Fdocs\u002Fauth\u002Foperator-sessions","docs\u002F03.auth\u002F05.operator-sessions",{"title":91,"path":92,"stem":93,"children":94},"Proxy","\u002Fdocs\u002Fproxy","docs\u002F04.proxy\u002Findex",[95,96,99,103,107,111,115,119,123,127,131,135],{"title":91,"path":92,"stem":93},{"title":71,"path":97,"stem":98},"\u002Fdocs\u002Fproxy\u002Foverview","docs\u002F04.proxy\u002F01.overview",{"title":100,"path":101,"stem":102},"Authentication","\u002Fdocs\u002Fproxy\u002Fauthentication","docs\u002F04.proxy\u002F02.authentication",{"title":104,"path":105,"stem":106},"Request routing","\u002Fdocs\u002Fproxy\u002Frequest-routing","docs\u002F04.proxy\u002F03.request-routing",{"title":108,"path":109,"stem":110},"Sessions","\u002Fdocs\u002Fproxy\u002Fsessions","docs\u002F04.proxy\u002F04.sessions",{"title":112,"path":113,"stem":114},"Directives","\u002Fdocs\u002Fproxy\u002Fdirectives","docs\u002F04.proxy\u002F05.directives",{"title":116,"path":117,"stem":118},"Idempotency and budgets","\u002Fdocs\u002Fproxy\u002Fidempotency-and-budgets","docs\u002F04.proxy\u002F06.idempotency-and-budgets",{"title":120,"path":121,"stem":122},"Rate limiting","\u002Fdocs\u002Fproxy\u002Frate-limiting","docs\u002F04.proxy\u002F07.rate-limiting",{"title":124,"path":125,"stem":126},"Provider adapters","\u002Fdocs\u002Fproxy\u002Fprovider-adapters","docs\u002F04.proxy\u002F08.provider-adapters",{"title":128,"path":129,"stem":130},"Auth caching","\u002Fdocs\u002Fproxy\u002Fauth-caching","docs\u002F04.proxy\u002F09.auth-caching",{"title":132,"path":133,"stem":134},"Configuration","\u002Fdocs\u002Fproxy\u002Fconfiguration","docs\u002F04.proxy\u002F10.configuration",{"title":136,"path":137,"stem":138},"Provider routing and resilience","\u002Fdocs\u002Fproxy\u002Fprovider-routing-and-resilience","docs\u002F04.proxy\u002F11.provider-routing-and-resilience",{"title":140,"path":141,"stem":142,"children":143},"Memory","\u002Fdocs\u002Fmemory","docs\u002F05.memory\u002Findex",[144,145,149,153],{"title":140,"path":141,"stem":142},{"title":146,"path":147,"stem":148},"Memory overview","\u002Fdocs\u002Fmemory\u002Foverview","docs\u002F05.memory\u002F01.overview",{"title":150,"path":151,"stem":152},"Write path","\u002Fdocs\u002Fmemory\u002Fwrite-path","docs\u002F05.memory\u002F02.write-path",{"title":154,"path":155,"stem":156},"Search and lifecycle","\u002Fdocs\u002Fmemory\u002Fsearch-and-lifecycle","docs\u002F05.memory\u002F03.search-and-lifecycle",{"title":158,"path":159,"stem":160,"children":161},"Context","\u002Fdocs\u002Fcontext","docs\u002F06.context\u002Findex",[162,163,167],{"title":158,"path":159,"stem":160},{"title":164,"path":165,"stem":166},"Assembly pipeline","\u002Fdocs\u002Fcontext\u002Foverview","docs\u002F06.context\u002F01.overview",{"title":168,"path":169,"stem":170},"Ranking and packing","\u002Fdocs\u002Fcontext\u002Franking-and-packing","docs\u002F06.context\u002F02.ranking-and-packing",{"title":172,"path":173,"stem":174,"children":175},"Intelligence","\u002Fdocs\u002Fintelligence","docs\u002F07.intelligence\u002Findex",[176,177,181,185,189],{"title":172,"path":173,"stem":174},{"title":178,"path":179,"stem":180},"Workers","\u002Fdocs\u002Fintelligence\u002Fworkers","docs\u002F07.intelligence\u002F01.workers",{"title":182,"path":183,"stem":184},"Extraction","\u002Fdocs\u002Fintelligence\u002Fextraction","docs\u002F07.intelligence\u002F02.extraction",{"title":186,"path":187,"stem":188},"Embedder","\u002Fdocs\u002Fintelligence\u002Fembedder","docs\u002F07.intelligence\u002F03.embedder",{"title":190,"path":191,"stem":192},"Extraction evaluation","\u002Fdocs\u002Fintelligence\u002Fevaluation","docs\u002F07.intelligence\u002F04.evaluation",{"title":194,"path":195,"stem":196,"children":197},"API reference","\u002Fdocs\u002Fapi-reference","docs\u002F08.api-reference\u002Findex",[198,199,203,207,211,215,219,223],{"title":194,"path":195,"stem":196},{"title":200,"path":201,"stem":202},"Chat completions","\u002Fdocs\u002Fapi-reference\u002Fchat-completions","docs\u002F08.api-reference\u002F01.chat-completions",{"title":204,"path":205,"stem":206},"Responses","\u002Fdocs\u002Fapi-reference\u002Fresponses","docs\u002F08.api-reference\u002F02.responses",{"title":208,"path":209,"stem":210},"Errors","\u002Fdocs\u002Fapi-reference\u002Ferrors","docs\u002F08.api-reference\u002F03.errors",{"title":212,"path":213,"stem":214},"Health and metrics","\u002Fdocs\u002Fapi-reference\u002Fproxy-health","docs\u002F08.api-reference\u002F04.proxy-health",{"title":216,"path":217,"stem":218},"HTTP route inventory","\u002Fdocs\u002Fapi-reference\u002Fhttp-routes","docs\u002F08.api-reference\u002F05.http-routes",{"title":220,"path":221,"stem":222},"Management API","\u002Fdocs\u002Fapi-reference\u002Fmanagement-api","docs\u002F08.api-reference\u002F06.management-api",{"title":224,"path":225,"stem":226},"Auth gRPC (ValidateToken, ValidateAgent)","\u002Fdocs\u002Fapi-reference\u002Fauth-grpc","docs\u002F08.api-reference\u002F07.auth-grpc",{"title":228,"path":229,"stem":230,"children":231},"MCP","\u002Fdocs\u002Fmcp","docs\u002F09.mcp\u002Findex",[232,233,237],{"title":228,"path":229,"stem":230},{"title":234,"path":235,"stem":236},"Memory server","\u002Fdocs\u002Fmcp\u002Fmemory-server","docs\u002F09.mcp\u002F01.memory-server",{"title":238,"path":239,"stem":240},"Operator gateway","\u002Fdocs\u002Fmcp\u002Foperator-gateway","docs\u002F09.mcp\u002F02.operator-gateway",{"title":242,"path":243,"stem":244,"children":245},"Security","\u002Fdocs\u002Fsecurity","docs\u002F10.security\u002Findex",[246,247,251,254,258,262],{"title":242,"path":243,"stem":244},{"title":248,"path":249,"stem":250},"Security overview","\u002Fdocs\u002Fsecurity\u002Foverview","docs\u002F10.security\u002F01.overview",{"title":100,"path":252,"stem":253},"\u002Fdocs\u002Fsecurity\u002Fauthentication","docs\u002F10.security\u002F02.authentication",{"title":255,"path":256,"stem":257},"Tenant isolation","\u002Fdocs\u002Fsecurity\u002Ftenant-isolation","docs\u002F10.security\u002F03.tenant-isolation",{"title":259,"path":260,"stem":261},"Secrets and keys","\u002Fdocs\u002Fsecurity\u002Fsecrets-and-keys","docs\u002F10.security\u002F04.secrets-and-keys",{"title":263,"path":264,"stem":265},"Prompt injection","\u002Fdocs\u002Fsecurity\u002Fprompt-injection","docs\u002F10.security\u002F05.prompt-injection",{"title":267,"path":268,"stem":269,"children":270},"Operations","\u002Fdocs\u002Foperations","docs\u002F11.operations\u002Findex",[271,272,276,280,284,288,292,296,300,304,308],{"title":267,"path":268,"stem":269},{"title":273,"path":274,"stem":275},"Observability","\u002Fdocs\u002Foperations\u002Fobservability","docs\u002F11.operations\u002F01.observability",{"title":277,"path":278,"stem":279},"Traces and ClickHouse","\u002Fdocs\u002Foperations\u002Ftraces-and-clickhouse","docs\u002F11.operations\u002F02.traces-and-clickhouse",{"title":281,"path":282,"stem":283},"Health checks","\u002Fdocs\u002Foperations\u002Fhealth-checks","docs\u002F11.operations\u002F03.health-checks",{"title":285,"path":286,"stem":287},"Incident response","\u002Fdocs\u002Foperations\u002Fincident-response","docs\u002F11.operations\u002F04.incident-response",{"title":289,"path":290,"stem":291},"Troubleshooting","\u002Fdocs\u002Foperations\u002Ftroubleshooting","docs\u002F11.operations\u002F05.troubleshooting",{"title":293,"path":294,"stem":295},"Billing and budgets","\u002Fdocs\u002Foperations\u002Fbilling-and-budgets","docs\u002F11.operations\u002F06.billing-and-budgets",{"title":297,"path":298,"stem":299},"Evidence and relay","\u002Fdocs\u002Foperations\u002Fevidence-and-relay","docs\u002F11.operations\u002F07.evidence-and-relay",{"title":301,"path":302,"stem":303},"Console","\u002Fdocs\u002Foperations\u002Fconsole","docs\u002F11.operations\u002F08.console",{"title":305,"path":306,"stem":307},"Failure modes and recovery","\u002Fdocs\u002Foperations\u002Ffailure-and-recovery","docs\u002F11.operations\u002F09.failure-and-recovery",{"title":309,"path":310,"stem":311},"Data lifecycle and deletion","\u002Fdocs\u002Foperations\u002Fdata-lifecycle-and-deletion","docs\u002F11.operations\u002F10.data-lifecycle-and-deletion",{"title":313,"path":314,"stem":315,"children":316},"Deployment","\u002Fdocs\u002Fdeployment","docs\u002F12.deployment\u002Findex",[317,318,322,326,330,334,338],{"title":313,"path":314,"stem":315},{"title":319,"path":320,"stem":321},"Docker Compose (dev)","\u002Fdocs\u002Fdeployment\u002Fdocker-compose","docs\u002F12.deployment\u002F01.docker-compose",{"title":323,"path":324,"stem":325},"Environment variables","\u002Fdocs\u002Fdeployment\u002Fenvironment-variables","docs\u002F12.deployment\u002F02.environment-variables",{"title":327,"path":328,"stem":329},"Kubernetes","\u002Fdocs\u002Fdeployment\u002Fkubernetes","docs\u002F12.deployment\u002F03.kubernetes",{"title":331,"path":332,"stem":333},"Production readiness","\u002Fdocs\u002Fdeployment\u002Fproduction-readiness","docs\u002F12.deployment\u002F04.production-readiness",{"title":335,"path":336,"stem":337},"v1-single-node profile","\u002Fdocs\u002Fdeployment\u002Fv1-single-node","docs\u002F12.deployment\u002F05.v1-single-node",{"title":339,"path":340,"stem":341},"Upgrade and support window","\u002Fdocs\u002Fdeployment\u002Fupgrade","docs\u002F12.deployment\u002F06.upgrade",{"title":343,"path":344,"stem":345,"children":346},"Reference","\u002Fdocs\u002Freference","docs\u002F13.reference\u002Findex",[347,348,352,356,360],{"title":343,"path":344,"stem":345},{"title":349,"path":350,"stem":351},"Glossary","\u002Fdocs\u002Freference\u002Fglossary","docs\u002F13.reference\u002F01.glossary",{"title":353,"path":354,"stem":355},"Roadmap and gates","\u002Fdocs\u002Freference\u002Froadmap","docs\u002F13.reference\u002F02.roadmap",{"title":357,"path":358,"stem":359},"Architecture decisions","\u002Fdocs\u002Freference\u002Fadr","docs\u002F13.reference\u002F03.adr",{"title":361,"path":362,"stem":363},"Compatibility and versioning","\u002Fdocs\u002Freference\u002Fcompatibility","docs\u002F13.reference\u002F04.compatibility",{"id":365,"title":335,"audience":366,"author":367,"authorUrl":367,"body":368,"coverIndex":367,"coverLabel":367,"coverTone":367,"date":367,"decisionStatus":367,"description":2742,"excerpt":367,"extension":2743,"featured":2744,"historical":2744,"meta":2745,"navigation":2746,"path":336,"readingTime":367,"scope":2747,"seo":2748,"sourceOfTruth":2749,"status":375,"stem":337,"tags":367,"verifiedDate":2750,"__hash__":2751},"docs\u002Fdocs\u002F12.deployment\u002F05.v1-single-node.md","operator",null,{"type":369,"value":370,"toc":2728},"minimark",[371,377,392,404,409,457,482,492,507,518,527,531,844,901,905,929,943,946,1009,1013,1109,1130,1134,1149,1152,1174,1201,1205,1211,1244,1251,1255,1307,1313,1444,1451,1476,1495,1528,1538,1542,1711,1714,1721,1725,1736,2127,2130,2141,2270,2277,2290,2293,2337,2340,2356,2360,2612,2616,2703,2707,2724],[372,373],"page-status",{"note":374,"status":375,"verified":376},"Locally started and recorded on one host; not a hosted, HA, or multi-user claim","IMPLEMENTED","2026-11-07",[378,379,380,381,391],"p",{},"The recorded start is\n",[382,383,387],"a",{"href":384,"rel":385},"https:\u002F\u002Fgithub.com\u002FRick1330\u002Fibex-harness\u002Fblob\u002Fmain\u002Fengineering\u002Farchitecture-v2\u002F29-v1-single-node-start-record-2026-11-07.md",[386],"nofollow",[388,389,390],"code",{},"29-v1-single-node-start-record-2026-11-07.md",".",[378,393,394,397,398,403],{},[388,395,396],{},"v1-single-node"," is the only deployment profile a v1.0 claim may cite\n(",[382,399,402],{"href":400,"rel":401},"https:\u002F\u002Fgithub.com\u002FRick1330\u002Fibex-harness\u002Fblob\u002Fmain\u002Fengineering\u002Fadr\u002F0097-v1-supported-profile.md",[386],"ADR-0097","). It runs\nevery required service as a container in one Compose project on one host. Kubernetes, Helm, and any HA topology are\noutside the profile.",[405,406,408],"h2",{"id":407},"start-it","Start it",[410,411,416],"pre",{"className":412,"code":413,"language":414,"meta":415,"style":415},"language-bash shiki shiki-themes material-theme-lighter vitesse-light vitesse-dark","make v1-secrets   # generates .env (0600) and file secrets; never prints a value\nmake v1-up        # builds, migrates, provisions the capability logins, bootstraps, starts, waits for the edge\nmake v1-ps        # service status\n","bash","",[388,417,418,435,446],{"__ignoreMap":415},[419,420,423,427,431],"span",{"class":421,"line":422},"line",1,[419,424,426],{"class":425},"sYn-s","make",[419,428,430],{"class":429},"sTbE_"," v1-secrets",[419,432,434],{"class":433},"s9Tkl","   # generates .env (0600) and file secrets; never prints a value\n",[419,436,438,440,443],{"class":421,"line":437},2,[419,439,426],{"class":425},[419,441,442],{"class":429}," v1-up",[419,444,445],{"class":433},"        # builds, migrates, provisions the capability logins, bootstraps, starts, waits for the edge\n",[419,447,449,451,454],{"class":421,"line":448},3,[419,450,426],{"class":425},[419,452,453],{"class":429}," v1-ps",[419,455,456],{"class":433},"        # service status\n",[378,458,459,462,463,466,467,470,471,470,474,477,478,481],{},[388,460,461],{},"make v1-secrets"," writes the four capability-login passwords as well (",[388,464,465],{},"IBEX_RUNTIME_DB_PASSWORD",",\n",[388,468,469],{},"IBEX_AUTH_DB_PASSWORD",", ",[388,472,473],{},"IBEX_WORKER_DB_PASSWORD",[388,475,476],{},"IBEX_BOOTSTRAP_DB_PASSWORD","). Leave them alone: the one-shot\n",[388,479,480],{},"provision"," service is their only writer, and it refuses to start when one is missing rather than defaulting to a\nshared value.",[378,483,484,487,488,491],{},[388,485,486],{},"make v1-up"," prints the edge URL. The bootstrap writes the admin PAT once to\n",[388,489,490],{},"infra\u002Fcompose\u002Fv1-single-node\u002Fbootstrap\u002Fbootstrap.pat"," (mode 0600, directory 0700) through a host bind mount, so the\ncredential survives the one-shot container and never reaches the container logs or the process output:",[410,493,495],{"className":412,"code":494,"language":414,"meta":415,"style":415},"make v1-bootstrap-pat   # prints the PAT; store it, then delete the file\n",[388,496,497],{"__ignoreMap":415},[419,498,499,501,504],{"class":421,"line":422},[419,500,426],{"class":425},[419,502,503],{"class":429}," v1-bootstrap-pat",[419,505,506],{"class":433},"   # prints the PAT; store it, then delete the file\n",[378,508,509,510,513,514,517],{},"Only the Argon2id hash is stored in Postgres, so that file is the only copy. Move the value into your secret manager\nand remove the file. ",[388,511,512],{},"IBEX_BOOTSTRAP_PAT_FILE"," is required for a first install: the command refuses to start rather\nthan print the credential to stdout, where a job runner would retain it. On a rootful runtime the file is owned by\nroot; ",[388,515,516],{},"make v1-bootstrap-pat"," then reads it through the auth image, which runs as root inside its own namespace.",[378,519,520,522,523,526],{},[388,521,486],{}," waits for every required service and covers TEI's two-hour first-start window (the model download). It\nprints a progress line every two minutes; set ",[388,524,525],{},"IBEX_V1_HEALTH_ATTEMPTS"," to a smaller number to fail fast on a host\nthat should already be warm.",[405,528,530],{"id":529},"what-runs","What runs",[532,533,534,553],"table",{},[535,536,537],"thead",{},[538,539,540,544,547,550],"tr",{},[541,542,543],"th",{},"Service",[541,545,546],{},"Image",[541,548,549],{},"Internal port",[541,551,552],{},"Readiness",[554,555,556,578,598,620,638,656,674,698,717,738,756,776,796,815,830],"tbody",{},[538,557,558,562,568,573],{},[559,560,561],"td",{},"Edge",[559,563,564,567],{},[388,565,566],{},"caddy:2.11.9-alpine"," (pinned digest)",[559,569,570],{},[388,571,572],{},"8443",[559,574,575],{},[388,576,577],{},"\u002F_edge\u002Fhealth",[538,579,580,582,588,593],{},[559,581,91],{},[559,583,584,585],{},"built from ",[388,586,587],{},"services\u002Fproxy",[559,589,590],{},[388,591,592],{},"8080",[559,594,595],{},[388,596,597],{},"\u002Fready",[538,599,600,602,607,616],{},[559,601,65],{},[559,603,584,604],{},[388,605,606],{},"services\u002Fauth",[559,608,609,612,613],{},[388,610,611],{},"8081",", gRPC ",[388,614,615],{},"9091",[559,617,618],{},[388,619,597],{},[538,621,622,624,629,634],{},[559,623,220],{},[559,625,584,626],{},[388,627,628],{},"services\u002Fapi",[559,630,631],{},[388,632,633],{},"8010",[559,635,636],{},[388,637,597],{},[538,639,640,642,647,652],{},[559,641,140],{},[559,643,584,644],{},[388,645,646],{},"services\u002Fmemory",[559,648,649],{},[388,650,651],{},"8005",[559,653,654],{},[388,655,597],{},[538,657,658,660,665,670],{},[559,659,186],{},[559,661,584,662],{},[388,663,664],{},"services\u002Fembedder",[559,666,667],{},[388,668,669],{},"8004",[559,671,672],{},[388,673,597],{},[538,675,676,683,688,693],{},[559,677,678,679,682],{},"TEI (",[388,680,681],{},"BAAI\u002Fbge-m3",")",[559,684,685,567],{},[388,686,687],{},"ghcr.io\u002Fhuggingface\u002Ftext-embeddings-inference:cpu-1.9.4",[559,689,690],{},[388,691,692],{},"80",[559,694,695],{},[388,696,697],{},"\u002Fhealth",[538,699,700,703,708,713],{},[559,701,702],{},"Worker",[559,704,584,705],{},[388,706,707],{},"services\u002Fworker",[559,709,710],{},[388,711,712],{},"8007",[559,714,715],{},[388,716,597],{},[538,718,719,722,727,733],{},[559,720,721],{},"Context assembly",[559,723,584,724],{},[388,725,726],{},"services\u002Fcontext",[559,728,729,730],{},"loopback gRPC ",[388,731,732],{},"9092",[559,734,735],{},[388,736,737],{},"grpc.health.v1",[538,739,740,742,747,752],{},[559,741,301],{},[559,743,584,744],{},[388,745,746],{},"services\u002Fconsole",[559,748,749],{},[388,750,751],{},"3000",[559,753,754],{},[388,755,597],{},[538,757,758,761,766,771],{},[559,759,760],{},"Postgres + pgvector",[559,762,763,567],{},[388,764,765],{},"pgvector\u002Fpgvector:0.8.6-pg16",[559,767,768],{},[388,769,770],{},"5432",[559,772,773],{},[388,774,775],{},"pg_isready",[538,777,778,781,786,791],{},[559,779,780],{},"Redis",[559,782,783,567],{},[388,784,785],{},"redis:7.4.2",[559,787,788],{},[388,789,790],{},"6379",[559,792,793],{},[388,794,795],{},"redis-cli ping",[538,797,798,804,809,812],{},[559,799,800,801],{},"One-shot ",[388,802,803],{},"migrate",[559,805,584,806],{},[388,807,808],{},"infra\u002Fmigrations",[559,810,811],{},"—",[559,813,814],{},"exits 0",[538,816,817,821,826,828],{},[559,818,800,819],{},[388,820,480],{},[559,822,823,824],{},"same image as ",[388,825,803],{},[559,827,811],{},[559,829,814],{},[538,831,832,837,840,842],{},[559,833,800,834],{},[388,835,836],{},"bootstrap",[559,838,839],{},"same image as Auth",[559,841,811],{},[559,843,814],{},[378,845,846,847,849,850,852,853,855,856,470,859,862,863,866,867,869,870,470,872,470,875,470,878,470,881,862,884,866,887,889,890,892,893,896,897,900],{},"Every long-running service declares a healthcheck. The one-shots run in order: ",[388,848,803],{}," (schema), ",[388,851,480],{},"\n(capability-login credentials), ",[388,854,836],{}," (identity). ",[388,857,858],{},"embedder",[388,860,861],{},"edge"," and ",[388,864,865],{},"console"," gate on ",[388,868,803],{},";\n",[388,871,836],{},[388,873,874],{},"auth",[388,876,877],{},"proxy",[388,879,880],{},"api",[388,882,883],{},"memory",[388,885,886],{},"worker",[388,888,480],{},", which itself gates on ",[388,891,803],{},"; and\n",[388,894,895],{},"context"," gates on the proxy, memory, bootstrap and the edge. A failed migration or a failed provisioning run stops the\nprofile instead of producing a partial start. The exact digests, environment matrix, and dependency graph live in\n",[388,898,899],{},"infra\u002Fcompose\u002Fv1-single-node\u002Fcompose.yml","; they are the source of truth for this page.",[405,902,904],{"id":903},"network-surface","Network surface",[378,906,907,908,911,912,915,916,470,918,920,921,924,925,928],{},"Only the edge port is published: ",[388,909,910],{},"${IBEX_EDGE_PORT:-443}:8443",". Datastores, AuthService gRPC, context, memory, worker,\nand MCP ports are reachable only by service name on the internal bridge. The edge answers ",[388,913,914],{},"404"," for ",[388,917,697],{},[388,919,597],{},",\nand ",[388,922,923],{},"\u002Fmetrics","; the proxy's internal auth-probe route (",[388,926,927],{},"\u002Fv1\u002Finternal\u002F...",") is not routable through the edge.",[378,930,931,932,935,936,939,940,391],{},"Rootless Podman and Docker cannot bind port 443 without additional privileges. Set ",[388,933,934],{},"IBEX_EDGE_PORT=8443"," in\n",[388,937,938],{},"infra\u002Fcompose\u002Fv1-single-node\u002F.env"," and use ",[388,941,942],{},"https:\u002F\u002Flocalhost:8443",[378,944,945],{},"Path ownership is explicit per ADR-0097 §4:",[532,947,948,958],{},[535,949,950],{},[538,951,952,955],{},[541,953,954],{},"Path",[541,956,957],{},"Owner",[554,959,960,978,1002],{},[538,961,962,976],{},[559,963,964,470,967,470,970,470,973],{},[388,965,966],{},"\u002Fv1\u002Fchat\u002Fcompletions",[388,968,969],{},"\u002Fv1\u002Fresponses",[388,971,972],{},"\u002Fv1\u002Fsessions\u002F*\u002Fterminate",[388,974,975],{},"\u002Fv1\u002Forgs\u002F*\u002Fauth-probe",[559,977,91],{},[538,979,980,1000],{},[559,981,982,470,985,470,988,470,991,470,994,470,997],{},[388,983,984],{},"\u002Fv1\u002Foperator\u002F*",[388,986,987],{},"\u002Fv1\u002Forganizations\u002F*",[388,989,990],{},"\u002Fv1\u002Ftokens\u002F*",[388,992,993],{},"\u002Fv1\u002Fusers\u002F*",[388,995,996],{},"\u002Fv1\u002Fagents\u002F*",[388,998,999],{},"\u002Fv1\u002Ftenant\u002F*",[559,1001,220],{},[538,1003,1004,1007],{},[559,1005,1006],{},"Everything else",[559,1008,301],{},[405,1010,1012],{"id":1011},"transport","Transport",[1014,1015,1016,1024,1055,1065,1075,1089,1103],"ul",{},[1017,1018,1019,1023],"li",{},[1020,1021,1022],"strong",{},"Browser → edge:"," TLS with the per-install edge leaf, issued by the profile's own CA. Trust that CA on the client\nbefore opening the console.",[1017,1025,1026,1029,1030,1033,1034,1036,1037,1040,1041,1044,1045,1047,1048,1051,1052,1054],{},[1020,1027,1028],{},"Edge → proxy\u002FAPI\u002Fconsole:"," these four containers share one network namespace, so the credential-bearing hops are\nloopback plaintext and never cross the Compose bridge (ADR-0097 §4). The edge cannot be replaced while the\nco-located containers exist, so replacing it is a full restart: ",[388,1031,1032],{},"make v1-down && make v1-up",". ",[388,1035,486],{}," performs\nthat restart itself when the certificate fingerprint changes.\nRotate certificates in ",[388,1038,1039],{},"infra\u002Fcompose\u002Fv1-single-node\u002Fcerts\u002F",": ",[388,1042,1043],{},"secrets\u002F"," holds the container copies, and\n",[388,1046,461],{}," overwrites it from ",[388,1049,1050],{},"certs\u002F"," on every run, so a key replaced only under ",[388,1053,1043],{}," is silently\nreverted and the edge keeps serving the old leaf.",[1017,1056,1057,1060,1061,1064],{},[1020,1058,1059],{},"Console BFF → edge:"," TLS with the same CA through ",[388,1062,1063],{},"NODE_EXTRA_CA_CERTS","; the browser never sees the upstream\norigin.",[1017,1066,1067,1070,1071,1074],{},[1020,1068,1069],{},"Proxy\u002FAPI → AuthService:"," gRPC with TLS 1.2+ and the per-install CA (",[388,1072,1073],{},"IBEX_AUTH_GRPC_CA_FILE",").",[1017,1076,1077,1080,1081,1084,1085,1088],{},[1020,1078,1079],{},"Policy snapshots:"," AuthService signs them with the generated policy key; the proxy verifies them with\n",[388,1082,1083],{},"policy_public_keys.json"," (key id ",[388,1086,1087],{},"v1","). Staging and production refuse to mount protected routes without a verifier.",[1017,1090,1091,1094,1095,1098,1099,1102],{},[1020,1092,1093],{},"Proxy ↔ context:"," the context container shares the same network namespace and binds ",[388,1096,1097],{},"127.0.0.1:9092"," only. The\nprofile bounds assembly at ",[1020,1100,1101],{},"2 s"," on both sides (proxy client and context retrieval) because CPU TEI query embedding\ncannot fit the 45 ms development default; the chat path remains fail-open and bounded.",[1017,1104,1105,1108],{},[1020,1106,1107],{},"Internal HTTP calls:"," service tokens on the Compose bridge; no published port. The shared bearer tokens and the\nRedis password are a documented limitation of the host-local bridge, not a public interface.",[378,1110,1111,1112,1115,1116,470,1119,470,1122,1125,1126,1129],{},"Multi-line PEM keys cannot live in a Compose ",[388,1113,1114],{},".env",". The profile uses file-backed variables instead:\n",[388,1117,1118],{},"JWT_PRIVATE_KEY_FILE",[388,1120,1121],{},"IBEX_AUTH_POLICY_SIGNING_KEY_FILE",[388,1123,1124],{},"DASHBOARD_JWT_PUBLIC_KEYS_FILE",", and optionally\n",[388,1127,1128],{},"IBEX_PROXY_POLICY_PUBLIC_KEYS_FILE",". Inline values still win when both forms are set.",[405,1131,1133],{"id":1132},"posture","Posture",[378,1135,1136,1137,1140,1141,1144,1145,1148],{},"The tracked ",[388,1138,1139],{},"infra\u002Fcompose\u002Fv1-single-node\u002F.env.example"," starts in ",[388,1142,1143],{},"IBEX_ENV=staging"," with ",[388,1146,1147],{},"IBEX_LLM_MODE=mock",", so a clean host needs no\nexternal provider. The mock model is a deterministic fixture for exercising transport, authentication, and context\nassembly — it is not a language model.",[378,1150,1151],{},"The supported deployment posture is:",[410,1153,1157],{"className":1154,"code":1155,"language":1156,"meta":415,"style":415},"language-dotenv shiki shiki-themes material-theme-lighter vitesse-light vitesse-dark","IBEX_ENV=production\nIBEX_LLM_MODE=live\nOPENAI_API_KEY=\u003Coperator-supplied>\n","dotenv",[388,1158,1159,1164,1169],{"__ignoreMap":415},[419,1160,1161],{"class":421,"line":422},[419,1162,1163],{},"IBEX_ENV=production\n",[419,1165,1166],{"class":421,"line":437},[419,1167,1168],{},"IBEX_LLM_MODE=live\n",[419,1170,1171],{"class":421,"line":448},[419,1172,1173],{},"OPENAI_API_KEY=\u003Coperator-supplied>\n",[378,1175,1176,1177,1033,1179,1181,1182,1184,1185,1188,1189,1192,1193,1196,1197,1200],{},"Never run mock mode in production, and never commit the filled ",[388,1178,1114],{},[388,1180,461],{}," creates\n",[388,1183,938],{}," with mode ",[388,1186,1187],{},"0600","; the secret copies under ",[388,1190,1191],{},"infra\u002Fcompose\u002Fv1-single-node\u002Fsecrets\u002F","\nare ",[388,1194,1195],{},"0444"," inside a ",[388,1198,1199],{},"0700"," directory so the non-root containers can read them.",[405,1202,1204],{"id":1203},"identity-bootstrap","Identity bootstrap",[378,1206,1207,1208,1210],{},"The one-shot ",[388,1209,836],{}," service creates, in one transaction:",[1014,1212,1213,1224,1227,1230,1237],{},[1017,1214,1215,1216,1219,1220,1223],{},"the organization (",[388,1217,1218],{},"IBEX_BOOTSTRAP_ORG_NAME"," \u002F ",[388,1221,1222],{},"IBEX_BOOTSTRAP_ORG_SLUG","),",[1017,1225,1226],{},"the owner user and the default agent,",[1017,1228,1229],{},"an allow-all model policy for that organization,",[1017,1231,1232,1233,1236],{},"an admin PAT (",[388,1234,1235],{},"Admin | SecretUse | OperatorMetadataRead","), and",[1017,1238,1239,1240,1243],{},"a scoped memory service token (",[388,1241,1242],{},"MemoryRead | MemoryWrite",") used by context and worker.",[378,1245,1246,1247,1250],{},"It is idempotent by organization slug: a second run creates no organization and never rotates the PAT. It does\nreconcile the scoped memory token, so a changed ",[388,1248,1249],{},"IBEX_MEMORY_API_TOKEN"," takes effect on the next start; a revoked token\nis never reactivated. The committed development seed token is never used.",[405,1252,1254],{"id":1253},"capability-logins","Capability logins",[378,1256,1257,1258,1260,1261,1260,1263,1265,1266,470,1269,470,1272,862,1275,1278,1279,1282,1283,1285,1286,1289,1290,466,1293,470,1296,470,1299,1302,1303,1306],{},"The profile starts three one-shots in order: ",[388,1259,803],{},", then ",[388,1262,480],{},[388,1264,836],{},". The migrations create the\ncapability logins ",[388,1267,1268],{},"ibex_runtime",[388,1270,1271],{},"ibex_auth",[388,1273,1274],{},"ibex_worker",[388,1276,1277],{},"ibex_bootstrap"," inert — no password, ",[388,1280,1281],{},"CONNECTION LIMIT 0"," — and ",[388,1284,480],{}," runs ",[388,1287,1288],{},"migrate provision"," to give each one a SCRAM verifier and lift that limit, in a single\ntransaction. It refuses a secret that is missing, not printable ASCII without spaces, repeated, or equal to the owner\ncredential, and it checks the postcondition before committing: each login is a non-superuser ",[388,1291,1292],{},"NOBYPASSRLS",[388,1294,1295],{},"NOINHERIT",[388,1297,1298],{},"NO CREATEDB",[388,1300,1301],{},"NO CREATEROLE"," login with no connection limit and no expired validity, reaches only the\nroles it needs, and reaches no privileged identity. A stray ",[388,1304,1305],{},"GRANT"," fails the start instead of widening a login.",[378,1308,1309,1312],{},[1020,1310,1311],{},"Every application service connects on its capability login."," The profile's six application DSNs name the login\ndirectly, and each long-running service asserts it at startup — refusing to run on the owner login or a superuser:",[532,1314,1315,1330],{},[535,1316,1317],{},[538,1318,1319,1321,1324],{},[541,1320,543],{},[541,1322,1323],{},"Login",[541,1325,1326,1327],{},"DSN in ",[388,1328,1329],{},"compose.yml",[554,1331,1332,1347,1362,1377,1392,1407,1422],{},[538,1333,1334,1338,1342],{},[559,1335,1336],{},[388,1337,836],{},[559,1339,1340],{},[388,1341,1277],{},[559,1343,1344],{},[388,1345,1346],{},":268",[538,1348,1349,1353,1357],{},[559,1350,1351],{},[388,1352,874],{},[559,1354,1355],{},[388,1356,1271],{},[559,1358,1359],{},[388,1360,1361],{},":306",[538,1363,1364,1368,1372],{},[559,1365,1366],{},[388,1367,877],{},[559,1369,1370],{},[388,1371,1268],{},[559,1373,1374],{},[388,1375,1376],{},":349",[538,1378,1379,1383,1387],{},[559,1380,1381],{},[388,1382,880],{},[559,1384,1385],{},[388,1386,1268],{},[559,1388,1389],{},[388,1390,1391],{},":405",[538,1393,1394,1398,1402],{},[559,1395,1396],{},[388,1397,883],{},[559,1399,1400],{},[388,1401,1268],{},[559,1403,1404],{},[388,1405,1406],{},":452",[538,1408,1409,1413,1417],{},[559,1410,1411],{},[388,1412,886],{},[559,1414,1415],{},[388,1416,1274],{},[559,1418,1419],{},[388,1420,1421],{},":548",[538,1423,1424,1430,1436],{},[559,1425,1426,470,1428],{},[388,1427,803],{},[388,1429,480],{},[559,1431,1432,1433],{},"owner ",[388,1434,1435],{},"ibex",[559,1437,1438,470,1441],{},[388,1439,1440],{},":209",[388,1442,1443],{},":239",[378,1445,1446,862,1448,1450],{},[388,1447,803],{},[388,1449,480],{}," keep the owner credential because provision writes each capability role's password and the\nmigrations create cluster-global roles. Row-level security therefore applies to every application statement.",[378,1452,1453,1454,1456,1457,1459,1460,1463,1464,1467,1468,1471,1472,1475],{},"This was live-proven on 2026-11-15: all 13 health-checked containers healthy, no application connection is ",[388,1455,1435],{},", an\nunpinned cross-tenant read on ",[388,1458,1268],{}," raises SQLSTATE ",[388,1461,1462],{},"42501",", and a route-level cross-tenant request returns\n403. That is a live cross-tenant read plus the integration suites — not a full acceptance suite, and not a two-tenant\nbrowser journey. ",[388,1465,1466],{},"make repo-guards"," also runs ",[388,1469,1470],{},"infra\u002Fscripts\u002Fcheck-tenant-pin.py",", which fails any tracked Go or Python\nfile that writes ",[388,1473,1474],{},"app.current_org_id"," without pinning a tenant role first.",[378,1477,1478,1479,1481,1482,470,1484,470,1486,470,1488,470,1490,862,1492,1494],{},"If ",[388,1480,480],{}," exits non-zero, Compose refuses to start the services that depend on it. Postgres, Redis, the edge, the\nembedder, the migration one-shot and the console come up; ",[388,1483,874],{},[388,1485,877],{},[388,1487,880],{},[388,1489,883],{},[388,1491,886],{},[388,1493,895],{}," do\nnot, so the console has no upstream and no request is answered:",[410,1496,1498],{"className":412,"code":1497,"language":414,"meta":415,"style":415},"make v1-ps          # provision exited non-zero; the datastores are healthy and nothing else started\nmake v1-provision   # rebuilds and re-runs the one-shot; no teardown\nmake v1-up          # starts the services Compose withheld and waits for health\n",[388,1499,1500,1509,1519],{"__ignoreMap":415},[419,1501,1502,1504,1506],{"class":421,"line":422},[419,1503,426],{"class":425},[419,1505,453],{"class":429},[419,1507,1508],{"class":433},"          # provision exited non-zero; the datastores are healthy and nothing else started\n",[419,1510,1511,1513,1516],{"class":421,"line":437},[419,1512,426],{"class":425},[419,1514,1515],{"class":429}," v1-provision",[419,1517,1518],{"class":433},"   # rebuilds and re-runs the one-shot; no teardown\n",[419,1520,1521,1523,1525],{"class":421,"line":448},[419,1522,426],{"class":425},[419,1524,442],{"class":429},[419,1526,1527],{"class":433},"          # starts the services Compose withheld and waits for health\n",[378,1529,1530,1533,1534,1537],{},[388,1531,1532],{},"v1-provision"," repairs the credential write in place; it does not remove the running datastores. ",[388,1535,1536],{},"v1-up"," is\nidempotent, so it starts the dependent services after the one-shot succeeds without disturbing the containers that are\nalready healthy.",[405,1539,1541],{"id":1540},"verify","Verify",[410,1543,1545],{"className":412,"code":1544,"language":414,"meta":415,"style":415},"# Paste the URL printed by `make v1-up`. The host port comes from\n# IBEX_EDGE_PORT (443 by default), not from the container's internal 8443.\nEDGE_URL=https:\u002F\u002Flocalhost\nca=infra\u002Fcompose\u002Fv1-single-node\u002Fsecrets\u002Fca.crt\ncurl -fsS --cacert \"$ca\" \"$EDGE_URL\u002F_edge\u002Fhealth\"                                 # ok\ncurl -sS --cacert \"$ca\" -o \u002Fdev\u002Fnull -w '%{http_code}\\n' \"$EDGE_URL\u002Fhealth\"       # 404\ncurl -sS --cacert \"$ca\" -o \u002Fdev\u002Fnull -w '%{http_code}\\n' \"$EDGE_URL\u002Fv1\u002Finternal\u002Fauth-probe\" # 404\nmake v1-ps                                                                        # every required service healthy\n",[388,1546,1547,1552,1557,1570,1581,1617,1662,1701],{"__ignoreMap":415},[419,1548,1549],{"class":421,"line":422},[419,1550,1551],{"class":433},"# Paste the URL printed by `make v1-up`. The host port comes from\n",[419,1553,1554],{"class":421,"line":437},[419,1555,1556],{"class":433},"# IBEX_EDGE_PORT (443 by default), not from the container's internal 8443.\n",[419,1558,1559,1563,1567],{"class":421,"line":448},[419,1560,1562],{"class":1561},"sSC40","EDGE_URL",[419,1564,1566],{"class":1565},"soVBu","=",[419,1568,1569],{"class":429},"https:\u002F\u002Flocalhost\n",[419,1571,1573,1576,1578],{"class":421,"line":1572},4,[419,1574,1575],{"class":1561},"ca",[419,1577,1566],{"class":1565},[419,1579,1580],{"class":429},"infra\u002Fcompose\u002Fv1-single-node\u002Fsecrets\u002Fca.crt\n",[419,1582,1584,1587,1591,1594,1598,1602,1605,1607,1610,1612,1614],{"class":421,"line":1583},5,[419,1585,1586],{"class":425},"curl",[419,1588,1590],{"class":1589},"sz9Cv"," -fsS",[419,1592,1593],{"class":1589}," --cacert",[419,1595,1597],{"class":1596},"sbYkP"," \"",[419,1599,1601],{"class":1600},"su_V2","$ca",[419,1603,1604],{"class":1596},"\"",[419,1606,1597],{"class":1596},[419,1608,1609],{"class":1600},"$EDGE_URL",[419,1611,577],{"class":429},[419,1613,1604],{"class":1596},[419,1615,1616],{"class":433},"                                 # ok\n",[419,1618,1620,1622,1625,1627,1629,1631,1633,1636,1639,1642,1645,1648,1651,1653,1655,1657,1659],{"class":421,"line":1619},6,[419,1621,1586],{"class":425},[419,1623,1624],{"class":1589}," -sS",[419,1626,1593],{"class":1589},[419,1628,1597],{"class":1596},[419,1630,1601],{"class":1600},[419,1632,1604],{"class":1596},[419,1634,1635],{"class":1589}," -o",[419,1637,1638],{"class":429}," \u002Fdev\u002Fnull",[419,1640,1641],{"class":1589}," -w",[419,1643,1644],{"class":1596}," '",[419,1646,1647],{"class":429},"%{http_code}\\n",[419,1649,1650],{"class":1596},"'",[419,1652,1597],{"class":1596},[419,1654,1609],{"class":1600},[419,1656,697],{"class":429},[419,1658,1604],{"class":1596},[419,1660,1661],{"class":433},"       # 404\n",[419,1663,1665,1667,1669,1671,1673,1675,1677,1679,1681,1683,1685,1687,1689,1691,1693,1696,1698],{"class":421,"line":1664},7,[419,1666,1586],{"class":425},[419,1668,1624],{"class":1589},[419,1670,1593],{"class":1589},[419,1672,1597],{"class":1596},[419,1674,1601],{"class":1600},[419,1676,1604],{"class":1596},[419,1678,1635],{"class":1589},[419,1680,1638],{"class":429},[419,1682,1641],{"class":1589},[419,1684,1644],{"class":1596},[419,1686,1647],{"class":429},[419,1688,1650],{"class":1596},[419,1690,1597],{"class":1596},[419,1692,1609],{"class":1600},[419,1694,1695],{"class":429},"\u002Fv1\u002Finternal\u002Fauth-probe",[419,1697,1604],{"class":1596},[419,1699,1700],{"class":433}," # 404\n",[419,1702,1704,1706,1708],{"class":421,"line":1703},8,[419,1705,426],{"class":425},[419,1707,453],{"class":429},[419,1709,1710],{"class":433},"                                                                        # every required service healthy\n",[378,1712,1713],{},"Trust the profile CA on the client before opening the console; the commands above verify the edge certificate instead\nof disabling verification.",[378,1715,1716,1717,1720],{},"Then authenticate a chat request with the bootstrap PAT and confirm the round trip through the proxy, context\nassembly, and the provider. A live ",[388,1718,1719],{},"production"," start must serve at least one authenticated chat request before any\ndeployment claim is recorded.",[405,1722,1724],{"id":1723},"upgrade-and-rollback","Upgrade and rollback",[378,1726,1727,1728,1730,1731,1735],{},"Upgrade is a stop-the-stack operation. The IBEX images are built locally and their tags are overwritten on every\n",[388,1729,486],{},", so record the image ",[1732,1733,1734],"em",{},"IDs"," — not tags — before anything else.",[1737,1738,1739,1889,2071,2077,2084,2087,2111,2122],"ol",{},[1017,1740,1741,1744,1745],{},[1020,1742,1743],{},"Record the deployed images"," while the profile is running:",[410,1746,1748],{"className":412,"code":1747,"language":414,"meta":415,"style":415},"# Podman is the reference runtime; on a Docker host `docker image inspect\n# --format '{{.Id}}'` prints the same immutable ID.\nfor ref in ibex-v1-auth:local ibex-v1-single-node-proxy ibex-v1-single-node-api \\\n           ibex-v1-single-node-memory ibex-v1-single-node-embedder ibex-v1-single-node-worker \\\n           ibex-v1-single-node-context ibex-v1-single-node-console ibex-v1-single-node-migrate \\\n           ibex-v1-single-node-provision; do\n  printf '%s %s\\n' \"$ref\" \"$(podman image inspect --format '{{.Id}}' \"$ref\")\"\ndone | tee \u002Ftmp\u002Fibex-v1-images.txt\n",[388,1749,1750,1755,1760,1785,1798,1811,1822,1874],{"__ignoreMap":415},[419,1751,1752],{"class":421,"line":422},[419,1753,1754],{"class":433},"# Podman is the reference runtime; on a Docker host `docker image inspect\n",[419,1756,1757],{"class":421,"line":437},[419,1758,1759],{"class":433},"# --format '{{.Id}}'` prints the same immutable ID.\n",[419,1761,1762,1766,1769,1772,1775,1778,1781],{"class":421,"line":448},[419,1763,1765],{"class":1764},"siDh9","for",[419,1767,1768],{"class":1561}," ref",[419,1770,1771],{"class":1764}," in",[419,1773,1774],{"class":429}," ibex-v1-auth:local",[419,1776,1777],{"class":429}," ibex-v1-single-node-proxy",[419,1779,1780],{"class":429}," ibex-v1-single-node-api",[419,1782,1784],{"class":1783},"sftqT"," \\\n",[419,1786,1787,1790,1793,1796],{"class":421,"line":1572},[419,1788,1789],{"class":429},"           ibex-v1-single-node-memory",[419,1791,1792],{"class":429}," ibex-v1-single-node-embedder",[419,1794,1795],{"class":429}," ibex-v1-single-node-worker",[419,1797,1784],{"class":1783},[419,1799,1800,1803,1806,1809],{"class":421,"line":1583},[419,1801,1802],{"class":429},"           ibex-v1-single-node-context",[419,1804,1805],{"class":429}," ibex-v1-single-node-console",[419,1807,1808],{"class":429}," ibex-v1-single-node-migrate",[419,1810,1784],{"class":1783},[419,1812,1813,1816,1819],{"class":421,"line":1619},[419,1814,1815],{"class":429},"           ibex-v1-single-node-provision",[419,1817,1818],{"class":1565},";",[419,1820,1821],{"class":1764}," do\n",[419,1823,1824,1828,1830,1833,1835,1837,1840,1842,1844,1847,1850,1853,1856,1858,1861,1863,1865,1867,1869,1871],{"class":421,"line":1664},[419,1825,1827],{"class":1826},"sJdAF","  printf",[419,1829,1644],{"class":1596},[419,1831,1832],{"class":429},"%s %s\\n",[419,1834,1650],{"class":1596},[419,1836,1597],{"class":1596},[419,1838,1839],{"class":1600},"$ref",[419,1841,1604],{"class":1596},[419,1843,1597],{"class":1596},[419,1845,1846],{"class":1565},"$(",[419,1848,1849],{"class":425},"podman",[419,1851,1852],{"class":429}," image inspect ",[419,1854,1855],{"class":1589},"--format",[419,1857,1644],{"class":1596},[419,1859,1860],{"class":429},"{{.Id}}",[419,1862,1650],{"class":1596},[419,1864,1597],{"class":1596},[419,1866,1839],{"class":1600},[419,1868,1604],{"class":1596},[419,1870,682],{"class":1565},[419,1872,1873],{"class":1596},"\"\n",[419,1875,1876,1879,1883,1886],{"class":421,"line":1703},[419,1877,1878],{"class":1764},"done",[419,1880,1882],{"class":1881},"sVsLi"," |",[419,1884,1885],{"class":425}," tee",[419,1887,1888],{"class":429}," \u002Ftmp\u002Fibex-v1-images.txt\n",[1017,1890,1891,1894,1895,1898,1899,1902,1903,1906,1907,2043,2045,2046,2049,2050,2053,2054,2057,2058,2060,2061,2063,2064,2067,2068,2070],{},[1020,1892,1893],{},"Flush and drain extraction work."," A turn lives in the proxy's Redis buffer until its session ends, and an empty\nqueue does not mean a task is finished. With the profile still running:",[1896,1897],"br",{},"a. Ask clients to stop sending new chats, then terminate active sessions from the console (or wait for them to go\nidle) so each turn's extraction enqueue is sent while the queue and worker are alive. A failed enqueue is logged\nby the proxy as ",[388,1900,1901],{},"extraction enqueue failed; buffer retained","; check for that line before stopping the proxy.\nb. Stop the proxy so no new turn can be accepted:\n",[388,1904,1905],{},"infra\u002Fscripts\u002Fdev-tool.sh v1 stop proxy",".\nc. Wait until the queue is empty and nothing is running, reserved, or scheduled for retry:",[410,1908,1910],{"className":412,"code":1909,"language":414,"meta":415,"style":415},"REDIS_PASSWORD=\"$(sed -n 's\u002F^REDIS_PASSWORD=\u002F\u002Fp' infra\u002Fcompose\u002Fv1-single-node\u002F.env)\"\npodman exec -e REDISCLI_AUTH=\"$REDIS_PASSWORD\" ibex-v1-single-node-redis-1 redis-cli -n 1 LLEN extraction\npodman exec ibex-v1-single-node-worker-1 celery -A app.celery_app:celery_app inspect active\npodman exec ibex-v1-single-node-worker-1 celery -A app.celery_app:celery_app inspect reserved\npodman exec ibex-v1-single-node-worker-1 celery -A app.celery_app:celery_app inspect scheduled\n",[388,1911,1912,1943,1981,2005,2024],{"__ignoreMap":415},[419,1913,1914,1917,1919,1921,1923,1926,1929,1931,1934,1936,1939,1941],{"class":421,"line":422},[419,1915,1916],{"class":1561},"REDIS_PASSWORD",[419,1918,1566],{"class":1565},[419,1920,1604],{"class":1596},[419,1922,1846],{"class":1565},[419,1924,1925],{"class":425},"sed",[419,1927,1928],{"class":1589}," -n",[419,1930,1644],{"class":1596},[419,1932,1933],{"class":429},"s\u002F^REDIS_PASSWORD=\u002F\u002Fp",[419,1935,1650],{"class":1596},[419,1937,1938],{"class":429}," infra\u002Fcompose\u002Fv1-single-node\u002F.env",[419,1940,682],{"class":1565},[419,1942,1873],{"class":1596},[419,1944,1945,1947,1950,1953,1956,1958,1961,1963,1966,1969,1971,1975,1978],{"class":421,"line":437},[419,1946,1849],{"class":425},[419,1948,1949],{"class":429}," exec",[419,1951,1952],{"class":1589}," -e",[419,1954,1955],{"class":429}," REDISCLI_AUTH=",[419,1957,1604],{"class":1596},[419,1959,1960],{"class":1600},"$REDIS_PASSWORD",[419,1962,1604],{"class":1596},[419,1964,1965],{"class":429}," ibex-v1-single-node-redis-1",[419,1967,1968],{"class":429}," redis-cli",[419,1970,1928],{"class":1589},[419,1972,1974],{"class":1973},"s7CZa"," 1",[419,1976,1977],{"class":429}," LLEN",[419,1979,1980],{"class":429}," extraction\n",[419,1982,1983,1985,1987,1990,1993,1996,1999,2002],{"class":421,"line":448},[419,1984,1849],{"class":425},[419,1986,1949],{"class":429},[419,1988,1989],{"class":429}," ibex-v1-single-node-worker-1",[419,1991,1992],{"class":429}," celery",[419,1994,1995],{"class":1589}," -A",[419,1997,1998],{"class":429}," app.celery_app:celery_app",[419,2000,2001],{"class":429}," inspect",[419,2003,2004],{"class":429}," active\n",[419,2006,2007,2009,2011,2013,2015,2017,2019,2021],{"class":421,"line":1572},[419,2008,1849],{"class":425},[419,2010,1949],{"class":429},[419,2012,1989],{"class":429},[419,2014,1992],{"class":429},[419,2016,1995],{"class":1589},[419,2018,1998],{"class":429},[419,2020,2001],{"class":429},[419,2022,2023],{"class":429}," reserved\n",[419,2025,2026,2028,2030,2032,2034,2036,2038,2040],{"class":421,"line":1583},[419,2027,1849],{"class":425},[419,2029,1949],{"class":429},[419,2031,1989],{"class":429},[419,2033,1992],{"class":429},[419,2035,1995],{"class":1589},[419,2037,1998],{"class":429},[419,2039,2001],{"class":429},[419,2041,2042],{"class":429}," scheduled\n",[1896,2044],{},"Repeat until ",[388,2047,2048],{},"LLEN"," returns ",[388,2051,2052],{},"0"," and the three ",[388,2055,2056],{},"inspect"," calls list no tasks. A queued or buffered task's turn text\nis not reconstructable from Postgres, and the snapshot cannot recover it.",[1896,2059],{},"Every enqueue uses priority 0, so one ",[388,2062,2048],{}," covers the queue. The worker runs with ",[388,2065,2066],{},"task_ignore_result=True",", so\nCelery stores no task outcome: the queue length and the three ",[388,2069,2056],{}," outputs are the completion signal, and the\nworker log is the only place a failed task becomes visible. This profile has no dead-letter queue.",[1017,2072,2073,2076],{},[388,2074,2075],{},"make v1-down"," (volumes preserved).",[1017,2078,2079,2080,2083],{},"Check out the target release (",[388,2081,2082],{},"git checkout \u003Ctag>","). The application and migration images are built from this\ncheckout, so building from an older checkout starts old code under the new tags. Pinned dependency images\n(Postgres, Redis, TEI, Caddy) come from the Compose file; the IBEX images are built locally.",[1017,2085,2086],{},"Take a database snapshot.",[1017,2088,2089,2090,2092,2093,2095,2096,470,2098,470,2100,466,2102,2104,2105,2107,2108,391],{},"Run ",[388,2091,461],{}," before provisioning. An upgrade from the previous release has a ",[388,2094,1114],{}," without the four\ncapability-login passwords (",[388,2097,465],{},[388,2099,469],{},[388,2101,473],{},[388,2103,476],{},"). The script appends the missing keys, keeps every existing value, and never prints a\nvalue; skipping it makes ",[388,2106,480],{}," stop with ",[388,2109,2110],{},"IBEX_RUNTIME_DB_PASSWORD is required; run make v1-secrets",[1017,2112,2113,1260,2116,2119,2120,1074],{},[388,2114,2115],{},"make v1-migrate",[388,2117,2118],{},"make v1-provision"," (each rebuilds its image from this checkout and rewrites the capability\nverifiers from the current ",[388,2121,1114],{},[1017,2123,2124,2126],{},[388,2125,486],{}," (rebuilds the application images, then waits for every service).",[378,2128,2129],{},"Before recording a deployment claim, rehearse both directions from a real snapshot of the previous release (the ADR\nnames v0.1.9): run the upgrade, then run the rollback, and record both — the commands, the image IDs, and the row\ncounts after the restore. A rollback that has never been executed is not evidence.",[378,2131,2132,2133,2136,2137,2140],{},"Rollback is a stop-the-stack operation and must ",[1020,2134,2135],{},"not"," rebuild: a rebuild would replace the images you are trying to\nrecover. Restore the snapshot, reset the transient Redis state (the extraction queue on DB 1, the result backend on\nDB 3, and the caches on DB 0\u002F2 — recreate the ",[388,2138,2139],{},"redis-data"," volume or flush those databases), retag each recorded image\nID onto its Compose name, then start without building:",[410,2142,2144],{"className":412,"code":2143,"language":414,"meta":415,"style":415},"set -e\nwhile read -r ref id; do\n  podman image inspect \"$id\" >\u002Fdev\u002Fnull            # fail if the recorded image is gone\n  podman tag \"$id\" \"$ref\"                          # fail if the tag cannot be set\ndone \u003C \u002Ftmp\u002Fibex-v1-images.txt\n# On a Docker host, both steps are Docker's: `docker image inspect \"$id\" >\u002Fdev\u002Fnull`\n# fails the same way when the recorded image is gone, and `docker tag \"$id\" \"$ref\"`\n# sets the same tag.\ninfra\u002Fscripts\u002Fdev-tool.sh v1 up --no-build         # IBEX_V1_SKIP_BUILD=1 has the same effect,\n                                                   # and Compose receives `up --no-build`\n",[388,2145,2146,2154,2174,2200,2222,2231,2236,2241,2246,2264],{"__ignoreMap":415},[419,2147,2148,2151],{"class":421,"line":422},[419,2149,2150],{"class":1826},"set",[419,2152,2153],{"class":1589}," -e\n",[419,2155,2156,2159,2162,2165,2167,2170,2172],{"class":421,"line":437},[419,2157,2158],{"class":1764},"while",[419,2160,2161],{"class":1826}," read",[419,2163,2164],{"class":1589}," -r",[419,2166,1768],{"class":429},[419,2168,2169],{"class":429}," id",[419,2171,1818],{"class":1565},[419,2173,1821],{"class":1764},[419,2175,2176,2179,2182,2184,2186,2189,2191,2194,2197],{"class":421,"line":448},[419,2177,2178],{"class":425},"  podman",[419,2180,2181],{"class":429}," image",[419,2183,2001],{"class":429},[419,2185,1597],{"class":1596},[419,2187,2188],{"class":1600},"$id",[419,2190,1604],{"class":1596},[419,2192,2193],{"class":1881}," >",[419,2195,2196],{"class":429},"\u002Fdev\u002Fnull",[419,2198,2199],{"class":433},"            # fail if the recorded image is gone\n",[419,2201,2202,2204,2207,2209,2211,2213,2215,2217,2219],{"class":421,"line":1572},[419,2203,2178],{"class":425},[419,2205,2206],{"class":429}," tag",[419,2208,1597],{"class":1596},[419,2210,2188],{"class":1600},[419,2212,1604],{"class":1596},[419,2214,1597],{"class":1596},[419,2216,1839],{"class":1600},[419,2218,1604],{"class":1596},[419,2220,2221],{"class":433},"                          # fail if the tag cannot be set\n",[419,2223,2224,2226,2229],{"class":421,"line":1583},[419,2225,1878],{"class":1764},[419,2227,2228],{"class":1881}," \u003C",[419,2230,1888],{"class":1783},[419,2232,2233],{"class":421,"line":1619},[419,2234,2235],{"class":433},"# On a Docker host, both steps are Docker's: `docker image inspect \"$id\" >\u002Fdev\u002Fnull`\n",[419,2237,2238],{"class":421,"line":1664},[419,2239,2240],{"class":433},"# fails the same way when the recorded image is gone, and `docker tag \"$id\" \"$ref\"`\n",[419,2242,2243],{"class":421,"line":1703},[419,2244,2245],{"class":433},"# sets the same tag.\n",[419,2247,2249,2252,2255,2258,2261],{"class":421,"line":2248},9,[419,2250,2251],{"class":425},"infra\u002Fscripts\u002Fdev-tool.sh",[419,2253,2254],{"class":429}," v1",[419,2256,2257],{"class":429}," up",[419,2259,2260],{"class":1589}," --no-build",[419,2262,2263],{"class":433},"         # IBEX_V1_SKIP_BUILD=1 has the same effect,\n",[419,2265,2267],{"class":421,"line":2266},10,[419,2268,2269],{"class":433},"                                                   # and Compose receives `up --no-build`\n",[378,2271,2272,2273,2276],{},"The loop stops on the first failure: continuing after a failed tag would leave the upgraded tag in place and ",[388,2274,2275],{},"up","\ncould start the newer image against the restored snapshot.",[378,2278,2279,2280,2283,2284,2286,2287,2289],{},"Migrations are forward-only; starting an older image against a migrated schema is not a supported rollback. The\ndatabase restore restores the token and identity state; Redis holds only transient queues, caches, and rate-limit\ncounters. It also reverts the capability-login verifiers, which live in the database (",[388,2281,2282],{},"pg_authid","): the recreated\none-shots rewrite them from the current ",[388,2285,1114],{},", so a credential rotated after the snapshot must still be in ",[388,2288,1114],{},"\nwhen the stack starts.",[378,2291,2292],{},"Because the restore moves the database back in time, record and reapply anything that happened after the snapshot:",[1014,2294,2295,2305,2308,2327,2334],{},[1017,2296,2297,2298,470,2301,2304],{},"token and PAT revocations (",[388,2299,2300],{},"revoked_at",[388,2302,2303],{},"is_revoked",") and user suspensions, otherwise a revoked credential works\nagain after the restore;",[1017,2306,2307],{},"extraction work accepted after the snapshot, which the Redis reset discards and which must be re-submitted;",[1017,2309,2310,2311,2314,2315,2318,2319,2322,2323,2326],{},"accepted organization-deletion requests and their outcomes (",[388,2312,2313],{},"org_deletion_jobs","), reconciled against the restored\ndatabase: a request recorded ",[388,2316,2317],{},"succeeded"," is replayed, a ",[388,2320,2321],{},"hold_blocked"," request stays blocked (clearing its hold does\nnot resume it), and a request that never left ",[388,2324,2325],{},"pending"," is submitted again;",[1017,2328,2329,2330,2333],{},"legal-hold creations and clearances, ",[1020,2331,2332],{},"re-applied before any forget or deletion replay runs",". A restore from a\nsnapshot that predates a hold would otherwise drop it silently and allow the destruction the hold exists to prevent;",[1017,2335,2336],{},"completed forgets and organization deletions, replayed from the record kept outside the database. Re-apply the\nmarkers, erase the restored rows (see the next section), re-scrub the idempotency-ledger responses, and verify the\nreceipts before reopening traffic. If the replay is incomplete, the rollback is incomplete.",[378,2338,2339],{},"Keep the window between snapshot and rollback short, and keep the revocation, deletion and hold records outside the\ndatabase.",[378,2341,2342,2343,2346,2347,2349,2350,2352,2353,2355],{},"Traffic stays fenced for the whole rollback, including when the stack is started with ",[388,2344,2345],{},"v1 up --no-build",": draining the\nqueue (",[388,2348,2048],{}," → ",[388,2351,2052],{},") and the ",[388,2354,2056],{}," calls prove the queue was empty at that moment, not that the restored data is\ndeletion-complete. Reopen traffic only after the replay above is verified.",[405,2357,2359],{"id":2358},"data-lifecycle-on-this-profile","Data lifecycle on this profile",[1014,2361,2362,2380,2408,2430,2457,2581],{},[1017,2363,2364,2367,2368,2371,2372,2375,2376,2379],{},[1020,2365,2366],{},"Forget erases content."," ",[388,2369,2370],{},"POST \u002Fv1\u002Fmemories\u002F{id}\u002Fforget"," overwrites the memory's text, replaces its hash, zeroes its\nmetadata and PII flags, deletes its labels, feedback, relationships and conflict escalations, and scrubs the\nfinalized idempotent create response that stored the body. The row remains as a deletion marker, and a ",[388,2373,2374],{},"forgotten","\nlifecycle event records the revision. Replaying the create's idempotency key afterwards returns\n",[388,2377,2378],{},"409 IDEMPOTENCY_KEY_ERASED",", never the erased body; a create still finalizing when the forget commits stores the\nsame marker instead of the content.",[1017,2381,2382,2385,2386,2389,2390,2393,2394,2396,2397,2400,2401,2403,2404,2407],{},[1020,2383,2384],{},"A legal hold blocks destruction."," While ",[388,2387,2388],{},"ibex_core.legal_holds"," has an uncleared row for the organization, forget\nreturns ",[388,2391,2392],{},"409 LEGAL_HOLD_ACTIVE"," and organization deletion ends ",[388,2395,2321],{},". Clearing the hold re-enables forget,\nbut ",[1020,2398,2399],{},"it does not resume a blocked deletion",": that job stays ",[388,2402,2321],{},", the organization is already ",[388,2405,2406],{},"cancelled",",\nand a new deletion request for it is rejected. This is the recognised ground to refuse erasure when a legal\nobligation to preserve applies.",[1017,2409,2410,2413,2414,2417,2418,2421,2422,2425,2426,2429],{},[1020,2411,2412],{},"Organization deletion"," purges PostgreSQL and Redis in this profile (",[388,2415,2416],{},"IBEX_ORG_DELETION_DEPLOYED_STORES=postgres,redis",")\nand reports per-store receipts; a store declared deployed but unreachable fails the job rather than reporting success.\nClickHouse and object storage are not part of this profile, so their purge paths are not claimed here. The ClickHouse\ntenant-table purge set exists (P1-20) but is ",[1020,2419,2420],{},"provisional",": only ",[388,2423,2424],{},"llm_traces"," is covered by a local absence test, so\nthe other tables — ",[388,2427,2428],{},"usage_facts"," included — are implemented, not verified. The PostgreSQL billing tables are retained.",[1017,2431,2432,2367,2435,2437,2438,470,2441,862,2444,2447,2448,1144,2450,2453,2454,2456],{},[1020,2433,2434],{},"\"Zero rows\" excludes receipts and billing by design.",[388,2436,2313],{},", deletion receipts,\n",[388,2439,2440],{},"memory_lifecycle_outbox",[388,2442,2443],{},"ibex_billing.*",[388,2445,2446],{},"failed_tasks"," are retained; the organization row is marked\n",[388,2449,2406],{},[388,2451,2452],{},"deleted_at",". Do not read the deletion as \"every row is gone\". ClickHouse ",[388,2455,2428],{}," is in the\nprovisional purge set; the Postgres billing tables are retained.",[1017,2458,2459,2462,2463],{},[1020,2460,2461],{},"Backups are not erased by forget."," A restore moves the database back in time, so erasure is a recovery-wave\nobligation, not a side effect of forgetting:\n",[1737,2464,2465,2495,2562],{},[1017,2466,2467,2468,2471,2472,470,2475,470,2478,470,2481,2484,2485,2487,2488,2491,2492,2494],{},"Record deletion events ",[1020,2469,2470],{},"outside"," the database — forgets (memory, organization, revision), the scoped\nidempotency key of every erased create (",[388,2473,2474],{},"organization_id",[388,2476,2477],{},"agent_id",[388,2479,2480],{},"dedupe_key",[388,2482,2483],{},"request_hash",") and completed\norganization deletions with their per-store receipts. A snapshot that predates them does not contain them.\nCapture is crash-safe by reconciliation, not by ordering: every committed forget writes a ",[388,2486,2374],{}," row to\n",[388,2489,2490],{},"ibex_core.memory_lifecycle_outbox"," in its own transaction, so after the fact compare that table and\n",[388,2493,2313],{}," against the external record. If the external record is missing an event the database has, or\nits completeness cannot be proven, treat the restore as unsafe and keep traffic fenced.",[1017,2496,2497,2498,2501,2502,2505,2506,2509,2510,2513,2514,2517,2518,2521,2522,2525,2526,2529,2530,2533,2534,2529,2537,2540,2541,2529,2544,2529,2547,2550,2551,2554,2555,2558,2559,2561],{},"After a restore, re-apply every deletion marker, then ",[1020,2499,2500],{},"erase the restored row itself"," — overwrite ",[388,2503,2504],{},"content"," with\n",[388,2507,2508],{},"[forgotten]",", replace ",[388,2511,2512],{},"content_hash"," with a new random value, zero ",[388,2515,2516],{},"content_tokens",", reset ",[388,2519,2520],{},"metadata"," to ",[388,2523,2524],{},"{}",",\nclear the PII flags, clear ",[388,2527,2528],{},"superseded_by","\u002F",[388,2531,2532],{},"merged_into",", clear ",[388,2535,2536],{},"retrieval_count",[388,2538,2539],{},"last_retrieved_at",", and null\n",[388,2542,2543],{},"embedding",[388,2545,2546],{},"embedding_model",[388,2548,2549],{},"embedding_dim"," — delete the restored child rows (labels, feedback, relationships,\nconflict escalations) and re-scrub the idempotency-ledger responses. A marker that only sets ",[388,2552,2553],{},"tombstoned"," leaves\nthe content, hash, embedding and metadata recoverable in the restored row.\nIf the ledger has no row for an erased key (it was purged, or the snapshot predates the row), insert a terminal\nmarker so a retry cannot re-create the memory: ",[388,2556,2557],{},"INSERT INTO ibex_core.idempotency_ledger (organization_id, agent_id, dedupe_key, request_hash, state, status_code, response_payload) VALUES (..., 'finalized', 201, convert_to('{\"erased\": true}', 'UTF8')) ON CONFLICT (organization_id, agent_id, dedupe_key) DO UPDATE SET state = 'finalized', status_code = 201, response_payload = EXCLUDED.response_payload",". A retry then returns\n",[388,2560,2378],{}," instead of re-creating the memory.",[1017,2563,2564,2565,2568,2569,2571,2572,2574,2575,2577,2578,391],{},"Verify before serving traffic: ",[388,2566,2567],{},"SELECT count(*) FROM ibex_core.memories WHERE tombstoned AND (content \u003C> '[forgotten]' OR content_tokens \u003C> 0 OR metadata \u003C> '{}'::jsonb OR embedding IS NOT NULL OR pii_detected OR pii_redacted OR superseded_by IS NOT NULL OR merged_into IS NOT NULL)"," must return ",[388,2570,2052],{},", every child-row count must\nbe ",[388,2573,2052],{},", every erased key must replay as ",[388,2576,2378],{},", and the per-store receipts must match the\nexternal record. A restore with pending deletions, or one whose record cannot be reconciled, stays fenced.\nA Redis cache eviction that fails is retried only by the cache TTL, so a copy can survive there for\n",[388,2579,2580],{},"IBEX_MEMORY_CACHE_TTL_SECONDS",[1017,2582,2583,2586,2587,2590,2591,2594,2595,2597,2598,2601,2602,2604,2605,2607,2608,2611],{},[1020,2584,2585],{},"Database role."," Memory CRUD, vector operations ",[1020,2588,2589],{},"and the idempotency ledger"," run every transaction as ",[388,2592,2593],{},"ibex_app","\nso row-level security applies; the ledger's queries are additionally scoped by ",[388,2596,2474],{},". Nothing in the\nmemory service runs with the service-account bypass. The login in ",[388,2599,2600],{},"IBEX_API_DATABASE_URL"," \u002F the memory DSN must be a\nmember of ",[388,2603,2593],{},"; the profile's ",[388,2606,1435],{}," role is granted it by migration ",[388,2609,2610],{},"000004",". A deployment that uses a\ndifferent login must grant membership, or memory reads fail closed.",[405,2613,2615],{"id":2614},"exclusions-and-limits","Exclusions and limits",[1014,2617,2618,2621,2624,2627,2634,2646,2669,2678,2690,2697,2700],{},[1017,2619,2620],{},"No Kubernetes, Helm, or HA topology, and no hosted or measured p99 SLO.",[1017,2622,2623],{},"No multi-user authentication: the profile bootstraps one owner and one agent.",[1017,2625,2626],{},"No ClickHouse or MinIO\u002FS3 projection, reranker, or observability stack; those stay optional and default off.",[1017,2628,2629,2630,2633],{},"TEI runs on CPU. First start downloads roughly 2 GB of model weights into the ",[388,2631,2632],{},"tei-cache"," volume; the healthcheck\nallows for it. Expect CPU-bound embedding latency, not a GPU SLO.",[1017,2635,2636,2637,2639,2640,2642,2643,2645],{},"The first start is gated on TEI and can take tens of minutes on a slow network: the TEI health window is two hours,\nand the embedder, memory, and worker wait behind it. The ",[388,2638,2632],{}," volume keeps a partial download across restarts,\nso re-running ",[388,2641,486],{}," resumes rather than restarts the fetch. A host with a warm ",[388,2644,2632],{}," skips the download\nentirely; that is the recommended pre-seed for an offline or bandwidth-limited install.",[1017,2647,2648,2649,862,2652,935,2655,2657,2658,2660,2661,2664,2665,2668],{},"The reference profile is sized for a 16 GB host. TEI uses about 8 GB RSS with the 2048-token batch; the application\nplane is about 3 GB. On a smaller host, lower ",[388,2650,2651],{},"--max-batch-tokens",[388,2653,2654],{},"--max-concurrent-requests",[388,2656,899],{},", or give the host more memory. ",[388,2659,2651],{}," also bounds the\nlongest input TEI will accept: with the default ",[388,2662,2663],{},"--auto-truncate",", TEI derives its per-request input limit from this\nvalue, and the embedder sends ",[388,2666,2667],{},"truncate: false",", so a memory longer than the limit fails to embed instead of being\nshortened. Raise the value toward the model's context limit if long memories must be indexed.",[1017,2670,2671,2672,2674,2675,2677],{},"The bootstrap PAT does not expire. Retrieve it once with ",[388,2673,516],{},", store it in a secret manager, and\ndelete ",[388,2676,490],{}," afterwards. The command prints the credential to your\nterminal: do not run it from CI or any wrapper that retains stdout. Rotation is a revoke-and-reissue operation\nthrough the API, not a bootstrap rerun.",[1017,2679,2680,2681,2683,2684,2686,2687,2689],{},"The generated memory service token is reconciled by a later bootstrap run when it changes. Stop the profile before\nchanging ",[388,2682,1249],{},", then run ",[388,2685,486],{},": bootstrap rewrites the hashed row and recreates the context\nand worker containers that hold the old value. Editing ",[388,2688,1114],{}," alone leaves those two callers authenticating with the\nprevious token until they restart.",[1017,2691,2692,2693,2696],{},"One agent only. The memory service token is bound to the bootstrapped agent, so context retrieval for a\nsubsequently added agent returns ",[388,2694,2695],{},"AGENT_NOT_AUTHORIZED"," and assembles without that agent's memories. Multi-agent\nmemory authorisation needs a per-agent token design; it is not part of this profile.",[1017,2698,2699],{},"Internal shared-token HTTP and the Redis password travel on the host-local Compose bridge. ADR-0097 records this as a\ndocumented limitation, not a public interface; the credential-bearing browser hops stay on loopback.",[1017,2701,2702],{},"The profile is evidenced on one host with one tenant. Cross-tenant acceptance and recovery drills are later gates,\nand this page makes no claim about them.",[405,2704,2706],{"id":2705},"related","Related",[1014,2708,2709,2714,2719],{},[1017,2710,2711,2713],{},[382,2712,323],{"href":324}," — the full registry, including the file-backed keys.",[1017,2715,2716,2718],{},[382,2717,319],{"href":320}," — the development dependency stack, which is not this profile.",[1017,2720,2721,2723],{},[382,2722,331],{"href":332}," — the gates that remain open above this profile.",[2725,2726,2727],"style",{},"html pre.shiki code .sYn-s, html code.shiki .sYn-s{--shiki-light:#E2931D;--shiki-default:#59873A;--shiki-dark:#80A665}html pre.shiki code .sTbE_, html code.shiki .sTbE_{--shiki-light:#91B859;--shiki-default:#B56959;--shiki-dark:#C98A7D}html pre.shiki code .s9Tkl, html code.shiki .s9Tkl{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#A0ADA0;--shiki-default-font-style:inherit;--shiki-dark:#758575DD;--shiki-dark-font-style:inherit}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sSC40, html code.shiki .sSC40{--shiki-light:#90A4AE;--shiki-default:#B07D48;--shiki-dark:#BD976A}html pre.shiki code .soVBu, html code.shiki .soVBu{--shiki-light:#39ADB5;--shiki-default:#999999;--shiki-dark:#666666}html pre.shiki code .sz9Cv, html code.shiki .sz9Cv{--shiki-light:#91B859;--shiki-default:#A65E2B;--shiki-dark:#C99076}html pre.shiki code .sbYkP, html code.shiki .sbYkP{--shiki-light:#39ADB5;--shiki-default:#B5695977;--shiki-dark:#C98A7D77}html pre.shiki code .su_V2, html code.shiki .su_V2{--shiki-light:#90A4AE;--shiki-default:#B56959;--shiki-dark:#C98A7D}html pre.shiki code .siDh9, html code.shiki .siDh9{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#1E754F;--shiki-default-font-style:inherit;--shiki-dark:#4D9375;--shiki-dark-font-style:inherit}html pre.shiki code .sftqT, html code.shiki .sftqT{--shiki-light:#90A4AE;--shiki-default:#393A34;--shiki-dark:#DBD7CAEE}html pre.shiki code .sJdAF, html code.shiki .sJdAF{--shiki-light:#6182B8;--shiki-default:#998418;--shiki-dark:#B8A965}html pre.shiki code .sVsLi, html code.shiki .sVsLi{--shiki-light:#39ADB5;--shiki-default:#AB5959;--shiki-dark:#CB7676}html pre.shiki code .s7CZa, html code.shiki .s7CZa{--shiki-light:#F76D47;--shiki-default:#2F798A;--shiki-dark:#4C9A91}",{"title":415,"searchDepth":437,"depth":437,"links":2729},[2730,2731,2732,2733,2734,2735,2736,2737,2738,2739,2740,2741],{"id":407,"depth":437,"text":408},{"id":529,"depth":437,"text":530},{"id":903,"depth":437,"text":904},{"id":1011,"depth":437,"text":1012},{"id":1132,"depth":437,"text":1133},{"id":1203,"depth":437,"text":1204},{"id":1253,"depth":437,"text":1254},{"id":1540,"depth":437,"text":1541},{"id":1723,"depth":437,"text":1724},{"id":2358,"depth":437,"text":2359},{"id":2614,"depth":437,"text":2615},{"id":2705,"depth":437,"text":2706},"The supported single-node Docker Compose profile — one published HTTPS port, pinned dependencies, safe bootstrap, and recorded readiness.","md",false,{},true,"shipped-local",{"title":335,"description":2742},"infra\u002Fcompose\u002Fv1-single-node; engineering\u002Fadr\u002F0097-v1-supported-profile.md; engineering\u002FDEPLOYMENT.md","2026-11-08","SuJnfoj0l_QF7W4UVZrxGtVdvR--xLX9CArNpaw0GPs",[2753,2755],{"title":331,"path":332,"stem":333,"description":2754,"children":-1},"The evidence required before IBEX Harness can claim production readiness.",{"title":339,"path":340,"stem":341,"description":2756,"children":-1},"The v0.1.9 → head upgrade reference — migration counts, the irreversible migration families, the backup precondition, rollback limits, and what is and is not supported today.",1795256626258]