dp-salad-docs/.vitepress/dist/x11-guide.html
2025-01-04 22:46:09 -07:00

26 lines
No EOL
27 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en-US" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>X11-Guide | DP-Salad</title>
<meta name="description" content="A guide to fully deploy the DP-Salad Stack">
<meta name="generator" content="VitePress v1.5.0">
<link rel="preload stylesheet" href="/assets/style.CpK5ZA6m.css" as="style">
<link rel="preload stylesheet" href="/vp-icons.css" as="style">
<script type="module" src="/assets/app.D2AcNbxn.js"></script>
<link rel="preload" href="/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/assets/chunks/theme.Chl5AtGS.js">
<link rel="modulepreload" href="/assets/chunks/framework.DtMx7FFi.js">
<link rel="modulepreload" href="/assets/x11-guide.md.BPhK1sNP.lean.js">
<link rel="icon" type="image/x-icon" href="/asset/favicon.ico">
<script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"dark",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-39b851b6><!--[--><!--]--><!--[--><span tabindex="-1" data-v-a06310ac></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-a06310ac> Skip to content </a><!--]--><!----><header class="VPNav" data-v-39b851b6 data-v-1125fe0e><div class="VPNavBar" data-v-1125fe0e data-v-8c74a6bf><div class="wrapper" data-v-8c74a6bf><div class="container" data-v-8c74a6bf><div class="title" data-v-8c74a6bf><div class="VPNavBarTitle has-sidebar" data-v-8c74a6bf data-v-91ea8bb2><a class="title" href="/" data-v-91ea8bb2><!--[--><!--]--><!--[--><img class="VPImage logo" src="/saladicon.png" alt data-v-e838cdb3><!--]--><span data-v-91ea8bb2>DP-Salad</span><!--[--><!--]--></a></div></div><div class="content" data-v-8c74a6bf><div class="content-body" data-v-8c74a6bf><!--[--><!--]--><div class="VPNavBarSearch search" data-v-8c74a6bf><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-8c74a6bf data-v-d62dda7e><span id="main-nav-aria-label" class="visually-hidden" data-v-d62dda7e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/" tabindex="0" data-v-d62dda7e data-v-f334ebb6><!--[--><span data-v-f334ebb6>Home</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/faq" tabindex="0" data-v-d62dda7e data-v-f334ebb6><!--[--><span data-v-f334ebb6>FAQ</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/docker-compose" tabindex="0" data-v-d62dda7e data-v-f334ebb6><!--[--><span data-v-f334ebb6>Docker Compose</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/maintenance/maintain-guide" tabindex="0" data-v-d62dda7e data-v-f334ebb6><!--[--><span data-v-f334ebb6>Maintenance</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-d62dda7e data-v-f1cced18><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-f1cced18><span class="text" data-v-f1cced18><!----><span data-v-f1cced18>Install</span><span class="vpi-chevron-down text-icon" data-v-f1cced18></span></span></button><div class="menu" data-v-f1cced18><div class="VPMenu" data-v-f1cced18 data-v-b71e5dd0><div class="items" data-v-b71e5dd0><!--[--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/install/requirements" data-v-15160b25><!--[--><span data-v-15160b25>DP-Salad Requirements</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/install/dp-setup" data-v-15160b25><!--[--><span data-v-15160b25>Installing Debian and Portainer</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/install/dp-config" data-v-15160b25><!--[--><span data-v-15160b25>Configuration</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/install/salad-setup" data-v-15160b25><!--[--><span data-v-15160b25>DP-Salad Setup</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-d62dda7e data-v-f1cced18><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-f1cced18><span class="text" data-v-f1cced18><!----><span data-v-f1cced18>Config</span><span class="vpi-chevron-down text-icon" data-v-f1cced18></span></span></button><div class="menu" data-v-f1cced18><div class="VPMenu" data-v-f1cced18 data-v-b71e5dd0><div class="items" data-v-b71e5dd0><!--[--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/configuration/swag-config" data-v-15160b25><!--[--><span data-v-15160b25>Swag Config</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/configuration/auth-config" data-v-15160b25><!--[--><span data-v-15160b25>Authelia Config</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/configuration/lldap-config" data-v-15160b25><!--[--><span data-v-15160b25>LLDAP Config</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/configuration/authy-duo-config" data-v-15160b25><!--[--><span data-v-15160b25>Authy/Duo Config</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup active" data-v-d62dda7e data-v-f1cced18><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-f1cced18><span class="text" data-v-f1cced18><!----><span data-v-f1cced18>Misc</span><span class="vpi-chevron-down text-icon" data-v-f1cced18></span></span></button><div class="menu" data-v-f1cced18><div class="VPMenu" data-v-f1cced18 data-v-b71e5dd0><div class="items" data-v-b71e5dd0><!--[--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link active" href="/x11-guide" data-v-15160b25><!--[--><span data-v-15160b25>X11 Guide</span><!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-b71e5dd0 data-v-15160b25><a class="VPLink link" href="/cf-tunnel" data-v-15160b25><!--[--><span data-v-15160b25>Cloudflare Tunneling</span><!--]--></a></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-8c74a6bf data-v-407d5c63><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="true" data-v-407d5c63 data-v-2994eab3 data-v-2ed556eb><span class="check" data-v-2ed556eb><span class="icon" data-v-2ed556eb><!--[--><span class="vpi-sun sun" data-v-2994eab3></span><span class="vpi-moon moon" data-v-2994eab3></span><!--]--></span></span></button></div><!----><div class="VPFlyout VPNavBarExtra extra" data-v-8c74a6bf data-v-d10923a3 data-v-f1cced18><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-f1cced18><span class="vpi-more-horizontal icon" data-v-f1cced18></span></button><div class="menu" data-v-f1cced18><div class="VPMenu" data-v-f1cced18 data-v-b71e5dd0><!----><!--[--><!--[--><!----><div class="group" data-v-d10923a3><div class="item appearance" data-v-d10923a3><p class="label" data-v-d10923a3>Appearance</p><div class="appearance-action" data-v-d10923a3><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="true" data-v-d10923a3 data-v-2994eab3 data-v-2ed556eb><span class="check" data-v-2ed556eb><span class="icon" data-v-2ed556eb><!--[--><span class="vpi-sun sun" data-v-2994eab3></span><span class="vpi-moon moon" data-v-2994eab3></span><!--]--></span></span></button></div></div></div><!----><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-8c74a6bf data-v-661d4f1a><span class="container" data-v-661d4f1a><span class="top" data-v-661d4f1a></span><span class="middle" data-v-661d4f1a></span><span class="bottom" data-v-661d4f1a></span></span></button></div></div></div></div><div class="divider" data-v-8c74a6bf><div class="divider-line" data-v-8c74a6bf></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-39b851b6 data-v-e758e1b7><div class="container" data-v-e758e1b7><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-e758e1b7><span class="vpi-align-left menu-icon" data-v-e758e1b7></span><span class="menu-text" data-v-e758e1b7>Menu</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-e758e1b7 data-v-ebf966df><button data-v-ebf966df>Return to top</button><!----></div></div></div><aside class="VPSidebar" data-v-39b851b6 data-v-6b9869d7><div class="curtain" data-v-6b9869d7></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-6b9869d7><span class="visually-hidden" id="sidebar-aria-label" data-v-6b9869d7> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-71286ee5><section class="VPSidebarItem level-0" data-v-71286ee5 data-v-877bfe94><!----><div class="items" data-v-877bfe94><!--[--><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/home" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>Legacy Instructions</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-71286ee5><section class="VPSidebarItem level-0 collapsible" data-v-71286ee5 data-v-877bfe94><div class="item" role="button" tabindex="0" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><h2 class="text" data-v-877bfe94>Configuration</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-877bfe94><span class="vpi-chevron-right caret-icon" data-v-877bfe94></span></div></div><div class="items" data-v-877bfe94><!--[--><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/configuration/auth-config" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>Authelia Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/configuration/authy-duo-config" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>DP-Salad Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/configuration/lldap-config" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>LLDAP Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/configuration/swag-config" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>Swag Config</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-71286ee5><section class="VPSidebarItem level-0 collapsible" data-v-71286ee5 data-v-877bfe94><div class="item" role="button" tabindex="0" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><h2 class="text" data-v-877bfe94>Install</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-877bfe94><span class="vpi-chevron-right caret-icon" data-v-877bfe94></span></div></div><div class="items" data-v-877bfe94><!--[--><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/install/dp-config" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>DP-Salad Configuration</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/install/dp-setup" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>DP-Salad Setup</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/install/requirements" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>DP-Salad Minimum Requirements</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/install/salad-setup" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>Salad Setup</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-71286ee5><section class="VPSidebarItem level-0 collapsible" data-v-71286ee5 data-v-877bfe94><div class="item" role="button" tabindex="0" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><h2 class="text" data-v-877bfe94>Maintenance</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-877bfe94><span class="vpi-chevron-right caret-icon" data-v-877bfe94></span></div></div><div class="items" data-v-877bfe94><!--[--><div class="VPSidebarItem level-1 is-link" data-v-877bfe94 data-v-877bfe94><div class="item" data-v-877bfe94><div class="indicator" data-v-877bfe94></div><a class="VPLink link link" href="/maintenance/maintain-guide" data-v-877bfe94><!--[--><p class="text" data-v-877bfe94>Maintenance of the DP-SALA/D Stack</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-39b851b6 data-v-cc09d6e0><div class="VPDoc has-sidebar has-aside" data-v-cc09d6e0 data-v-f87ade32><!--[--><!--]--><div class="container" data-v-f87ade32><div class="aside" data-v-f87ade32><div class="aside-curtain" data-v-f87ade32></div><div class="aside-container" data-v-f87ade32><div class="aside-content" data-v-f87ade32><div class="VPDocAside" data-v-f87ade32 data-v-c0d770e2><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-c0d770e2 data-v-154faa32><div class="content" data-v-154faa32><div class="outline-marker" data-v-154faa32></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-154faa32>On this page</div><ul class="VPDocOutlineItem root" data-v-154faa32 data-v-a993366b><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-c0d770e2></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-f87ade32><div class="content-container" data-v-f87ade32><!--[--><!--]--><main class="main" data-v-f87ade32><div style="position:relative;" class="vp-doc _x11-guide" data-v-f87ade32><div><h1 id="windows-setup" tabindex="-1">Windows Setup: <a class="header-anchor" href="#windows-setup" aria-label="Permalink to &quot;Windows Setup:&quot;">​</a></h1><h2 id="windows-x11-window-manager-client-server" tabindex="-1">Windows X11 Window Manager Client/Server <a class="header-anchor" href="#windows-x11-window-manager-client-server" aria-label="Permalink to &quot;Windows X11 Window Manager Client/Server&quot;">​</a></h2><p>Installation:</p><ol><li>Install <a href="https://sourceforge.net/projects/vcxsrv/" target="_blank" rel="noreferrer">VCXSRV</a> on your Windows machine.</li><li>Follow the install instructions until able to close.</li></ol><h3 id="running-the-x11-local-server-aka-the-client-that-connects-to-the-real-x11-server" tabindex="-1">Running the X11 Local Server (aka the client that connects to the real X11 server) <a class="header-anchor" href="#running-the-x11-local-server-aka-the-client-that-connects-to-the-real-x11-server" aria-label="Permalink to &quot;Running the X11 Local Server (aka the client that connects to the real X11 server)&quot;">​</a></h3><ol><li>Locate the newly installed XLaunch application, open it.</li><li>You&#39;ll want to modify the display settings as follows: <ul><li>Select <em>Multiple windows</em> for the program displays, hit next</li><li>Select the <em>Start no client</em> option on the next page, hit next.</li><li>Options on this page are optional, you <strong>DO NOT</strong> want the <em>Disable access control</em> selected on this page.</li><li>Hit next.</li><li>Click the <em>Save configuration</em> button on this page, save this config somewhere you won&#39;t forget about it.</li><li>Click finish.</li><li>Allow the access to the network if Windows Defender Firewall asks.</li><li>Congratulations, you&#39;ve setup the local X11 server!</li></ul></li><li>Make sure the XLaunch application is in the system tray before running Putty OR Terminal SSH</li></ol><h3 id="connecting-to-the-domain-tld-x11-server" tabindex="-1">Connecting to the &#39;domain.tld&#39; X11 Server <a class="header-anchor" href="#connecting-to-the-domain-tld-x11-server" aria-label="Permalink to &quot;Connecting to the &#39;domain.tld&#39; X11 Server&quot;">​</a></h3><ol><li>First, verify the XLaunch application is running in the System Tray, then follow the instructions below based on your preferred SSH method.</li></ol><h3 id="putty-instructions-including-setting-up-a-profile-for-easier-management" tabindex="-1">PuTTY Instructions (including setting up a profile for easier management) <a class="header-anchor" href="#putty-instructions-including-setting-up-a-profile-for-easier-management" aria-label="Permalink to &quot;PuTTY Instructions (including setting up a profile for easier management)&quot;">​</a></h3><ol><li>Highly recommend the use of a profile if you are going to use PuTTY, as you can save/load the config up really quick instead of having to put in these values every time.</li><li>Enter in the hostname, (this is optional if making a profile, as the IP address is dynamic)</li><li>In the connection category, under the data subcategory, the auto-login username can be set if using a profile.</li><li>Expand the SSH subcategory (in connection) and set the credentials if using a profile to the private key (if made)</li><li>Now, click on X11 subcategory (in connection) and click the checkbox for &#39;Enable X11 forwarding&#39;</li><li>Set the X Display Location textbox to the value &#39;127.0.0.1:0&#39; (no quotes).</li><li>Return to the Session category, and type in a name for the saved session, then hit the save button. Now, all of these changes can be loaded instead of put in each time.</li><li>Now, type in the IP address of the &#39;domain.tld&#39; and hit the &#39;Open&#39; button.</li><li>If you&#39;d like to verify the X11 connectivity, type &#39;xclock&#39; into the terminal. This will make a little analog clock appear in a separate window.</li></ol><h3 id="windows-powershell-instructions" tabindex="-1">Windows Powershell Instructions <a class="header-anchor" href="#windows-powershell-instructions" aria-label="Permalink to &quot;Windows Powershell Instructions&quot;">​</a></h3><ol><li>You&#39;ll want to set a variable in the command prompt, run <code>$env:DISPLAY=&quot;127.0.0.1:0&quot;</code> (exactly as written) to set the X Window Manager as the display output.</li><li>Use the command &#39;ssh -X username@domain.tld&#39; to connect, replacing username with your username, and domain.tld with the current dynIP.</li><li>If you&#39;d like to verify the X11 connectivity, type &#39;xclock&#39; into the terminal. This will make a little analog clock appear in a separate window.</li></ol><h3 id="windows-command-prompt-instructions-a-k-a-cmd" tabindex="-1">Windows Command Prompt Instructions (a.k.a. CMD) <a class="header-anchor" href="#windows-command-prompt-instructions-a-k-a-cmd" aria-label="Permalink to &quot;Windows Command Prompt Instructions (a.k.a. CMD)&quot;">​</a></h3><ol><li>You&#39;ll want to set a variable in the command prompt, run <code>set DISPLAY=127.0.0.1:0</code> to set the X Window Manager as the display output.</li><li>Use the command &#39;ssh -X username@domain.tld&#39; to connect, replacing username with your username, and domain.tld with the current dynIP.</li><li>If you&#39;d like to verify the X11 connectivity, type &#39;xclock&#39; into the terminal. This will make a little analog clock appear in a separate window.</li></ol><h1 id="macos-setup" tabindex="-1">MacOS Setup: <a class="header-anchor" href="#macos-setup" aria-label="Permalink to &quot;MacOS Setup:&quot;">​</a></h1><h2 id="macos-x11-window-manager-client-server" tabindex="-1">MacOS X11 Window Manager Client/Server <a class="header-anchor" href="#macos-x11-window-manager-client-server" aria-label="Permalink to &quot;MacOS X11 Window Manager Client/Server&quot;">​</a></h2><p>Installation:</p><ol><li>Install XQuartz (<a href="https://www.xquartz.org/" target="_blank" rel="noreferrer">https://www.xquartz.org/</a>) using the MacOS pkg file.</li><li>Follow the install instructions until able to close (you&#39;ll have to logout to complete install).</li></ol><h3 id="running-the-x11-local-server-on-mac-aka-the-client-that-connects-to-the-real-x11-server" tabindex="-1">Running the X11 Local Server on Mac (aka the client that connects to the real X11 server) <a class="header-anchor" href="#running-the-x11-local-server-on-mac-aka-the-client-that-connects-to-the-real-x11-server" aria-label="Permalink to &quot;Running the X11 Local Server on Mac (aka the client that connects to the real X11 server)&quot;">​</a></h3><ol><li>Locate the newly installed XQuartz application, open it, this opens an xtem window.</li><li>You&#39;ll want to use this window to connect over SSH.</li></ol><h3 id="connecting-to-the-domain-tld-x11-server-on-mac" tabindex="-1">Connecting to the &#39;domain.tld&#39; X11 Server on Mac <a class="header-anchor" href="#connecting-to-the-domain-tld-x11-server-on-mac" aria-label="Permalink to &quot;Connecting to the &#39;domain.tld&#39; X11 Server on Mac&quot;">​</a></h3><ol><li>Using the xterm window, run the command <code>set DISPLAY=127.0.0.1:0</code> to set the X11 forwarder to the correct display set.</li><li>Run the command &#39;ssh -X username@domain.tld&#39; where username is replaced by your username and domain.tld is replaced with the current IP address of the domain.tld server.</li><li>Run the &#39;xclock&#39; command to verify connectivity.</li></ol></div></div></main><footer class="VPDocFooter" data-v-f87ade32 data-v-a287ad5f><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-a287ad5f><span class="visually-hidden" id="doc-footer-aria-label" data-v-a287ad5f>Pager</span><div class="pager" data-v-a287ad5f><!----></div><div class="pager" data-v-a287ad5f><a class="VPLink link pager-link next" href="/home" data-v-a287ad5f><!--[--><span class="desc" data-v-a287ad5f>Next page</span><span class="title" data-v-a287ad5f>Legacy Instructions</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-39b851b6 data-v-ed47955f><div class="container" data-v-ed47955f><p class="message" data-v-ed47955f>Docs created by @ldez</p><p class="copyright" data-v-ed47955f>Copyright © 2024-present @Cdez</p></div></footer><!--[--><!--]--></div></div>
<script>window.__VP_HASH_MAP__=JSON.parse("{\"cf-tunnel.md\":\"DCFtN7s5\",\"changelog.md\":\"DF8BSN3_\",\"configuration_auth-config.md\":\"CWCNki4x\",\"configuration_authy-duo-config.md\":\"Czz1BBMP\",\"configuration_lldap-config.md\":\"r20NA1Ia\",\"configuration_swag-config.md\":\"DsoCqRQq\",\"docker-compose.md\":\"CiAGvlkZ\",\"faq.md\":\"By3ovNs1\",\"home.md\":\"DWjC1jWa\",\"index.md\":\"DDpI40D1\",\"install_dp-config.md\":\"Cllv2ZYA\",\"install_dp-setup.md\":\"Bx00pjFf\",\"install_requirements.md\":\"DnNTxVlB\",\"install_salad-setup.md\":\"uqD3xfuF\",\"maintenance_maintain-guide.md\":\"DC42-hYW\",\"x11-guide.md\":\"BPhK1sNP\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"DP-Salad\",\"description\":\"A guide to fully deploy the DP-Salad Stack\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":\"dark\",\"themeConfig\":{\"logo\":\"/saladicon.png\",\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"FAQ\",\"link\":\"/faq\"},{\"text\":\"Docker Compose\",\"link\":\"/docker-compose\"},{\"text\":\"Maintenance\",\"link\":\"/maintenance/maintain-guide\"},{\"text\":\"Install\",\"items\":[{\"text\":\"DP-Salad Requirements\",\"link\":\"/install/requirements\"},{\"text\":\"Installing Debian and Portainer\",\"link\":\"/install/dp-setup\"},{\"text\":\"Configuration\",\"link\":\"/install/dp-config\"},{\"text\":\"DP-Salad Setup\",\"link\":\"/install/salad-setup\"}]},{\"text\":\"Config\",\"items\":[{\"text\":\"Swag Config\",\"link\":\"/configuration/swag-config\"},{\"text\":\"Authelia Config\",\"link\":\"/configuration/auth-config\"},{\"text\":\"LLDAP Config\",\"link\":\"/configuration/lldap-config\"},{\"text\":\"Authy/Duo Config\",\"link\":\"/configuration/authy-duo-config\"}]},{\"text\":\"Misc\",\"items\":[{\"text\":\"X11 Guide\",\"link\":\"/x11-guide\"},{\"text\":\"Cloudflare Tunneling\",\"link\":\"/cf-tunnel\"}]}],\"sidebar\":[{\"text\":\"Legacy Instructions\",\"link\":\"/home\"},{\"text\":\"Configuration\",\"items\":[{\"text\":\"Authelia Configuration\",\"link\":\"/configuration/auth-config\"},{\"text\":\"DP-Salad Configuration\",\"link\":\"/configuration/authy-duo-config\"},{\"text\":\"LLDAP Configuration\",\"link\":\"/configuration/lldap-config\"},{\"text\":\"Swag Config\",\"link\":\"/configuration/swag-config\"}],\"collapsed\":false},{\"text\":\"Install\",\"items\":[{\"text\":\"DP-Salad Configuration\",\"link\":\"/install/dp-config\"},{\"text\":\"DP-Salad Setup\",\"link\":\"/install/dp-setup\"},{\"text\":\"DP-Salad Minimum Requirements\",\"link\":\"/install/requirements\"},{\"text\":\"Salad Setup\",\"link\":\"/install/salad-setup\"}],\"collapsed\":false},{\"text\":\"Maintenance\",\"items\":[{\"text\":\"Maintenance of the DP-SALA/D Stack\",\"link\":\"/maintenance/maintain-guide\"}],\"collapsed\":false}],\"search\":{\"provider\":\"local\"},\"footer\":{\"message\":\"Docs created by @ldez\",\"copyright\":\"Copyright © 2024-present @Cdez\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":true}");</script>
</body>
</html>