1 line
7.7 KiB
JavaScript
1 line
7.7 KiB
JavaScript
import{_ as t,c as a,a3 as n,o as i}from"./chunks/framework.DtMx7FFi.js";const m=JSON.parse('{"title":"X11-Guide","description":"","frontmatter":{"title":"X11-Guide"},"headers":[],"relativePath":"x11-guide.md","filePath":"x11-guide.md"}'),o={name:"x11-guide.md"};function l(r,e,s,c,h,d){return i(),a("div",null,e[0]||(e[0]=[n('<h1 id="windows-setup" tabindex="-1">Windows Setup: <a class="header-anchor" href="#windows-setup" aria-label="Permalink to "Windows Setup:""></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 "Windows X11 Window Manager Client/Server""></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 "Running the X11 Local Server (aka the client that connects to the real X11 server)""></a></h3><ol><li>Locate the newly installed XLaunch application, open it.</li><li>You'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'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'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 'domain.tld' X11 Server <a class="header-anchor" href="#connecting-to-the-domain-tld-x11-server" aria-label="Permalink to "Connecting to the 'domain.tld' X11 Server""></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 "PuTTY Instructions (including setting up a profile for easier management)""></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 'Enable X11 forwarding'</li><li>Set the X Display Location textbox to the value '127.0.0.1:0' (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 'domain.tld' and hit the 'Open' button.</li><li>If you'd like to verify the X11 connectivity, type 'xclock' 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 "Windows Powershell Instructions""></a></h3><ol><li>You'll want to set a variable in the command prompt, run <code>$env:DISPLAY="127.0.0.1:0"</code> (exactly as written) to set the X Window Manager as the display output.</li><li>Use the command 'ssh -X username@domain.tld' to connect, replacing username with your username, and domain.tld with the current dynIP.</li><li>If you'd like to verify the X11 connectivity, type 'xclock' 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 "Windows Command Prompt Instructions (a.k.a. CMD)""></a></h3><ol><li>You'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 'ssh -X username@domain.tld' to connect, replacing username with your username, and domain.tld with the current dynIP.</li><li>If you'd like to verify the X11 connectivity, type 'xclock' 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 "MacOS Setup:""></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 "MacOS X11 Window Manager Client/Server""></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'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 "Running the X11 Local Server on Mac (aka the client that connects to the real X11 server)""></a></h3><ol><li>Locate the newly installed XQuartz application, open it, this opens an xtem window.</li><li>You'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 'domain.tld' X11 Server on Mac <a class="header-anchor" href="#connecting-to-the-domain-tld-x11-server-on-mac" aria-label="Permalink to "Connecting to the 'domain.tld' X11 Server on Mac""></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 'ssh -X username@domain.tld' 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 'xclock' command to verify connectivity.</li></ol>',22)]))}const p=t(o,[["render",l]]);export{m as __pageData,p as default};
|