ldez/dp-salad-docs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

init

Browse source
This commit is contained in:
ld3zian 2025-01-04 22:46:09 -07:00
commit f79ed7c8e4
111 changed files with 14931 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

74
x11-guide.md Normal file
View file

@ -0,0 +1,74 @@
---
title: X11-Guide
---
# Windows Setup:
## Windows X11 Window Manager Client/Server
Installation:
1. Install [VCXSRV](https://sourceforge.net/projects/vcxsrv/) on your Windows machine.
2. Follow the install instructions until able to close.
### Running the X11 Local Server (aka the client that connects to the real X11 server)
1. Locate the newly installed XLaunch application, open it.
2. You'll want to modify the display settings as follows:
- Select *Multiple windows* for the program displays, hit next
- Select the *Start no client* option on the next page, hit next.
- Options on this page are optional, you **DO NOT** want the *Disable access control* selected on this page.
- Hit next.
- Click the *Save configuration* button on this page, save this config somewhere you won't forget about it.
- Click finish.
- Allow the access to the network if Windows Defender Firewall asks.
- Congratulations, you've setup the local X11 server!
3. Make sure the XLaunch application is in the system tray before running Putty OR Terminal SSH
### Connecting to the 'domain.tld' X11 Server
1. First, verify the XLaunch application is running in the System Tray, then follow the instructions below based on your preferred SSH method.
### PuTTY Instructions (including setting up a profile for easier management)
1. 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.
2. Enter in the hostname, (this is optional if making a profile, as the IP address is dynamic)
3. In the connection category, under the data subcategory, the auto-login username can be set if using a profile.
4. Expand the SSH subcategory (in connection) and set the credentials if using a profile to the private key (if made)
5. Now, click on X11 subcategory (in connection) and click the checkbox for 'Enable X11 forwarding'
6. Set the X Display Location textbox to the value '127.0.0.1:0' (no quotes).
7. 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.
8. Now, type in the IP address of the 'domain.tld' and hit the 'Open' button.
9. 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.
### Windows Powershell Instructions
1. You'll want to set a variable in the command prompt, run `$env:DISPLAY="127.0.0.1:0"` (exactly as written) to set the X Window Manager as the display output.
2. Use the command 'ssh -X username@domain.tld' to connect, replacing username with your username, and domain.tld with the current dynIP.
3. 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.
### Windows Command Prompt Instructions (a.k.a. CMD)
1. You'll want to set a variable in the command prompt, run `set DISPLAY=127.0.0.1:0` to set the X Window Manager as the display output.
2. Use the command 'ssh -X username@domain.tld' to connect, replacing username with your username, and domain.tld with the current dynIP.
3. 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.
# MacOS Setup:
## MacOS X11 Window Manager Client/Server
Installation:
1. Install XQuartz ([https://www.xquartz.org/](https://www.xquartz.org/)) using the MacOS pkg file.
2. Follow the install instructions until able to close (you'll have to logout to complete install).
### Running the X11 Local Server on Mac (aka the client that connects to the real X11 server)
1. Locate the newly installed XQuartz application, open it, this opens an xtem window.
2. You'll want to use this window to connect over SSH.
### Connecting to the 'domain.tld' X11 Server on Mac
1. Using the xterm window, run the command `set DISPLAY=127.0.0.1:0` to set the X11 forwarder to the correct display set.
2. 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.
3. Run the 'xclock' command to verify connectivity.