Software center#
The Software Center displays and manages applications available from all configured repositories [1].
Application information#
Each application is represented by a card displaying its name, level of certification, and category. Click on the application’s name to view detailed information such as screenshots, author, latest version, container images, and links to documentation, source code, and bug tracker.
Some applications may include additional Terms and Conditions; if present, read them carefully.
Levels of certification#
Applications are certified at the following levels:
Level 1/5: The application is hosted by a custom repository and is not certified.
Level 2/5: The application is hosted by the
nethforge
repository and certified by the NethServer community.Level 3/5: The application is hosted by the
default
orsubscription
repositories and is certified by Nethesis.Level 4/5: The application is developed and maintained by Nethesis developers.
Level 5/5: The application is developed and maintained by Nethesis developers and is covered by Nethesis support.
Certification levels are determined based on the following factors:
Repository: To be listed in a public repository, an application must undergo a review process. Being listed in a public repository establishes the base certification level of the application.
Origin: The container image registry hosting the application identifies the person or organization distributing it. Currently, the recognized registries are
ghcr.io/nethserver
andghcr.io/nethesis
.Support: If the cluster has an active subscription and paid support is available for the application (whether included in the current subscription plan or not). See Subscription for more information.
Install applications#
To install a new application, simply click the Install button of the application card. If your cluster has multiple nodes, you will also need to select the target node.
To install an additional instance of an existing application, click on the
Instances
link within the application’s card. Then, select
Install new instance. Note that in some cases, installation on
certain cluster nodes may be restricted due to application policies or
node resource limitations.
Application instances#
Once an application has one or more installed instances, click on the
Instances
link within the application’s card. You can perform various
actions on each instance by clicking on its three-dots menu:
Add to favorites
: The application will always be listed at the top of the application drawer.Edit instance label
: Add a custom name to the instance.Clone
: Clone the application. See Clone and move applications.Move
: Move the application to another node. See Clone and move applications.Uninstall
: Remove the application and all related data.
Installed application instances are also accessible from the application drawer by clicking on the menu in the top-right corner of the screen.
Software repositories#
An NS8 software repository is an index of applications and a collection of their metadata.
You can access the list of configured repositories in several ways:
In the
Settings
page: click theSoftware repositories
card.In the
Software Center
page: click theSoftware repositories
item in the three-dots menu at the top-right corner.
NS8 includes a default set of software repositories, some enabled and others disabled:
default
: Contains applications developed and maintained mainly by NethServer developers. It also tracks updates for NS8 core modules and the core itself.nethforge
: A repository of applications built and maintained by the NethServer community. It is initially disabled.subscription
: Added and enabled when the cluster has an active subscription. It overrides the contents of thedefault
repository with an update schedule managed by Nethesis. See Subscription for details.
To add a custom repository, click on the Add repository button and fill in the required fields:
Name
: A unique name for the repository.URL
: The public URL of the repository. It must be a valid NS8 repository.Status
: Check this option to enable the repository.
You can refresh the metadata by clicking on the Reload repositories button.
Core applications#
NS8 consists of the core and several applications. Each core component has its own version number, and the Software Center will display a warning when an update is available.
You can review the components currently installed in the cluster at any
time. To do this, click on the three-dots menu in the top-right corner of
the Software Center
page, then select the Core apps
option.
Footnotes