74 lines
4.2 KiB
Markdown
74 lines
4.2 KiB
Markdown
---
|
|
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.
|