Vetrix Docs

Instance settings

Instance settings are the instance-wide options a site administrator controls from one page. The settings are organized into categories you expand and collapse, and within each category they are grouped into small panels. Each panel saves on its own, so you can change one group of related settings and apply just those without touching the rest of the page.

Where to find it

  • URL: gitvetrix.com/admin/settings
  • Navigation: Open the admin area, then select Settings at the bottom of the admin sidebar. The page is titled Application Settings.

Understand the layout

The page is a single scrolling column of categories. Each category is a heading you can expand or collapse, with a short line describing what it covers. The categories are:

  • General & Branding — instance identity, SEO metadata, server-wide behavior, sign-up, and the activity feed.
  • Authentication & Access — login, session lifetimes, bot protection, and authentication rate limits.
  • Security & Scanning — vulnerability scanners and instance security policy.
  • CI/CD — pipelines, runner resource controls, trigger limits, and environment URLs.
  • Integrations & Registry — repositories, the package and container registry, the MCP server, and dynamic client registration.
  • Email — SMTP delivery, the outbound queue, and webhook rate limits.
  • Operations & Monitoring — disk-space alerts, logging, the search index, maintenance mode, and analytics.

Select a category heading to expand it and reveal its panels; select it again to collapse it. Your expanded and collapsed choices are remembered between visits.

Inside a category, each panel gathers a set of related settings — for example, Branding, SEO, and Registration all sit inside General & Branding. A panel's controls are labeled and, where a setting needs explanation, a short hint appears beneath the control.

Change a setting

  1. Expand the category that holds the setting.
  2. Find the panel and the labeled control for the setting you want.
  3. Update the value: type into a text or number box, choose from a dropdown, or flip a toggle.
  4. Select Save changes at the bottom of that panel. Only the settings in that panel are saved.

Because each panel saves independently, changes you make in one panel are not applied until you select that panel's Save changes button. If a value is not valid, the page shows the reason beneath the control and does not save the panel until you correct it.

Enter a secret or password

Some fields, such as an SMTP password, hold a secret. For your protection the current value is never shown back to you.

  1. A stored secret appears as (set — leave blank to keep current value); a field with no stored value shows (unchanged).
  2. Leave the field blank to keep the existing secret. The saved value is left untouched.
  3. To replace the secret, type the new value. Select Show to reveal what you typed and Hide to mask it again.
  4. Select Save changes in that panel to store the new secret.

Send a test email

The Email (SMTP) panel has a Test Connection button next to Save changes. Save your SMTP settings first, then select Test Connection to send a test message using the current configuration. A confirmation appears when the message is sent, and an error with the reason appears if it is not.

Turn on maintenance mode

Maintenance mode is in the Maintenance panel under Operations & Monitoring. While it is on, everyone except administrators receives a service-unavailable response, so turning it on is a deliberate, confirmed action.

  1. Expand Operations & Monitoring and find the Maintenance panel.
  2. Optionally set the Maintenance message shown to users while maintenance mode is active.
  3. Turn on Enable maintenance mode.
  4. Select Save changes.
  5. A confirmation dialog, Enable maintenance mode, warns that non-administrator traffic will be turned away. Select Enable maintenance mode in the dialog to proceed, or close it to cancel.

To end maintenance, turn Enable maintenance mode off and select Save changes again; turning it off needs no confirmation.

Settings configured outside the UI

A few settings are set through the instance's environment rather than on this page. These appear read-only, with the note Configured via environment variable — not editable here. so you can see the setting exists without being able to change it here.

Manage sign-in providers

Sign-in providers (the external accounts users can log in with) are managed on their own page. A card at the bottom of the settings page links to it with Open OAuth Providers.