---
title: "Get general system info"
method: GET
path: "/systeminfo"
tags: ["systeminfo"]
---

# Get general system info

`GET /systeminfo`

This API is for retrieving general system info, this can be called by anonymous request.  Some attributes will be omitted in the response when this API is called by anonymous request.

## Headers

- `X-Request-Id` string

## Response `200`

Get general info successfully.

- GeneralInfo
  - `banner_message` string, nullable — The banner message for the UI. It is the stringified result of the banner message object.
  - `current_time` string, date-time, nullable — The current time of the server.
  - `registry_url` string, nullable — The url of registry against which the docker command should be issued.
  - `external_url` string, nullable — The external URL of Harbor, with protocol.
  - `auth_mode` string, nullable — The auth mode of current Harbor instance.
  - `primary_auth_mode` boolean, nullable — The flag to indicate whether the current auth mode should consider as a primary one.
  - `project_creation_restriction` string, nullable — Indicate who can create projects, it could be 'adminonly' or 'everyone'.
  - `self_registration` boolean, nullable — Indicate whether the Harbor instance enable user to register himself.
  - `has_ca_root` boolean, nullable — Indicate whether there is a ca root cert file ready for download in the file system.
  - `harbor_version` string, nullable — The build version of Harbor.
  - `registry_storage_provider_name` string, nullable — The storage provider's name of Harbor registry
  - `read_only` boolean, nullable — The flag to indicate whether Harbor is in readonly mode.
  - `notification_enable` boolean, nullable — The flag to indicate whether notification mechanism is enabled on Harbor instance.
  - `authproxy_settings` AuthproxySetting
    - `endpoint` string — The fully qualified URI of login endpoint of authproxy, such as 'https://192.168.1.2:8443/login'
    - `tokenreivew_endpoint` string — The fully qualified URI of token review endpoint of authproxy, such as 'https://192.168.1.2:8443/tokenreview'
    - `skip_search` boolean — The flag to determine whether Harbor can skip search the user/group when adding him as a member.
    - `verify_cert` boolean — The flag to determine whether Harbor should verify the certificate when connecting to the auth proxy.
    - `server_certificate` string — The certificate to be pinned when connecting auth proxy.
  - `oidc_provider_name` string, nullable — The OIDC provider name, empty if current auth is not OIDC_auth or OIDC provider is not configured.

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/cerit/apis/harbor-api.md) · [All operations](https://skmtc.dev/cerit/apis/harbor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cerit/harbor-api/revisions/62d78801f8df/schema)