[{"data":1,"prerenderedAt":588},["ShallowReactive",2],{"navigation":3,"page-\u002Fgetting-started\u002Freference\u002Fadvanced":200,"\u002Fgetting-started\u002Freference\u002Fadvanced-surround":578},[4,117,181,194],{"title":5,"path":6,"stem":7,"children":8},"Erste Schritte","\u002Fde\u002Fgetting-started","de\u002F1.getting-started\u002F1.index",[9,10,14,18,22,26,30,56,69,85,107],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13},"Funktionen","\u002Fde\u002Fgetting-started\u002Ffeatures","de\u002F1.getting-started\u002F1.features",{"title":15,"path":16,"stem":17},"Demo","\u002Fde\u002Fgetting-started\u002Fdemo","de\u002F1.getting-started\u002F2.demo",{"title":19,"path":20,"stem":21},"Anforderungen","\u002Fde\u002Fgetting-started\u002Frequirements","de\u002F1.getting-started\u002F2.requirements",{"title":23,"path":24,"stem":25},"Komponenten","\u002Fde\u002Fgetting-started\u002Fcomponents","de\u002F1.getting-started\u002F3.components",{"title":27,"path":28,"stem":29},"Versionierung","\u002Fde\u002Fgetting-started\u002Fversioning","de\u002F1.getting-started\u002F3.versioning",{"title":31,"path":32,"stem":33,"children":34,"page":55},"Installation","\u002Fde\u002Fgetting-started\u002Finstallation","de\u002F1.getting-started\u002F4.installation",[35,39,43,47,51],{"title":36,"path":37,"stem":38},"Installationsmethoden","\u002Fde\u002Fgetting-started\u002Finstallation\u002Fmethods","de\u002F1.getting-started\u002F4.installation\u002F1.methods",{"title":40,"path":41,"stem":42},"Cloud","\u002Fde\u002Fgetting-started\u002Finstallation\u002Fcloud","de\u002F1.getting-started\u002F4.installation\u002F2.cloud",{"title":44,"path":45,"stem":46},"Verwendung von Docker","\u002Fde\u002Fgetting-started\u002Finstallation\u002Fcontainer-docker","de\u002F1.getting-started\u002F4.installation\u002F3.container-docker",{"title":48,"path":49,"stem":50},"Kubernetes: Verwendung von Helm","\u002Fde\u002Fgetting-started\u002Finstallation\u002Fkubernetes-helm","de\u002F1.getting-started\u002F4.installation\u002F4.kubernetes-helm",{"title":52,"path":53,"stem":54},"Ersteinrichtung abschließen","\u002Fde\u002Fgetting-started\u002Finstallation\u002Fpost-install-steps","de\u002F1.getting-started\u002F4.installation\u002F6.post-install-steps",false,{"title":57,"path":58,"stem":59,"children":60,"page":55},"Konfiguration","\u002Fde\u002Fgetting-started\u002Fconfiguration","de\u002F1.getting-started\u002F5.configuration",[61,65],{"title":62,"path":63,"stem":64},"FiveNet konfigurieren","\u002Fde\u002Fgetting-started\u002Fconfiguration\u002Fconfigure","de\u002F1.getting-started\u002F5.configuration\u002F2.configure",{"title":66,"path":67,"stem":68},"DBSync: Installieren und konfigurieren","\u002Fde\u002Fgetting-started\u002Fconfiguration\u002Fdbsync","de\u002F1.getting-started\u002F5.configuration\u002F3.dbsync",{"title":70,"path":71,"stem":72,"children":73,"page":55},"Gameserver","\u002Fde\u002Fgetting-started\u002Fgameserver","de\u002F1.getting-started\u002F6.gameserver",[74],{"title":75,"path":76,"stem":77,"children":78,"page":55},"FiveM Plugin","\u002Fde\u002Fgetting-started\u002Fgameserver\u002Ffivem-plugin","de\u002F1.getting-started\u002F6.gameserver\u002F1.fivem-plugin",[79,82],{"title":31,"path":80,"stem":81},"\u002Fde\u002Fgetting-started\u002Fgameserver\u002Ffivem-plugin\u002Finstallation","de\u002F1.getting-started\u002F6.gameserver\u002F1.fivem-plugin\u002F1.installation",{"title":57,"path":83,"stem":84},"\u002Fde\u002Fgetting-started\u002Fgameserver\u002Ffivem-plugin\u002Fconfiguration","de\u002F1.getting-started\u002F6.gameserver\u002F1.fivem-plugin\u002F2.configuration",{"title":86,"path":87,"stem":88,"children":89},"Referenz","\u002Fde\u002Fgetting-started\u002Freference","de\u002F1.getting-started\u002F7.reference\u002Findex",[90,91,95,99,103],{"title":86,"path":87,"stem":88},{"title":92,"path":93,"stem":94},"Erweiterte Konfiguration","\u002Fde\u002Fgetting-started\u002Freference\u002Fadvanced","de\u002F1.getting-started\u002F7.reference\u002Fadvanced",{"title":96,"path":97,"stem":98},"Konfigurationsdatei-Referenz","\u002Fde\u002Fgetting-started\u002Freference\u002Fconfig-reference","de\u002F1.getting-started\u002F7.reference\u002Fconfig-reference",{"title":100,"path":101,"stem":102},"Datenbankeinrichtung","\u002Fde\u002Fgetting-started\u002Freference\u002Fdatabase-setup","de\u002F1.getting-started\u002F7.reference\u002Fdatabase-setup",{"title":104,"path":105,"stem":106},"Befehls-Flags","\u002Fde\u002Fgetting-started\u002Freference\u002Fflags","de\u002F1.getting-started\u002F7.reference\u002Fflags",{"title":108,"path":109,"stem":110,"children":111},"Fehlerbehebung","\u002Fde\u002Fgetting-started\u002Ftroubleshooting","de\u002F1.getting-started\u002F8.troubleshooting\u002Findex",[112,113],{"title":108,"path":109,"stem":110},{"title":114,"path":115,"stem":116},"Datenbank- und Installationsfehlerbehebung","\u002Fde\u002Fgetting-started\u002Ftroubleshooting\u002Finstallation-issues","de\u002F1.getting-started\u002F8.troubleshooting\u002Finstallation-issues",{"title":118,"path":119,"stem":120,"children":121},"Benutzerhandbücher","\u002Fde\u002Fuser-guides","de\u002F3.user-guides\u002F0.index",[122,123,127,131,135,145,149,153,157,161,165,169,173,177],{"title":118,"path":119,"stem":120},{"title":124,"path":125,"stem":126},"Systemanforderungen","\u002Fde\u002Fuser-guides\u002Fsystem-requirements","de\u002F3.user-guides\u002F0.system-requirements",{"title":128,"path":129,"stem":130},"Bürger","\u002Fde\u002Fuser-guides\u002Fcitizens","de\u002F3.user-guides\u002F1.citizens",{"title":132,"path":133,"stem":134},"Fahrzeuge","\u002Fde\u002Fuser-guides\u002Fvehicles","de\u002F3.user-guides\u002F2.vehicles",{"title":136,"path":137,"stem":138,"children":139},"Dokumente","\u002Fde\u002Fuser-guides\u002Fdocuments","de\u002F3.user-guides\u002F3.documents\u002Findex",[140,141],{"title":136,"path":137,"stem":138},{"title":142,"path":143,"stem":144},"Vorlagen","\u002Fde\u002Fuser-guides\u002Fdocuments\u002Ftemplates","de\u002F3.user-guides\u002F3.documents\u002Ftemplates",{"title":146,"path":147,"stem":148},"Jobs","\u002Fde\u002Fuser-guides\u002Fjobs","de\u002F3.user-guides\u002F3.jobs",{"title":150,"path":151,"stem":152},"Kalender","\u002Fde\u002Fuser-guides\u002Fcalendar","de\u002F3.user-guides\u002F4.calendar",{"title":154,"path":155,"stem":156},"Livemap","\u002Fde\u002Fuser-guides\u002Flivemap","de\u002F3.user-guides\u002F5.livemap",{"title":158,"path":159,"stem":160},"Einsatzzentrale","\u002Fde\u002Fuser-guides\u002Fcentrum","de\u002F3.user-guides\u002F6.centrum",{"title":162,"path":163,"stem":164},"Mailer","\u002Fde\u002Fuser-guides\u002Fmailer","de\u002F3.user-guides\u002F6.mailer",{"title":166,"path":167,"stem":168},"Einstellungen","\u002Fde\u002Fuser-guides\u002Fsettings","de\u002F3.user-guides\u002F7.settings",{"title":170,"path":171,"stem":172},"Sprachen (i18n)","\u002Fde\u002Fuser-guides\u002Fi18n","de\u002F3.user-guides\u002F8.i18n",{"title":174,"path":175,"stem":176},"iOS-App","\u002Fde\u002Fuser-guides\u002Fios-app","de\u002F3.user-guides\u002F9.ios-app",{"title":178,"path":179,"stem":180},"StreamDeck Plugin","\u002Fde\u002Fuser-guides\u002Fplugin-streamdeck","de\u002F3.user-guides\u002F9.plugin-streamdeck",{"title":182,"path":183,"stem":184,"children":185},"Entwicklung","\u002Fde\u002Fdevelopment","de\u002F8.development\u002F1.index",[186,187,191],{"title":182,"path":183,"stem":184},{"title":188,"path":189,"stem":190},"User Activity","\u002Fde\u002Fdevelopment\u002Fuser-activity","de\u002F8.development\u002F5.user-activity",{"title":170,"path":192,"stem":193},"\u002Fde\u002Fdevelopment\u002Fi18n","de\u002F8.development\u002Fi18n",{"title":195,"path":196,"stem":197,"children":198},"Design","\u002Fde\u002Fdesign","de\u002F9.design\u002F1.index",[199],{"title":195,"path":196,"stem":197},{"id":201,"title":202,"body":203,"description":569,"extension":570,"links":571,"meta":572,"navigation":573,"path":574,"redirect":571,"seo":575,"stem":576,"__hash__":577},"content_en\u002F1.getting-started\u002F7.reference\u002Fadvanced.md","Advanced Configuration",{"type":204,"value":205,"toc":558},"minimark",[206,210,215,218,247,256,261,303,307,317,320,331,341,345,352,355,366,375,379,385,388,395,399,402,405,409,554],[207,208,209],"p",{},"Use this page when your FiveNet setup goes beyond the basic installation and required configuration options.",[211,212,214],"h2",{"id":213},"common-advanced-topics","Common Advanced Topics",[207,216,217],{},"The most common advanced configuration areas are:",[219,220,221,229,235,241],"ul",{},[222,223,224,228],"li",{},[225,226,227],"strong",{},"Trusted proxies"," when FiveNet runs behind NGINX, Traefik, Cloudflare, or another reverse proxy.",[222,230,231,234],{},[225,232,233],{},"Object storage"," when uploads should be stored in S3-compatible storage instead of the local filesystem.",[222,236,237,240],{},[225,238,239],{},"OAuth2 providers"," when users should be able to authenticate through external identity providers.",[222,242,243,246],{},[225,244,245],{},"Tracing and observability"," for debugging, performance analysis, and distributed request tracing.",[207,248,249,250,255],{},"For the most important option names and config paths, see the ",[251,252,254],"a",{"href":253},".\u002Fconfig-reference","Config File Reference",".",[257,258,260],"h3",{"id":259},"tracing-notes","Tracing Notes",[219,262,263,271,278,296],{},[222,264,265,266,270],{},"Set ",[267,268,269],"code",{},"enabled: true"," only after you have a working OTLP endpoint.",[222,272,273,274,277],{},"Use a low ",[267,275,276],{},"ratio"," value in production unless you explicitly want to sample more traffic.",[222,279,280,281,284,285,288,289,292,293,255],{},"Keep the ",[267,282,283],{},"environment"," value aligned with the environment where FiveNet runs, such as ",[267,286,287],{},"development",", ",[267,290,291],{},"staging",", or ",[267,294,295],{},"production",[222,297,298,299,302],{},"Use ",[267,300,301],{},"attributes"," to attach additional metadata that helps identify traces in your observability platform.",[211,304,306],{"id":305},"reverse-proxy-and-trusted-proxies","Reverse Proxy and Trusted Proxies",[207,308,309,310,313,314,255],{},"If FiveNet is deployed behind one or more reverse proxies, review the ",[267,311,312],{},"http.trustedProxies"," option in your ",[267,315,316],{},"config.yaml",[207,318,319],{},"This is especially important when:",[219,321,322,325,328],{},[222,323,324],{},"client IP addresses should be preserved correctly",[222,326,327],{},"FiveNet is running behind NGINX, Traefik, or Cloudflare",[222,329,330],{},"you rely on forwarded headers from trusted infrastructure",[207,332,333,334,337,338,340],{},"See the ",[251,335,254],{"href":336},".\u002Fconfig-reference#http"," for the ",[267,339,312],{}," setting.",[211,342,344],{"id":343},"object-storage","Object Storage",[207,346,347,348,351],{},"By default, FiveNet stores uploads on the local filesystem. For more scalable or externally managed storage, you can switch to S3-compatible object storage through the ",[267,349,350],{},"storage"," configuration.",[207,353,354],{},"This is commonly useful when:",[219,356,357,360,363],{},[222,358,359],{},"running multiple instances",[222,361,362],{},"using cloud infrastructure",[222,364,365],{},"keeping uploaded files outside the application host",[207,367,333,368,337,371,374],{},[251,369,254],{"href":370},".\u002Fconfig-reference#storage",[267,372,373],{},"storage.type"," setting and related storage options.",[211,376,378],{"id":377},"oauth2-providers","OAuth2 Providers",[207,380,381,382,351],{},"FiveNet can be integrated with external authentication providers through the ",[267,383,384],{},"oauth2.providers",[207,386,387],{},"Use this when users should sign in through systems such as Discord or another OAuth2 or OpenID Connect provider instead of relying only on local authentication flows.",[207,389,333,390,337,393,340],{},[251,391,254],{"href":392},".\u002Fconfig-reference#oauth2",[267,394,384],{},[211,396,398],{"id":397},"tracing","Tracing",[207,400,401],{},"FiveNet supports OpenTelemetry-based tracing for the server and worker components. This can help you inspect request flow, background processing, and performance bottlenecks in more advanced environments.",[207,403,404],{},"Tracing is usually only needed when you already have an observability stack in place or when you are troubleshooting more complex issues.",[257,406,408],{"id":407},"example-tracing-configuration","Example Tracing Configuration",[410,411,416],"pre",{"className":412,"code":413,"language":414,"meta":415,"style":415},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","otlp:\n  enabled: false\n  # otlptracegrpc or otlptracehttp\n  type: \"otlptracegrpc\"\n  # OTLP tracing endpoint URL\n  url: \"https:\u002F\u002Fexample.com:4317\"\n  insecure: false\n  timeout: 10s\n  environment: \"production\"\n  ratio: 0.1\n  attributes:\n    - service.name=fivenet-server\n","yaml","",[267,417,418,431,444,451,469,475,490,500,511,525,537,545],{"__ignoreMap":415},[419,420,423,427],"span",{"class":421,"line":422},"line",1,[419,424,426],{"class":425},"swJcz","otlp",[419,428,430],{"class":429},"sMK4o",":\n",[419,432,434,437,440],{"class":421,"line":433},2,[419,435,436],{"class":425},"  enabled",[419,438,439],{"class":429},":",[419,441,443],{"class":442},"sfNiH"," false\n",[419,445,447],{"class":421,"line":446},3,[419,448,450],{"class":449},"sHwdD","  # otlptracegrpc or otlptracehttp\n",[419,452,454,457,459,462,466],{"class":421,"line":453},4,[419,455,456],{"class":425},"  type",[419,458,439],{"class":429},[419,460,461],{"class":429}," \"",[419,463,465],{"class":464},"sfazB","otlptracegrpc",[419,467,468],{"class":429},"\"\n",[419,470,472],{"class":421,"line":471},5,[419,473,474],{"class":449},"  # OTLP tracing endpoint URL\n",[419,476,478,481,483,485,488],{"class":421,"line":477},6,[419,479,480],{"class":425},"  url",[419,482,439],{"class":429},[419,484,461],{"class":429},[419,486,487],{"class":464},"https:\u002F\u002Fexample.com:4317",[419,489,468],{"class":429},[419,491,493,496,498],{"class":421,"line":492},7,[419,494,495],{"class":425},"  insecure",[419,497,439],{"class":429},[419,499,443],{"class":442},[419,501,503,506,508],{"class":421,"line":502},8,[419,504,505],{"class":425},"  timeout",[419,507,439],{"class":429},[419,509,510],{"class":464}," 10s\n",[419,512,514,517,519,521,523],{"class":421,"line":513},9,[419,515,516],{"class":425},"  environment",[419,518,439],{"class":429},[419,520,461],{"class":429},[419,522,295],{"class":464},[419,524,468],{"class":429},[419,526,528,531,533],{"class":421,"line":527},10,[419,529,530],{"class":425},"  ratio",[419,532,439],{"class":429},[419,534,536],{"class":535},"sbssI"," 0.1\n",[419,538,540,543],{"class":421,"line":539},11,[419,541,542],{"class":425},"  attributes",[419,544,430],{"class":429},[419,546,548,551],{"class":421,"line":547},12,[419,549,550],{"class":429},"    -",[419,552,553],{"class":464}," service.name=fivenet-server\n",[555,556,557],"style",{},"html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}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);}",{"title":415,"searchDepth":433,"depth":433,"links":559},[560,563,564,565,566],{"id":213,"depth":433,"text":214,"children":561},[562],{"id":259,"depth":446,"text":260},{"id":305,"depth":433,"text":306},{"id":343,"depth":433,"text":344},{"id":377,"depth":433,"text":378},{"id":397,"depth":433,"text":398,"children":567},[568],{"id":407,"depth":446,"text":408},"Advanced configuration topics for monitoring, proxies, storage, and external integrations.","md",null,{},true,"\u002Fgetting-started\u002Freference\u002Fadvanced",{"title":202,"description":569},"1.getting-started\u002F7.reference\u002Fadvanced","gC67Jx44j6Xs6_nRqEtWpLFIznEDqBnqsZVAZHFP--Q",[579,584],{"title":580,"path":581,"stem":582,"description":583,"children":-1},"Reference","\u002Fgetting-started\u002Freference","1.getting-started\u002F7.reference\u002Findex","Reference material for operating and maintaining FiveNet.",{"title":254,"path":585,"stem":586,"description":587,"children":-1},"\u002Fgetting-started\u002Freference\u002Fconfig-reference","1.getting-started\u002F7.reference\u002Fconfig-reference","Reference for FiveNet configuration options and defaults.",1789448919088]