diff --git a/docs/tech_docs/linux/XFCE_alpine.md b/docs/tech_docs/linux/XFCE_alpine.md new file mode 100644 index 0000000..c052919 --- /dev/null +++ b/docs/tech_docs/linux/XFCE_alpine.md @@ -0,0 +1,73 @@ +Certainly! Here’s a concise step-by-step guide to setting up the XFCE desktop environment on your Alpine Linux system running in a Proxmox container. This guide will cover everything from updating your system to launching XFCE. + +### Step-by-Step Setup Guide for XFCE on Alpine Linux in Proxmox + +#### Step 1: Update System +Ensure your system is up-to-date. +```bash +apk update +apk upgrade +``` + +#### Step 2: Enable Community Repository +Ensure the community repository is enabled for a wider package selection. +```bash +sed -i '/^#.*community/s/^#//' /etc/apk/repositories +apk update +``` + +#### Step 3: Install Xorg and Related Packages +Install the Xorg server, a generic video driver, and the necessary input drivers. +```bash +apk add xorg-server xf86-video-vesa dbus +apk add xf86-input-evdev +apk add xf86-input-libinput # It's generally recommended for modern setups. +``` + +#### Step 4: Install XFCE +Install XFCE and its terminal for a functional desktop environment. +```bash +apk add xfce4 xfce4-terminal +``` + +#### Step 5: Configure the X Server (Optional) +Auto-configure Xorg if needed. This is typically not necessary as Xorg can auto-detect most settings, but it’s available if you encounter issues. +```bash +Xorg -configure +mv /root/xorg.conf.new /etc/X11/xorg.conf # Only if necessary +``` + +#### Step 6: Set Up Desktop Environment +Set up the `.xinitrc` file to start XFCE with `startx`. +```bash +echo "exec startxfce4" > ~/.xinitrc +``` + +#### Step 7: Start the XFCE Desktop +Run `startx` from a non-root user account to start your desktop environment. +```bash +startx +``` + +### Additional Configuration + +#### Ensure D-Bus is Running +D-Bus must be active for many desktop components to function correctly. +```bash +rc-update add dbus +service dbus start +``` + +### Troubleshooting Tips +- If you encounter issues starting the GUI, check the Xorg log: + ```bash + cat /var/log/Xorg.0.log + ``` +- Verify that you are not trying to run the GUI as the root user. Instead, create a new user and use that account to start the GUI: + ```bash + adduser myuser + su - myuser + startx + ``` + +This guide provides a comprehensive overview of installing and configuring XFCE on Alpine Linux in a Proxmox container, focusing on ensuring a smooth setup process and addressing common pitfalls with appropriate troubleshooting steps. \ No newline at end of file