Self-Service Portal
A Windows desktop app that lets end users install IT-approved apps on their own devices without raising a support ticket. You control which apps are available and can brand it with your company name and logo.
In short
- Windows only. macOS devices do not get the portal.
- Turn it on in Settings, and the agent installs it on every managed Windows device at its next check-in.
- Apps appear in the portal through assignments with the Available (Self-Service) intent. No job is created until a user clicks Install.
- Apps a user installed from the portal are kept up to date when the app has Auto Update on.
- Give apps a category on their app page and the portal groups them, with a filter for each category.
How it works
An admin enables the Self-Service Portal in Settings.
Company branding is optional. See Settings.The admin creates assignments with the Available (Self-Service) intent to make apps visible.
See Assignments.The Pckgr agent automatically deploys the portal application to managed Windows devices.
End users open the portal from the Start Menu, browse available apps, and click Install.
The agent handles the download and installation in the background.
Real-time progress is shown in the portal.
The portal talks to the Pckgr agent service running on the device, and the agent does the downloading and installing. The one thing the portal fetches itself is your company logo, if you have uploaded one.
Turn on the portal
Go to Settings in the sidebar.
Scroll to the Self-Service Portal card.
Toggle Enable Self-Service Portal on.
Optionally enter a Portal header name, such as "Contoso IT".
If you leave this blank the header uses your Organization name from Settings, so most tenants do not need to set it.Click Save Changes.
On the next agent check-in, the portal application is deployed to all managed Windows devices. A shortcut appears in the Start Menu under Pckgr > Self-Service Portal. macOS devices do not get the portal.
Company logo
Turn off the portal
Toggle the setting off and save. On the next check-in, the agent automatically:
- Closes the portal if it is running
- Removes the application files
- Removes the Start Menu shortcut
- Removes the Add/Remove Programs entry
Pckgr also stops answering the portal's requests while it is disabled, so even if the app were still present it would show no apps.
Make apps available
Apps become available in the portal through assignments with the Available (Self-Service) intent.
Go to Apps, open the app, and click Assign to Group.
See Assignments.Select a group containing the target devices.
Set the intent to Available (Self-Service).
This intent is offered for Windows apps only.Click Create Assignment.
Unlike Install or Uninstall assignments, Available assignments do not create deployment jobs immediately. They simply make the app visible in the portal for devices in that group, and the user decides whether to install it.
You can make multiple apps available to the same group, and assign the same app to multiple groups.
Group apps into categories
Give apps a category, such as "Browsers" or "Productivity", and the portal groups them so users can find what they need in a long list.
Go to Apps and open the app.
In the Details card, click Self-Service category.
The list shows the categories you already use and how many apps are in each.Pick a category, or type a new name and choose Create.
The category is saved as soon as you choose it.
- Each app has one category. Choose No category to remove it; the portal lists uncategorised apps under Other.
- Capitals and spacing do not split a category: typing "browsers" when you already have "Browsers" files the app under "Browsers".
- The Apps list shows each app's category beside its name, and the search box finds apps by category.
- App templates carry the category, so an MSP sets it once and every tenant the template is applied to gets the same grouping.
- Categories are for Windows apps only, as the portal is Windows only.
Until you categorise at least one app, the portal has no category list. Devices show categories once their portal app has updated, which the agent does on its own.
What end users see
Browsing apps
When a user opens the portal, they see the apps available to their device, each with its name, publisher, version and the app's logo. Apps from the Pckgr catalog show their own logo; apps you uploaded yourself, and any catalog app without one, show a coloured tile with the app's initials. The window carries your company name and logo.
A side menu switches between All apps, Installed and, when a newer version of an installed app is ready, Updates. If you have categorised your apps, the menu also lists each category with a count, and Other for apps without one; All apps lists the apps under a heading for each category. In a narrow window the menu becomes a row of buttons above the list.
The search box at the top (Ctrl+K) finds apps by name, publisher or category across every view. Clicking an app opens its details: status, installed and latest version, publisher, category and its last install or uninstall.
If no apps have been made available for their device, they see the message “No apps available.” If the Pckgr agent service on the device isn't responding, the portal says it can't load apps right now and keeps trying again on its own.
Installing an app
The user finds the app and clicks Install. A progress bar shows the current stage:
| Stage | What is happening |
|---|---|
| Waiting to start | Waiting for the agent to pick up the job |
| Postponed | The user postponed the install from the install prompt; it continues later |
| Starting | The agent has picked up the job and is getting started |
| Downloading | Fetching the application package |
| Preparing | Extracting the installer |
| Installing | Running the installer (Uninstalling for an uninstall) |
| Finishing up | Post-install verification |
When complete, the app shows Installed. If the version on the device is older than the one in Pckgr, it shows Update with both versions instead, and clicking it installs the newer version. If the installation fails, the app shows the reason with a Try again button, and its details show the full message for the user to pass on to IT.
Uninstalling an app
The ... menu on an installed app has Uninstall, which asks the user to confirm first, and Reinstall, which installs the app again over the current copy. The same progress stages apply. When an uninstall completes, the app returns to the available state with an Install button.
An app that is also Required on the device (an Install assignment reaches it) can be reinstalled from the portal but not uninstalled, since Pckgr would install it again at the next compliance check. The ... menu offers Reinstall only, and the app's details say the organization requires it.
Dependencies
If an app has dependencies configured, those prerequisite apps are installed automatically before the requested app. The user does not need to install dependencies manually.
Auto-updates for self-service apps
When a new version of an app is published and the app has Auto Update enabled:
- Devices with Install or Update Only assignments receive update jobs automatically.
- Devices where a user installed the app via self-service also receive update jobs automatically.
- If Auto Update is disabled on the app, self-service installs are not updated.
Users get the latest version without needing to reinstall from the portal. The update appears as a regular deployment job and runs silently in the background.
Monitor self-service deployments
Self-service install and uninstall jobs appear on the Deployments page alongside admin-initiated jobs. You can filter and troubleshoot them the same way.
In the portal, each app's card shows the status of the user's jobs from the last 24 hours: progress while a job runs, and the failure reason with Try again when one fails.
Requirements
- A Windows device with the Pckgr agent installed and enrolled.
- The device must be in a group with at least one Available (Self-Service) assignment.
- The Self-Service Portal must be enabled in tenant Settings.
- WebView2 Runtime must be present on the device (included in Windows 11 and most Windows 10 installations).