Skip to main content
Skip to content
  2. GitHub Docs
Collapse sidebar
Expand sidebar
  1. Home
  2. Enterprise administrators
  3. Troubleshoot your instance

Enterprise administrators

    • About GitHub for enterprises
    • About GitHub Enterprise Server
    • Enterprise Server trial
    • About upgrades
    • System overview
    • GitHub Enterprise API
    • Governance framework
      • Enterprise accounts
      • Teams
      • Roles
      • Automations
      • Fundamentals
      • Policies
      • Audit logs
      • Organize work
      • Use innersource
    • Create a README
    • Configure user display names
      • Install on AWS
      • Install on Azure
      • Install on GCP
      • Install on Hyper-V
      • Install on OpenStack
      • Install on VMware
      • Set up a staging instance
      • Configuring applications
      • Configure email notifications
      • Configure GitHub Pages
      • Configuring rate limits
      • API rate limits best practices
      • Configure web commit signing
      • Configure interactive maps
      • Manage GitHub Mobile
      • Verify or approve a domain
      • Disable persistent commit verification
      • Configuring TLS
      • Configure TLS and SSH ciphers
      • Troubleshoot TLS errors
      • Enabling private mode
      • Enable subdomain isolation
      • Configure host keys
      • Configure SSH connections
      • Configure referrer policy
      • Set the IP using the console
      • Configure DNS servers
      • Configure hostname
      • Change hostname
      • Validate domain settings
      • Configure an outbound proxy
      • Configure firewall rules
      • Network ports
      • Use a load balancer
      • Configure time settings
      • About GitHub Connect
      • Enable for GitHub.com
      • Enable for GHE.com
      • Automatic user license sync
      • Dependabot
      • Server Statistics
      • Unified search
      • Unified contributions
      • Disable GitHub Connect
      • About the Management Console
      • Manage Management Console access
      • Access Management Console
      • Troubleshoot Management Console
      • Manage search indices
      • Access the admin shell (SSH)
      • Using the GitHub CLI
      • Command-line utilities
      • Configure maintenance mode
      • About SAML for IAM
      • Change authentication methods
      • Fallback authentication
      • Troubleshoot IAM
      • SAML reference
      • Username considerations
      • Configure built-in authentication
      • Invite people
      • Block unauthenticated sign-up
      • Disable passkeys
      • Using CAS
      • Using LDAP
      • Configure SAML SSO
      • Enable encrypted assertions
      • Update SAML NameID
      • Troubleshoot SAML SSO
      • About SCIM provisioning
      • Configure SCIM provisioning
      • Migrate from LDAP
      • Set up Entra ID
      • Set up PingFederate
      • Set up Okta
      • Disable SCIM provisioning
      • SCIM using REST API
      • Manage teams with your IdP
      • Deprovision and reinstate users
      • Troubleshoot team membership with IdP
      • Customizing user messages
      • Configure custom footers
      • User security best practices
      • Create enterprise teams
      • Invite people to manage
      • Reserved usernames
      • Manage administrators
      • View people in your enterprise
      • View & manage SAML access
      • Audit users
      • Impersonate a user
      • Managing dormant users
      • Manage user suspension
      • Delete a user
      • Place a legal hold
      • Auditing SSH keys
      • Rebuild contributions
      • Set membership visibility
      • Prevent organization creation
      • Require 2FA
      • Custom properties
      • Organization custom properties
      • Manage your organization roles
      • Restore organization
      • Project management with Jira
      • Custom properties
      • Configure Git LFS
      • Disable SSH for Git
      • Lock a repository
      • Restore a deleted repository
      • Troubleshoot service hooks
      • Identify role requirements
      • Create custom roles
      • Assign roles
      • Predefined roles
      • Upgrading overview
      • Upgrade requirements
      • Enable automatic update checks
      • Take a snapshot
      • Check capacity before upgrade
      • Upgrade with a hotpatch
      • Upgrade with an upgrade package
      • Migrate from 11.10.x to 2.1.23
      • Restore from a failed upgrade
      • Known issues with upgrades
      • Rotate upgrade signing key
    • About the backup service
    • Understand the backup service
    • Configure the backup service
    • Elasticsearch snapshots
    • Create and monitor backups
    • Restore from backup
    • Configure remote archives
    • Backup from replica
    • Backup in clustering
    • Restore with Actions
    • Backup settings
    • Snapshot structure
    • Backup Utilities (legacy)
      • Repository management policies
      • Projects policies
      • Restrict email notifications
      • Policies for security settings
      • GitHub Actions policies
      • Security & analysis
      • Personal access token policies
      • About pre-receive hooks
      • Pre-receive hook environments
      • Pre-receive hook scripts
      • Manage pre-receive hooks
      • Access audit logs
      • Configure audit logs
      • Search audit logs
      • Identify events by token
      • Stream audit logs
      • Audit log API
      • Audit log events
      • Access reports
      • Viewing push logs
      • Log forwarding
      • Manage global webhooks
      • About Server Statistics
      • Export Server Statistics
      • Server Statistics and REST API
      • About monitoring
      • About monitor dashboards
      • Analyze Git traffic
      • Recommended alert thresholds
        • OpenTelemetry metrics
        • Configure OpenTelemetry
        • Advanced dashboards
        • Using Grafana to analyze metrics
        • External monitoring OpenTelemetry
        • About Collectd metrics
        • External monitoring with collectd
        • collectd metrics
        • Export and scrape Prometheus metrics
      • Monitoring using SNMP
      • About system logs
      • About support bundles
      • Troubleshooting resource allocation problems
      • Generating a Health Check for your enterprise
      • Increase storage capacity
      • Increase CPU or memory
      • Generation 2 virtual machines
      • Changing platform
      • About clustering
      • Choosing cluster or HA
      • About cluster nodes
      • Configure a cluster network
      • Initializing the cluster
      • Deferring database seeding
      • Upgrading a cluster
      • Monitor cluster health
      • Node Eligibility Service
      • Rebalance workloads
      • Replacing a cluster node
      • Configure HA replication
      • Initiate a failover to replica
      • About HA configuration
      • Elasticsearch Cross-Cluster Replication
      • HA replica information
      • Create HA replica
      • Monitor HA configuration
      • Initiate failover to appliance
      • Recover a HA configuration
      • Remove a HA replica
      • About geo-replication
      • About repository caching
      • Configuring a repository cache
      • Configuring multiple data disks
      • Adding nodes to HA
      • Pending reboot
      • Disk usage near capacity
      • MSSQL transaction logs
    • Create a GitHub App
    • Add app managers
    • Automate installations
      • About GitHub Actions
      • Introduce Actions
      • Migrate to Actions
      • Get started
      • Self-hosted runners
      • Azure Blob storage
      • Amazon S3 storage
      • Google Cloud Storage
      • MinIO storage
      • Dependabot updates
      • About actions in your enterprise
      • Use GitHub Connect for actions
      • Manually sync actions
      • Use the latest bundled actions
      • Tool cache for offline runners
      • HA for GitHub Actions
      • Backing up and restoring
      • Use staging environment
      • Troubleshoot GitHub Actions
      • Updating credentials for Actions storage
      • Migrate Actions external storage
    • Getting started with GitHub Packages
    • Enable Packages with AWS
    • Enable Packages with Azure
    • Enable Packages with MinIO
    • Configure package ecosystems
    • Migrate to Container registry
  • Release notes
  • Releases

Troubleshooting your instance

Diagnose and resolve common problems with your GitHub Enterprise Server instance using supported tools and procedures.

  • Troubleshooting upgrades and migrations, 1 of 3
    • Pending reboot after a hotpatch, 1 of 1
  • Troubleshooting storage and disks, 2 of 3
    • Disk usage at or near capacity, 1 of 1
  • Troubleshooting GitHub Actions data and database health, 3 of 3
    • Truncating MSSQL transaction logs, 1 of 1

Help and support

Was this Doc helpful?

Help us make GitHub Docs great!

All Docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Still need help?

Ask the GitHub communityContact supportExpert servicesBlog

GitHub Inc. © 2026TermsPrivacyStatusPricing