NoShip/Docs
Dashboard

Dashboard Guide

The NoShip dashboard is your central hub for managing freeze windows, schedules, overrides, team members, and settings.

Dashboard Overview

When you sign in, the dashboard shows a summary of your organization's freeze status:

  • Active freezes -- highlighted at the top with a warning banner when merges/deployments are blocked.
  • Scheduled freezes -- upcoming freeze windows that have not yet started.
  • History -- completed and cancelled freezes.
  • Protection status -- a banner alerts you if any repos do not have NoShip configured as a required check.

If you belong to multiple GitHub organizations, use the organization selector at the top to switch between them.

Managing Freezes

Creating a Freeze

Click Create Freeze from the dashboard. You can create:

  • Quick freeze -- starts immediately, no end time. Cancel manually when ready.
  • Scheduled freeze -- set start and end times for a planned lockdown.

Every freeze needs at least a name. Optionally add a description and one or more rules to scope what gets blocked.

Cancelling a Freeze

From the dashboard or the freeze detail page, click the cancel button on any active or scheduled freeze. Cancelling a freeze immediately unblocks all affected PRs and deployments. PR status checks are re-evaluated within seconds.

Freeze Detail Page

Click on any freeze to see its full details:

  • Start and end times, current status
  • Rules with their block type and patterns
  • Add or remove rules on active freezes
  • Associated overrides

Managing Schedules

Navigate to Schedules in the sidebar to manage recurring freeze windows.

Creating a Schedule

  1. Click Create Schedule.
  2. Enter a name and optional description.
  3. Define the recurrence pattern (RRULE). The form provides a human-readable preview.
  4. Set the duration (how long each freeze window lasts).
  5. Configure default rules (block type, repo/branch/environment patterns).
  6. Save. The schedule is active by default.

Toggling and Previewing

Each schedule has an on/off toggle. When disabled, no new freeze windows are created. The schedule detail page shows the next upcoming occurrences so you can verify the pattern is correct.

Overrides

Navigate to Overrides in the sidebar to view and manage override requests.

Requesting an Override

From the overrides page or through the AI assistant, submit an override request with:

  • The freeze window to override
  • A reason (required)
  • Optional: specific repo, environment, or PR number
  • Optional: custom TTL (time-to-live)

Approving or Denying

Admins and owners see pending override requests and can approve or deny them. Approved overrides are valid for the configured TTL (default: 60 minutes) and are single-use.

Override History

The overrides page shows all requests with their current status: pending, approved, denied, expired, or used. Every action is recorded in the audit trail.

Members

Navigate to Members in the sidebar to manage your team.

Roles

  • Owner -- full access. Can manage settings, members, billing, and all freeze operations.
  • Admin -- can create/cancel freezes, manage schedules, approve overrides.
  • Member -- can view freezes and request overrides.

Adding Members

Add members by their GitHub username, or create invite links that can be shared with your team. Invite links can be configured with a specific role, maximum uses, and expiration time.

Repository Permissions

On the Team plan and above, you can restrict which repositories each member can manage. By default, members have access to all repos in the organization.

Settings

Navigate to Settings from the user menu.

  • Timezone -- set the default timezone for your organization. This affects how freeze windows and schedules display times.
  • Access control -- control who can create freezes (admins only vs all members).
  • API tokens -- generate bearer tokens for programmatic access to the NoShip API. Tokens can be named and given an expiration.
  • Slack -- connect or disconnect your Slack workspace.
  • Billing -- view your current plan, upgrade, and manage your subscription.

Command Palette

Press Cmd+K (or Ctrl+K on Windows/Linux) anywhere in the dashboard to open the command palette. From here you can quickly:

  • Search freezes, schedules, and repos
  • Navigate to any page
  • Create a new freeze
  • Open the AI assistant