Skip to content

Apps

Apps lists the apps installed on the node. The core apps installed during setup are always there; every other app is installed from the App center.

The Apps page

For each app, the list shows its name and addresses, how much CPU, RAM and network it uses, how much space its data and its snapshots take up, and its state: how many of its containers are running, green when all of them are, yellow when only some are, and red when none are. The icon next to the snapshots figure says whether the app’s snapshots are enabled, paused or disabled. Select an address to open the app. Sort the list by name or by any of the figures with the arrows in the column headers, and use Search to find an app by its name or address.

Narrow the list down with the filter button next to Search: Status for whether the app is running, partly running or stopped, Updates for whether an update is available, Snapshots for whether its snapshots are enabled, paused or disabled, and Category. A choice in use turns blue and the button counts the filters in use. Reset filters removes them all.

Filtering the apps by status

Select App center. Explore lists the apps you can install, and Installed the ones already on the node.

The App center

Select Install on an app. The form describes the app, shows any note that comes with it, such as a port to forward on your router, and asks for the settings it needs. Domain is filled in with the node’s domain, and the app is reached at its own name under it, for example nextcloud.virgo.univrs.cloud.

Installing Nextcloud

With a domain of your own, you also choose the app’s HTTPS certificate, starting from the one the node uses:

  • Let’s Encrypt: when the domain’s DNS points to your network and port 80 is forwarded to the node. Browsers trust it everywhere.
  • Self-signed: when port 80 is not forwarded, for example when the node is only used on your local network or is behind CGNAT. Browsers warn about it until you accept it.

Installing Nextcloud with a domain of your own

While the app installs, its card shows Installing…. The node makes room for the app’s data in the storage pool, downloads the app and starts it, and the app then appears in the list.

Nextcloud installing

Open an app’s menu in the list, or use the buttons at the top of its details:

An app’s menu

  • Update: when an update is available, bring the app up to date. See Updating an app.
  • Start, Restart and Stop: start, restart or stop all of the app’s containers.
  • Kill: stop the app at once, without giving it time to shut down properly.
  • Recreate: rebuild the app’s containers from its template in the App center, keeping its settings and data.
  • Uninstall: remove the app. Its data stays in the storage pool, and installing the app again picks it back up.

The core apps cannot be stopped, killed or uninstalled, because the node needs them.

While an action is running, a spinning gear takes the place of the menu.

The node checks for app updates every day at midnight. When one is available, a green download badge appears next to the app’s name. Select Update in its menu.

A notification follows the update while a spinning gear takes the place of the app’s menu. The node fetches the app’s latest template, downloads the new version of each of its containers, and restarts the app on it.

Nextcloud updating

When the update finishes, the notification says so and the badge disappears. The app keeps its settings and data.

Before updating, the node takes a snapshot of the app. If the new version does not work out, roll back to it.

Nextcloud updated

Select an app to open its details. Services shows the app’s containers, and Snapshots its snapshots, with how many of each there are.

Nextcloud’s details

Each container is listed with its image, the folders it mounts, its network addresses and ports, and how much CPU, RAM and network it uses. The dot on its icon is green while it runs, and its name shows how long it has been up since it last started. Hover over a badge for more, such as where each folder is mounted from. Each container can be started, restarted, stopped or killed on its own, with the buttons at the end of its row.

Select Logs on a container to see its last 200 lines of output, followed by new lines as they come in.

A container’s logs

Select Terminal on a running container to open a command line inside it. Anything you change there outside the app’s data is lost when the app is recreated or updated.

A terminal in a container