Coming soon. Depotex is in active development, so features and these docs may still change.

Dashboard

What needs a look across Depotex, the installation's figures, the fullest spaces, the state of every part of the system and what was quarantined lately

1. Overview

Dashboard is the first page after signing in. Administrators (with the depot:read permission) see the whole installation; everyone else sees their own spaces, what's new in them and their access (see Your dashboard below). The greeting follows the time of day on your own computer.

Dashboard: what needs attention, the installation's figures, spaces by size and the system's health
Dashboard: what needs attention, the installation's figures, spaces by size and the system's health

Every part of the page shows only what you're allowed to open: a row or link for something you have no permission for is left out rather than shown and refused. Figures are at most 30 seconds old.

2. Needs attention

The list at the top is what someone should look at now, worst first, each with a button to where it's fixed. When nothing needs you, it says so. For administrators it can hold:

ItemShown toButton
An upstream is paused after repeated failures, failing (including when only the host its files come from fails), or failed in the last 15 minutes though it has answered since, with how many proxy repositories use itupstreams:readOpens the upstream
Broken files in storage found by the integrity checkintegrity:adminOpens Integrity
A space is past its quota's warning, or fulldepot:readOpens the space's quota
A scheduled job failed three times in a rowscheduler:readOpens Scheduled jobs
The license expires within 45 days, has expired or isn't validlicenses:adminOpens Licensing

Members see versions held in quarantine in their spaces (with Review when they may release them, View versions otherwise), their own API tokens that expire within a week (the button opens the tokens in your profile settings), and spaces they own that are nearly full.

3. Your dashboard

Without administrator rights the dashboard is about you. Browse packages at the top opens Browse.

  • Your spaces: a card for each space you're a member of (up to eight; All spaces lists every space you can see), with your role, how many repositories it has and how many versions are quarantined, its storage against the quota, and when something last changed. Browse opens Browse showing only that space. A space where you can use only some repositories is marked Limited, with how many you can see.
  • New in your spaces: the six newest versions in your spaces, with their repository, downloads and when they were published; a quarantined, blocked or broken version is marked. See more in Browse opens Browse.
  • Your access: your active API tokens and how many expire within a week, your signed-in sessions (both open your profile settings), the upstreams your spaces fetch from, naming any that can't be reached, and your groups.

4. Figures

Four figures sum up the installation: Spaces (public, internal and private), Repositories (hosted, proxy, group, and how many are offline), Storage used (and how many spaces have a quota) and Quarantined now (versions held, in how many spaces, and how many block rules are on). Select one to open where it's managed. Blocked versions aren't counted: whether a version is blocked is decided when someone downloads it.

5. Spaces

The six fullest spaces (share of their quota), or the six with the latest change: switch with Fullest first and Latest change. Each row shows repositories, members, storage against the quota (amber from the quota's warning, red when full), versions quarantined and when something last changed. All spaces opens the full list. On a phone each space is a card.

6. System

One row per part of the installation, with a coloured dot (green fine, amber needs a look, red a problem, grey not checked yet) and a link to where it's managed:

RowShowsPermission
ClusterServers running, the leader, and servers that stopped or are behind on heartbeatscluster:read
DatabaseReachable, its PostgreSQL version and how fast it answeredsettings:write
File storageWhere files are stored, and whether the storage ID check passed on the server that answeredstorage:admin
Search indexUp to date, rebuilding or behind, and how many versions it holdsdepot:read
UpstreamsHow many are healthy, paused or failingupstreams:read
Scheduled jobsHow many jobs, how many are failing and how many ran fine in the last dayscheduler:read
IntegrityBroken files and the last integrity runintegrity:admin
Event deliveriesFailed deliveries waiting, and deliveries running lateevents:admin

With the system check (Pro license, settings:write), the top of the page also shows how its latest run went, for example System check: 2 warnings · 14 minutes ago; select it to open the system check. The dashboard reads what is already known and never runs a test itself; the system check makes the deeper tests on every server.

7. Recently quarantined

The five versions quarantined most recently anywhere in the installation, with where they are, why (by hand, by a rule or by a guard) and when. Shown with Enterprise to whoever manages quarantine (artifacts:quarantine:manage); See all opens Settings → Quarantine.