<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" style="task"
      id="extensions-enable">

  <info>
    <link type="guide" xref="software#extension" />
    <link type="seealso" xref="extensions-lockdown" />
    <link type="seealso" xref="extensions" />
    <revision pkgversion="3.30" date="2019-02-08" status="review"/>

    <credit type="author copyright">
      <name>Petr Kovar</name>
      <email>pknbe@volny.cz</email>
      <years>2014</years>
    </credit>
    <credit type="author">
      <name>Jana Svarova</name>
      <email>jana.svarova@gmail.com</email>
   </credit>

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

    <desc>Enable GNOME Shell extensions for all users.</desc>
  </info>

  <title>Enable machine-wide extensions</title>
  
  <p>To make extensions available to all users on the system, install them in
  the <file>/usr/share/gnome-shell/extensions</file> directory. Note that
  newly-installed machine-wide extensions are disabled by default.</p>

  <p>You need to set the <code>org.gnome.shell.enabled-extensions</code> key in
  order to set the default enabled extensions. However, there is currently no
  way to enable additional extensions for users who have already logged in. This
  does not apply for existing users who have installed and enabled their own
  GNOME extensions.</p>

  <steps>
    <title>Setting the org.gnome.shell.enabled-extensions key</title>
    <item>
      <p>Create a <code>user</code> profile in
      <file>/etc/dconf/profile/user</file>:</p>
      <listing>
        <code>
user-db:user
system-db:local
</code>
      </listing>
    </item>
    <item>
      <p>Create a <code>local</code> database for machine-wide settings in
      <file>/etc/dconf/db/local.d/00-extensions</file>:</p>
      <listing>
        <code>
[org/gnome/shell]
# List all extensions that you want to have enabled for all users
enabled-extensions=['<input>myextension1@myname.example.com</input>', '<input>myextension2@myname.example.com</input>']
</code>
      </listing>
      <p>The <code>enabled-extensions</code> key specifies the enabled
      extensions using the extensions’ uuid
      (<code>myextension1@myname.example.com</code> and
      <code>myextension2@myname.example.com</code>).</p>
    </item>
    <include href="dconf-snippets.xml"
      xpointer="xpointer(/*/*[@xml:id='dconf-update'])"
      xmlns="http://www.w3.org/2001/XInclude"/>
  </steps>

</page>