Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
start [2019/02/10 23:07] – [By component] alexxconsstart [2020/12/27 08:02] – Xfce GIT master VM images Quick Start Guide m4u9
Line 1: Line 1:
-===== Welcome to the Xfce Developer Wiki =====+{{ :xfce-64x64.png?nolink|}}
  
-The place to store Xfce related information which is not appropriate for [[https://docs.xfce.org/start|docs.xfce.org]].+===Introduction=== 
 +This page is meant as guide for the use of Virtual Machine images created for Xfce developers and users who wish to test and preview the latest builds of Xfce coming from GIT Master branch. The images are based on openSUSE Xfce RAT, which is the [https://build.opensuse.org/project/show/X11:xfce:rat Xfce Development OBS Repository for Tumbleweed.] The build process is fully automated and happens regularly giving users qcow2 disk images with Xfce's latest builds based on openSUSE's rolling release Tumbleweed.
  
-Rule of thumb: Everything you would put into a man page should go to docs.xfce.org. Remaining stuff goes here.+Currently there are qcow2 images for KVM & Xen but support for Virtual Box, VMware and Vagrant are in the works.
  
-Caution: Everything you find here may, or may not be verified.+The "vanilla" disk image ships Xfce completely unmodified from Git sources and without any openSUSE visual tweakings. This gives Xfce devs (and testers alike) who want to build and test software inside a complete Xfce environment the most convenient way to do so. 
 + 
 + 
 +===Download=== 
 + 
 +* [https://download.opensuse.org/repositories/X11:/xfce:/rat:/images:/upstream/images/ KVM & Xen image "vanilla" version] 
 + 
 + 
 +===Setup with GNOME Boxes=== 
 +Once downloaded, these qcow2 can be used "out of the box". The most convenient way is to import them in '''gnome-boxes''' aka Boxes, which is a simple application for managing virtual machines through QEMU, KVM and libvirt. Boxes imports and boot the images easily and focuses on getting things working out of the box with very little input from user. 
 +Read more about it on their [https://wiki.gnome.org/Apps/Boxes website]. 
 +<gallery perrow=4> 
 +File:Gnome-boxes-create-vm.png|1. Create Virtual Machine 
 +File:Gnome-boxes-select-image.png|2. Select "Operating System Image File" 
 +File:Gnome-boxes-select-image2.png|3. Browse Downloaded Image 
 +File:Gnome-boxes-review-and-create.png|4. Costumize Memory and Create 
 +</gallery> 
 + 
 +===First Boot=== 
 +When these images are imported they can be launched and a "first time boot" wizard will guide you through a basic setup. 
 +<gallery perrow=4> 
 +File:gnome-boxes-running.png|1. Open Newly Created Virtual Machine 
 +File:gnome-boxes-grub.png|2. Boot from Grub 
 +File:gnome-boxes-first-boot-wizard.png|3. Follow the First Boot Setup Steps 
 +File:gnome-boxes-loaded-opensuse.png|4. Have a lot of fun! 
 +</gallery> 
 + 
 + 
 +===Maintenance=== 
 +Once inside the guest virtual machine up and running, you can maintain the setup and update it like a regular Tumbleweed system by running the following command in a terminal. 
 +<pre>sudo zypper dup</pre> 
 + 
 +This command will fetch all the latest packages from both the Tumbleweed distribution and OBS [https://build.opensuse.org/project/show/X11:xfce:rat X11:xfce:rat] repo. 
 + 
 +===Building from sources=== 
 +Although Xfce components come in pre-compiled packages regularly updated, it is possible to build directly from source code. Fetching all the necessary dependencies can be easily achieved by the commands <code>zypper source-install</code> or <code>zypper si</code> followed by package name. 
 +Example: 
 + 
 +<pre>sudo zypper si libxfce4ui</pre> 
 + 
 +The command above fetches all the dependencies needed to build libxfce4ui. Other commands and examples for the Zypper package manager can also be found in this [https://en.opensuse.org/images/1/17/Zypper-cheat-sheet-1.pdf cheat-sheet.] 
 + 
 + 
 +===Alternatives to Boxes === 
 +While Boxes is the easiest way there are of course quite a few others like virt-manager, virt-install or Cockpit Web console. All of them are expected to work like any other solution supporting qcow disk images.
  
 ===== General =====  ===== General ===== 
   * [[API Documentation]]   * [[API Documentation]]
   * [[related_websites|Xfce Related Websites]]   * [[related_websites|Xfce Related Websites]]
-  * [[howto|How to pages]] +  * [[howto|How-to Pages]] 
-  * [[tips|Tips & tricks]]+  * [[tips|Tips & Tricks]]
   * [[events|Events related to Xfce]]   * [[events|Events related to Xfce]]
-  * [[bugzilla-reports|Bugzilla Charts]]+  * [[testing/xfce-test | Xfce-Test Docker Container Quick Start Guide]]
   * [[http://www.xfce.org/about/releasemodel|Release Model]]   * [[http://www.xfce.org/about/releasemodel|Release Model]]
   * [[http://www.xfce.org/download/building|Building Xfce]]   * [[http://www.xfce.org/download/building|Building Xfce]]
 +  * [[https://docs.xfce.org/contribute/bugs/bug-summary|Open Bug Summary]]
   * [[https://docs.xfce.org/contribute/start| Information for new contributors]]   * [[https://docs.xfce.org/contribute/start| Information for new contributors]]
 +
 +----
 +
 =====  Release Specific =====  =====  Release Specific ===== 
  
 +  * [[releng:4.16:roadmap|Xfce 4.16 - Schedule, Status and Roadmaps]]
   * [[releng:4.14:roadmap|Xfce 4.14 - Schedule, Status and Roadmaps]]   * [[releng:4.14:roadmap|Xfce 4.14 - Schedule, Status and Roadmaps]]
   * [[releng:4.12:roadmap|Xfce 4.12 ]]   * [[releng:4.12:roadmap|Xfce 4.12 ]]
Line 25: Line 75:
   * [[releng:4.6:start|Xfce 4.6]]   * [[releng:4.6:start|Xfce 4.6]]
  
 +----
  
 =====  By component =====  =====  By component ===== 
   * [[thunar:dev|thunar]]   * [[thunar:dev|thunar]]
 +  * [[thunarx-python|thunarx-python]]
 +  * [[vala-bindings|Vala bindings]]
   * [[xfce4-panel:dev|xfce4-panel]]   * [[xfce4-panel:dev|xfce4-panel]]
   * [[xfce4-power-manager:dev|xfce4-power-manager]]   * [[xfce4-power-manager:dev|xfce4-power-manager]]
-  * [[xfce4-session:dev|xfce4-session]]+  * [[:apps:xfce4-screensaver:configuration:|Screensaver Utility (xfce4-screensaver)]] 
 +  * [[mousepad:dev|mousepad]] 
 + 
 +---- 
 =====  Special Interest Groups =====  =====  Special Interest Groups ===== 
  
Line 36: Line 93:
   * [[sig_germany:start|German Xfce Promoters]]   * [[sig_germany:start|German Xfce Promoters]]
  
-[[graveyard|old, unused Wiki pages]]+---- 
 + 
 +===== Projects ===== 
 +  * [[projects:goodies-decomm:start| Migration and Decommissioning of goodies.xfce.org]] 
 + 
 +---- 
 + 
 +[[graveyard|Old, unused Wiki pages]] 
 + 
 + 
 +[[|Back to Top]]