<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="install-guest-tools" xml:lang="es">
  <info>
    <revision version="0.1" date="2022-03-29" status="candidate"/>
    <link type="guide" xref="index#use"/>

    <credit type="author copyright">
      <name>Felipe Borges</name>
      <email>felipeborges@gnome.org</email>
      <years>2022</years>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Enable additional integrations with your box.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Daniel Mustieles</mal:name>
      <mal:email>daniel.mustieles@gmail.com</mal:email>
      <mal:years>2014 - 2022</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rodrigo Lledó</mal:name>
      <mal:email>rodhos92@gmail.com</mal:email>
      <mal:years>2019, 2021</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alex Puchades</mal:name>
      <mal:email>alex94puchades@gmail.com</mal:email>
      <mal:years>2015</mal:years>
    </mal:credit>
  </info>

  <title>Install guest tools</title>

  <p>Guest tools are a collection of drivers and utilities that improve the usability of your virtual machine. It provides improved input performance, automatic screen resolution adjustment, shared clipboard, and file transfer.</p>

  <section id="installing-on-windows">
    <title>Installing on Windows virtual machines</title>

    <p>Visit <link href="https://win.gnomeboxes.org">win.gnomeboxes.org</link> in your Windows virtual machine to download and install the <app>spice-guest-tools</app> application, which provides the guest integration for GNOME Boxes.</p>
  </section>

  <section id="installing-on-linux">
    <title>Installing on Linux virtual machines</title>

    <p>Most popular Linux distributions package the guest tools as <app>spice-vdagent</app>.</p>

    <p>The spice agent for Linux consists of 2 parts, a daemon <app>spice-vdagentd</app> and
       a per X-session process <app>spice-vdagent</app>. The daemon gets started in Spice guests
       through a Sys-V initscript or a systemd unit. The per X-session gets
       automatically started in desktop environments which honor <file>/etc/xdg/autostart</file>,
       and under <app>gdm</app>.</p>

    <section id="installing-on-rpm">
      <title>Installing on RPM based distributions</title>

      <p>Distributions such as Fedora, Red Hat Enterprise Linux, CentOS Stream, OpenSUSE, are known to provide <app>spice-vdagent</app> in their repositories.</p>

      <screen>sudo dnf install spice-vdagent</screen>
    </section>

    <section id="installing-on-deb">
      <title>Installing on Deb based distributions</title>

      <p>Distributions such as Ubuntu, Debian, Linux Mint are known to provide <app>spice-vdagent</app> in their repositories.</p>

      <screen>sudo apt install spice-vdagent</screen>
    </section>
  </section>
</page>
