|
| 1 | +<?xml version="1.0" encoding="UTF-8"?> |
| 2 | +<!DOCTYPE topic |
| 3 | +[ |
| 4 | + <!ENTITY % entities SYSTEM "../common/generic-entities.ent"> |
| 5 | + %entities; |
| 6 | +]> |
| 7 | +<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> --> |
| 8 | +<!-- point back to this document with a similar comment added to your legacy doc piece --> |
| 9 | +<!-- refer to README.md for file and id naming conventions --> |
| 10 | +<!-- metadata is dealt with on the assembly level --> |
| 11 | +<topic xml:id="concept-cockpit-applications" |
| 12 | + role="concept" xml:lang="en" |
| 13 | + xmlns="http://docbook.org/ns/docbook" version="5.2" |
| 14 | + xmlns:its="http://www.w3.org/2005/11/its" |
| 15 | + xmlns:xi="http://www.w3.org/2001/XInclude" |
| 16 | + xmlns:xlink="http://www.w3.org/1999/xlink" |
| 17 | + xmlns:trans="http://docbook.org/ns/transclusion"> |
| 18 | + <info> <title>Managing applications in &cockpit;</title> <meta name="maintainer" content="shalaka.harne@suse.com" its:translate="no"/> <abstract> <para>The &cockpit; Web interface supports modularity through plug-in applications. This section describes how to view, navigate and remove these applications using the <guilabel>Applications</guilabel> page. </para> </abstract> </info> |
| 19 | +<para>&cockpit; applications (or modules) extend the functionality of the Web interface. Adding an application creates a new entry in the sidebar, allowing you to manage complex system services—such as firewalls, virtual machines or SELinux—through a visual interface rather than the command line.</para> |
| 20 | + <para>Commonly installed modules include: <guimenu>Networking</guimenu>, <guimenu>Software Updates (Packages)</guimenu>, <guimenu>Repositories</guimenu> and <guimenu>SELinux</guimenu>.</para> |
| 21 | +<section><title>Viewing and navigating applications</title> |
| 22 | +<para>You can access your installed modules by clicking the <guimenu>Applications</guimenu> tab in the left-hand navigation pane and clicking the application's name to switch to its dedicated management tab. To uninstall a module, locate the application in the list and click the <guimenu>Remove</guimenu> button.</para> |
| 23 | +</section> |
| 24 | +<section><title>Troubleshooting missing applications</title> |
| 25 | +<para>If the <guilabel>Applications</guilabel> page is empty, or if a newly installed module does not appear in the list, you may need to refresh the &cockpit; service.</para> |
| 26 | +<para>Restart the socket: Run the following command in your terminal: </para> |
| 27 | + <screen>&prompt.sudo; systemctl restart cockpit.socket</screen> |
| 28 | +<para>Check for service failures: If a specific service fails to start, the <guilabel>Applications</guilabel> page will display the relevant systemd error logs directly on the screen to assist with debugging.</para> |
| 29 | +</section></topic> |
0 commit comments