Pangolin for Omarchy: connections from your desktop

Other languages: Deutsch · Français

Is the connection to your private network active? Where was that service link? With omarchy-pangolin, you can check from the Omarchy desktop. My community plugin brings connection status and the resources of your active Pangolin account into a small panel.

You can connect or disconnect there, open web services, and copy addresses. For a service you use frequently, you can install a web app or open an existing matching app. The panel follows your current Omarchy theme. Feature overview

Who it is for

The plugin is for people who use Omarchy as their desktop and Pangolin to reach their own services or resources shared with them. It is particularly useful when you regularly switch between applications: a document archive, a dashboard, or an internal development environment. These are possible uses, not built-in integrations with those applications.

If you run a homelab, you probably already know your services and their addresses. You may still want to open them without looking up a URL each time. The panel lists the resources your Pangolin account is allowed to use. Frequently used web services can be installed as web apps and opened in their own windows.

You can also use it as a member of a small team without running any servers yourself. You need a compatible Omarchy desktop and resources granted to you by the administrator. Pangolin determines which services are available and who can access them. The plugin brings those resources to your workstation; it does not grant additional permissions. Access model and overview

Two everyday examples

Reaching your services from a laptop

Suppose you want to open your self-hosted document archive while away from home. If it is configured as a public web resource in Pangolin, you can open its link from the panel. The service’s authentication and access controls still apply. This browser access does not necessarily require the same private client connection as an internal resource.

For a target on a private network, you first check the connection status and connect Pangolin if necessary, then open the configured service. That distinction matters: reaching a web portal does not establish that you can also reach a private host. The project documentation explains both access paths.

Keeping a development environment close at hand

A team could share an internal preview of its web application as a resource. If you open that preview several times a day, you can install it as a web app from the resource menu. The plugin can open an existing matching app too. This saves switching between a bookmark list and the terminal each time.

A host resource might not be a website at all. In that case, copying its address lets you use it in the appropriate tool. An allowed TCP port alone does not tell the plugin whether to use HTTP or HTTPS. Opening it in a browser may require an explicit URL or protocol setting. Opening and configuring resources

What the status tells you

Green means the connection is confirmed. Orange covers states such as an unknown or pending connection and warnings; red indicates disconnection or an error. Gentle motion runs only while the panel is open and a fresh connection has been confirmed. It stops when that status is lost. Controls and status display

The indicator describes the local connection. It is not a health check for every application behind it. A service can be stopped while the tunnel is connected. An HTTPS diagnostic also does not prove UDP connectivity or that an application works. Diagnostic limits

Web links and private network resources have different requirements. Private resources need an active Pangolin connection and working alias DNS. A host address alone does not mean there is a web service behind it. You can supply a full URL or a known scheme for such resources. Configuration

Before you start

The plugin requires Omarchy Quattro with the matching Quickshell plugin API, Python 3.10 or newer, and the Pangolin CLI with a readable local OLM socket. Installing the plugin does not install these dependencies. Login and connection setup happen separately; installation does not connect you automatically. Requirements

Once the requirements are met, install and enable the plugin with:

omarchy plugin add https://github.com/PatrickIsenegger/omarchy-pangolin.git --enable

This installs the plugin. The linked guide explains the separate Pangolin client setup. Resource discovery needs a logged-in user session with a selected organization. A machine client using only a client ID and secret is not sufficient.

After setup, open the panel from its bar icon, or use this terminal command:

omarchy-shell shell toggle community.pangolin

The command only opens or closes the panel; it does not change the connection. If you switch the active organization through the CLI, reopen the panel to refresh its resources. Installation and use

What to know before trying it

This plugin is intended for Omarchy Quattro. If you do not yet have a Pangolin environment, first arrange access to a suitable server or Cloud account. The plugin uses that existing setup. For one rarely used web link, a bookmark may be enough. The panel becomes more useful when you want connection status and several resources in the same place.

Settings currently use a JSON editor. Web resources open through Chromium, and resource lists refresh when you open the panel or request a refresh. The interface is in English. Consider these requirements if you plan to set it up on someone else’s workstation.

The active CLI account selects the server and organization. Pangolin Cloud and self-hosted servers are supported by the account adapter. Synthetic tests cover account and request handling for both; authenticated Cloud access has not yet been verified end to end, according to the project README. This also does not mean that every supported server and client version combination has been integration-tested. Compatibility

Source code, installation instructions, and examples are in the omarchy-pangolin repository. It is an independent community plugin. When reporting a problem, please use fictional resources and remove credentials and private addresses from screenshots and logs.

The article image is an AI-generated illustration. It does not show an actual interface or network topology.

You can also find the plugin under My projects on the tools page.