[{"data":1,"prerenderedAt":465},["ShallowReactive",2],{"\u002Fdocs\u002Fconfiguration":3,"docs-nav":433},{"id":4,"title":5,"body":6,"description":425,"extension":426,"meta":427,"navigation":428,"path":429,"seo":430,"stem":431,"__hash__":432},"docs\u002Fdocs\u002F6.configuration.md","Configuration",{"type":7,"value":8,"toc":417},"minimark",[9,13,231,240,260,264,323,326,348,352,363,372,376,382,392,405,409],[10,11,12],"p",{},"Redrive reads each setting in this order: CLI flag, then environment variable, then built-in default.",[14,15,16,35],"table",{},[17,18,19],"thead",{},[20,21,22,26,29,32],"tr",{},[23,24,25],"th",{},"Setting",[23,27,28],{},"CLI",[23,30,31],{},"Env",[23,33,34],{},"Default",[36,37,38,61,81,97,115,134,151,168,183,200,214],"tbody",{},[20,39,40,44,50,55],{},[41,42,43],"td",{},"Port",[41,45,46],{},[47,48,49],"code",{},"--port",[41,51,52],{},[47,53,54],{},"REDRIVE_PORT",[41,56,57,60],{},[47,58,59],{},"5100"," (falls back to an OS-assigned port if taken, and prints it)",[20,62,63,66,71,76],{},[41,64,65],{},"Bind host",[41,67,68],{},[47,69,70],{},"--host",[41,72,73],{},[47,74,75],{},"REDRIVE_HOST",[41,77,78],{},[47,79,80],{},"localhost",[20,82,83,86,89,94],{},[41,84,85],{},"Auth password",[41,87,88],{},"—",[41,90,91],{},[47,92,93],{},"REDRIVE_PASSWORD",[41,95,96],{},"unset",[20,98,99,102,107,112],{},[41,100,101],{},"Data directory",[41,103,104],{},[47,105,106],{},"--data-dir",[41,108,109],{},[47,110,111],{},"REDRIVE_DATA_DIR",[41,113,114],{},"per platform, listed below",[20,116,117,120,126,131],{},[41,118,119],{},"Open browser",[41,121,122,125],{},[47,123,124],{},"--no-browser"," to disable",[41,127,128],{},[47,129,130],{},"REDRIVE_NO_BROWSER=1",[41,132,133],{},"opens on start",[20,135,136,139,141,146],{},[41,137,138],{},"Batch limit",[41,140,88],{},[41,142,143],{},[47,144,145],{},"REDRIVE_REDRIVE_BATCH_LIMIT",[41,147,148],{},[47,149,150],{},"100",[20,152,153,156,158,163],{},[41,154,155],{},"Scan depth",[41,157,88],{},[41,159,160],{},[47,161,162],{},"REDRIVE_REDRIVE_SCAN_DEPTH",[41,164,165],{},[47,166,167],{},"1000",[20,169,170,173,175,180],{},[41,171,172],{},"Update check",[41,174,88],{},[41,176,177,125],{},[47,178,179],{},"REDRIVE_NO_UPDATE_CHECK=1",[41,181,182],{},"on",[20,184,185,188,190,195],{},[41,186,187],{},"Update check URL",[41,189,88],{},[41,191,192],{},[47,193,194],{},"REDRIVE_UPDATE_CHECK_URL",[41,196,197],{},[47,198,199],{},"https:\u002F\u002Fget.redrive.dev\u002Flatest.json",[20,201,202,205,207,212],{},[41,203,204],{},"License key",[41,206,88],{},[41,208,209],{},[47,210,211],{},"REDRIVE_LICENSE_KEY",[41,213,96],{},[20,215,216,219,221,226],{},[41,217,218],{},"Licensing server",[41,220,88],{},[41,222,223],{},[47,224,225],{},"REDRIVE_LICENSING_URL",[41,227,228],{},[47,229,230],{},"https:\u002F\u002Flicensing.redrive.dev",[10,232,233,234,239],{},"The batch limit caps messages moved per run, and the scan depth caps messages read while matching; both apply to redrives and discards alike. ",[235,236,238],"a",{"href":237},"\u002Fdocs\u002Fredriving","Redriving"," describes how each limit plays out during a run.",[241,242,243],"blockquote",{},[10,244,245,251,252,255,256,259],{},[246,247,248,250],"strong",{},[47,249,93],{}," is deliberately the only way to set the password."," A ",[47,253,254],{},"--password"," flag would end up in your shell history and in the process list, where anything running ",[47,257,258],{},"ps aux"," can read it.",[261,262,101],"h2",{"id":263},"data-directory",[14,265,266,276],{},[17,267,268],{},[20,269,270,273],{},[23,271,272],{},"Platform",[23,274,275],{},"Location",[36,277,278,288,303,313],{},[20,279,280,283],{},[41,281,282],{},"Windows",[41,284,285],{},[47,286,287],{},"%LOCALAPPDATA%\\redrive",[20,289,290,293],{},[41,291,292],{},"Linux",[41,294,295,298,299,302],{},[47,296,297],{},"~\u002F.local\u002Fshare\u002Fredrive"," (honors ",[47,300,301],{},"$XDG_DATA_HOME",")",[20,304,305,308],{},[41,306,307],{},"macOS",[41,309,310],{},[47,311,312],{},"~\u002FLibrary\u002FApplication Support\u002Fredrive",[20,314,315,318],{},[41,316,317],{},"Docker",[41,319,320],{},[47,321,322],{},"\u002Fdata",[10,324,325],{},"What's in it:",[327,328,329,336,342],"ul",{},[330,331,332,335],"li",{},[47,333,334],{},"redrive.db",", the SQLite database: connections, saved filters, everything except message content.",[330,337,338,341],{},[47,339,340],{},"dataprotection-keys\u002F",", the keys that encrypt broker credentials at rest.",[330,343,344,347],{},[47,345,346],{},"logs\u002F",", daily log files.",[261,349,351],{"id":350},"the-update-check","The update check",[10,353,354,355,357,358,362],{},"On startup, and every 24 hours after that, Redrive makes an HTTP request to ",[47,356,199],{}," to see whether a newer version is out. That request is all Redrive sends; it carries no identifiers and no details about your setup. The ",[235,359,361],{"href":360},"\u002Fprivacy","privacy policy"," has the full picture.",[10,364,365,366,368,369,371],{},"Set ",[47,367,179],{}," to turn the check off, or set ",[47,370,194],{}," to point it at a different URL.",[261,373,375],{"id":374},"license-activation","License activation",[10,377,378,379,381],{},"A paid license activates in the app, or hands-free for Docker and IaC: set\n",[47,380,211],{}," and Redrive activates itself on boot if it isn't\nactivated already. Changing the variable to a different key re-enrolls the\ninstall with it — on the next restart, or within a day on a running\ninstall; the current license keeps working until the new key is accepted.\nClearing the variable changes nothing: the install stays activated. Like\nthe password, the key is env-only by design.",[10,383,384,385,388,389,391],{},"Activation and the daily license heartbeat make outbound HTTPS requests to\none hostname: ",[47,386,387],{},"licensing.redrive.dev",". That is the only egress a licensed\ninstall needs. An install that can't reach the licensing server keeps its\npaid features for 14 days and falls back to the free tier after that;\neverything free keeps working regardless. The\n",[235,390,361],{"href":360}," lists exactly what an activated install\ntransmits — and broker data is never on the list.",[10,393,394,396,397,400,401,404],{},[47,395,225],{}," exists for networks that route egress through their\nown gateway. It must point at a host root (",[47,398,399],{},"https:\u002F\u002Fhost",", no path): Redrive\naddresses ",[47,402,403],{},"\u002Fv1\u002F..."," on it directly, so a sub-path reverse proxy would\nmisroute every request.",[261,406,408],{"id":407},"next","Next",[10,410,411,412,416],{},"Continue to ",[235,413,415],{"href":414},"\u002Fdocs\u002Fdeployment","Deployment"," to run Redrive in Docker or as a shared team instance.",{"title":418,"searchDepth":419,"depth":419,"links":420},"",2,[421,422,423,424],{"id":263,"depth":419,"text":101},{"id":350,"depth":419,"text":351},{"id":374,"depth":419,"text":375},{"id":407,"depth":419,"text":408},"Every setting Redrive reads, in the order it reads them.","md",{},true,"\u002Fdocs\u002Fconfiguration",{"title":5,"description":425},"docs\u002F6.configuration","Mv6IuEnyy5reZe90NuYVQjaXf-VTB9cgk-XV6_YVZ6Y",[434],{"title":435,"path":436,"stem":437,"children":438,"page":464},"Docs","\u002Fdocs","docs",[439,443,447,451,453,457,458,460],{"title":440,"path":441,"stem":442},"Install","\u002Fdocs\u002Finstall","docs\u002F1.install",{"title":444,"path":445,"stem":446},"Getting started","\u002Fdocs\u002Fgetting-started","docs\u002F2.getting-started",{"title":448,"path":449,"stem":450},"Queues & messages","\u002Fdocs\u002Fqueues","docs\u002F3.queues",{"title":238,"path":237,"stem":452},"docs\u002F4.redriving",{"title":454,"path":455,"stem":456},"Publishing & topology","\u002Fdocs\u002Fpublishing","docs\u002F5.publishing",{"title":5,"path":429,"stem":431},{"title":415,"path":414,"stem":459},"docs\u002F7.deployment",{"title":461,"path":462,"stem":463},"Security","\u002Fdocs\u002Fsecurity","docs\u002F8.security",false,1787116432400]