• Jira applications and project types overview
  • Getting started as an administrator
    • Setting up your instance
    • Creating a project
    • Adding new users
    • Managing permissions
  • Installing Jira applications
    • Jira applications installation requirements
      • Installing Java
    • Supported platforms
      • End of support announcements
      • Bundled Tomcat and Java versions
    • Install a Jira Data Center trial
    • Installing Jira applications on Windows
      • Uninstalling Jira applications from Windows
    • Installing Jira applications on Linux
      • Uninstalling Jira applications from Linux
    • Installing additional applications and version updates
    • Troubleshooting installation
    • Connecting Jira applications to a database
      • Connecting Jira Data Center to Amazon Aurora
      • Connecting Jira applications to Azure SQL
      • Connecting Jira applications to PostgreSQL
      • Connecting Jira applications to MySQL 8.0
      • Connecting Jira applications to Oracle
      • Connecting Jira applications to SQL Server 2017
      • Connecting Jira applications to SQL Server 2019
      • Connecting Jira applications to SQL Server 2022
      • Connecting Jira applications to Pgpool-II
      • Tuning database connections
        • Surviving connection closures
      • Securing a database password
        • AES encryption
        • Configuring AWS Secrets Manager
        • Configuring Jira with HashiCorp Vault
        • Custom implementation
      • Switching databases
      • Connecting Jira applications to MySQL
    • Installing Jira Data Center
      • Upgrade from Jira Server to Jira Data Center
    • Running the setup wizard
    • Licensing and application access
      • License compatibility
    • Extending Jira applications
      • Integrating with development tools
        • Integrating with development tools using DVCS
          • Linking Bitbucket Cloud accounts
            • Getting started with Bitbucket and Jira Cloud
            • Configure automatic team invitations
          • Linking GitHub accounts
          • Linking GitLab accounts
          • Configuring webhook security
            • Troubleshooting webhook security issues
        • Integrating with development tools using app links
      • Integrating with other tools
        • Listeners
        • Managing webhooks
        • Services
      • Link to other applications
        • Configure an outgoing link
        • Configure an incoming link
          • OAuth 2.0 scopes for incoming links
          • Jira OAuth 2.0 provider API
          • OAuth 2.0 provider system properties
      • Integrating with collaboration tools
      • Managing apps
        • Monitor your apps with App Usage
          • Install App Usage
          • Configure App Usage for monitoring
          • Explore App Usage
    • Upgrading Jira applications
      • Reasons to upgrade
      • Upgrade checklist
      • Upgrade matrix
      • Upgrade methods
      • Creating a test environment for Jira
      • Preparing for the upgrade
      • Upgrading Jira (installer)
      • Upgrading Jira (manual)
      • Upgrading Jira Data Center (installer)
      • Upgrading Jira Data Center (manual)
      • Upgrading Jira Data Center with zero downtime
        • Zero downtime upgrade checklist
        • Upgrade task troubleshooting
        • Zero downtime upgrade FAQs
      • Upgrading Jira with a fallback method
      • Rolling back a Jira application upgrade
      • Establishing staging server environments for Jira applications
      • Migrating Jira applications to another server
        • Migrating from Jira Cloud to Data Center applications
        • Migrating from Jira Data Center to Cloud
    • Running Jira Data Center on a Kubernetes cluster
    • Getting started with Jira Data Center on AWS
      • Administering Jira Data Center on AWS
      • Upgrading Jira Data Center on AWS
    • Getting started with Jira Data Center on Azure
      • Administering Jira Software Data Center on Azure
    • Federating Jira - managing multiple instances
    • Get a Jira Data Center trial license
  • Layout and design
    • Configuring the look and feel of your Jira applications
    • Configuring an announcement banner
    • Configuring the default dashboard
      • Using dashboard gadgets
      • Adding a gadget to the directory
      • Subscribing to another application's gadgets
    • Choosing a default language
      • Translating Jira
    • Configuring the default issue navigator
    • Creating links in the application navigator
    • Configuring the user default settings
  • User management
    • Managing users
      • Create, edit, or remove a user
      • Assign users to groups, project roles, and applications
      • Monitor a user's activity
      • Manage password security
      • Prevent automatic login
      • SAML SSO for Jira Data Center applications
      • Anonymizing users
        • Retrying anonymization
    • Enabling public signup and CAPTCHA
    • Managing groups
      • View, create, or delete a group
      • Modify group membership
      • Assign group access to a project role
      • Manage group access to applications
    • Advanced user management
      • Allowing connections to Jira for user management
      • Diagrams of possible configurations for user management
      • Managing nested groups
      • User management limitations and recommendations
    • Configuring user directories
      • Configuring the internal directory
      • Connecting to an LDAP directory
        • Configuring an SSL connection to Active Directory
        • Reducing the number of users synchronized from LDAP to JIRA applications
        • Configuring the Dynamic LDAP connection pool
      • Connecting to an internal directory with LDAP authentication
      • Configuring the JNDI LDAP connection pool
      • Connecting to Crowd or another Jira application for user management
      • Managing multiple directories
      • Migrating users between user directories
      • Synchronizing data from external directories
  • Configuring projects
    • Defining a project
      • Editing a project key
        • Changing the project key format
    • Configuring issues
      • Configuring built-in fields
        • Defining issue type field values
          • Associating issue types with projects
        • Defining priority field values
          • Associating priorities with projects
        • Defining resolution field values
        • Defining status field values
        • Translating resolutions, priorities, statuses, and issue types
      • Issue fields and statuses
      • Configuring issue-level security
    • Configuring permissions
      • Managing global permissions
      • Managing project permissions
        • Customizing Jira Service Management permissions
        • Resolving Jira Service Management permission errors
        • Using Manage Sprints permission for advanced cases
        • Sprint permissions and defined processes
      • Managing project roles
        • Managing project role membership
      • Allowing anonymous access to your project
    • Managing components
    • Managing versions
      • Creating release notes
    • Project screens, schemes and fields
      • Managing custom fields
        • Adding custom fields
        • Configuring custom field contexts
        • Editing or deleting custom fields
        • Translating custom fields
        • Analyzing the usage of custom fields
        • Optimizing custom fields
          • Custom fields with global contexts
      • Managing system fields
        • Configuring contexts and default values for the Description field
        • Viewing and configuring screens
      • Specifying field behavior
        • Associating field behavior with issue types
        • Configuring renderers
      • Defining a screen
        • Associating a screen with an issue operation
        • Associating screen and issue operation mappings with an issue type
      • Creating a notification scheme
    • Using the issue collector
      • Advanced use of the Jira issue collector
    • Working with workflows
      • Managing your workflows
      • Configuring workflow schemes
      • Sharing your workflow
      • Advanced workflow configuration
        • Working in text mode
        • Adding a custom event
        • Configuring the initial status
        • Configuring workflow triggers
        • Using validators with custom fields
        • Using XML to create a workflow
        • Workflow properties
        • Configuring Jira Service Management approvals
    • Archiving an issue
    • Archiving a project
    • Managing project shortcuts
  • Importing and exporting data
    • Migrating from other issue trackers
      • Importing data from CSV
        • Commonly asked CSV questions and known issues
        • How to import CSV data with PVCS command
      • Importing data from Excel
      • Importing data from TFS or Visual Studio
      • Importing data from Rally
      • Importing data from VersionOne
      • Importing data from YouTrack
      • Importing data from Axosoft
      • Importing data from BaseCamp
      • Importing data from JSON
    • Moving or archiving individual projects
      • Splitting Jira applications
    • Exporting issues from Cloud to Data Center
    • Exporting issues from Data Center to Cloud
    • Migrating data with 3rd party apps
  • Configuring Jira application emails
    • Different types of email notifications in Jira
    • Configuring email notifications
      • Configuring an SMTP mail server to send notifications
      • Customizing email content
        • Templates: Batched issue notifications and other events
        • Templates: Separate issue notifications and other events
        • Examples: Customizing email content
      • Adding custom fields to emails
    • Creating issues and comments from email
      • Configuring an incoming mail server with POP, IMAP, or Microsoft Graph API
      • Integrating with OAuth 2.0
  • Jira system administration
    • System administration
      • Finding your Server ID
      • Increasing Jira application memory
      • Using the database integrity checker
      • Precompiling JSP pages
      • Logging and profiling
        • Logging email protocol details
      • Backing up data
        • Backing up the database
        • Configuring automatic database backups
        • Preventing user access during XML database backups
        • Backing up the home directory
        • Storing backups in Amazon S3
      • Restoring data
        • Restoring a project from backup
        • Anonymising Jira application data
        • Restoring data from an xml backup
        • Restoring information from a native backup
      • Search indexing
        • Re-indexing after major configuration changes
      • Using robots.txt to hide from search engines
      • Control anonymous user access
      • Moderating user group activity with Safeguards
      • Licensing your Jira applications
      • Viewing your system information
      • Monitor application performance
        • Monitor Jira with Prometheus and Grafana
        • Application metrics reference
        • Live monitoring using the JMX interface
        • Trace requests in Jira
      • Monitoring database connection usage
      • Monitor your instance with Jira diagnostics plugin
      • Viewing Jira application instrumentation statistics
      • Generating a thread dump
      • Finding your Jira application Support Entitlement Number (SEN)
      • Auditing in Jira
        • Audit log events in Jira
        • Audit log integrations in Jira
      • Monitor security threats
      • Data pipeline
        • Data pipeline export schema
        • Make the most of the data pipeline with the DevOps dashboard
        • Deploy the DevOps dashboard in Tableau
        • Deploy the DevOps dashboard in PowerBI
      • Important directories and files
        • Jira application installation directory
        • Jira application home directory
        • Setting your Jira application home directory
      • Integrating Jira applications with a Web server
        • Integrating Jira applications with IIS
        • Integrating Jira with Apache
          • Configuring Apache Reverse Proxy Using the AJP Protocol
          • Integrating Jira with Apache using SSL
          • Troubleshooting Apache
      • Securing Jira applications with Apache HTTP Server
        • Using Apache to limit access to the Jira administration interface
        • Using Fail2Ban to limit login attempts
      • Changing Jira application TCP ports
      • Connecting to SSL services
      • Running Jira applications over SSL or HTTPS
      • Secured secrets by default
        • Secure secrets configuration properties
        • Security management
      • Configuring security in the external environment
      • Data collection policy
      • Jira Admin Helper
      • Raising support requests as an administrator
      • Start and Stop Jira applications
      • Managing LexoRank
      • Jira cluster monitoring
      • Scheduler administration
    • Configuring global settings
      • Configuring time tracking
      • Configuring Jira application options
        • Configuring advanced settings
        • Configuring the base URL
        • Configuring the administrator contact form
      • Setting properties and options on startup
        • Recognized system properties for Jira applications
      • Advanced Jira application configuration
        • Changing the constraints on historical time parameters in gadgets
        • Changing the default order for comments from ascending to descending
        • Limiting the number of issues returned from a search view such as an RSS feed
      • Configuring file attachments
      • Configuring Amazon S3 object storage
        • Storing attachments in Amazon S3
        • Storing avatars in Amazon S3
      • Configuring issue linking
      • Configuring issue cloning
      • Configuring the allowlist
      • Configuring sub-tasks
      • Managing filters
      • Managing dashboards
      • Enabling logout confirmation
      • Rich text editing
      • Configuring terminology
    • Server optimization
      • Configuring secure administrator sessions
        • Tightening access with a websudo allowlist
      • Improving instance stability with rate limiting
        • Adjusting your code for rate limiting
      • Jira application cookies
      • Preventing security attacks
      • Using the Jira application configuration tool
      • Running Jira applications as a Windows service
      • Tuning garbage collection (GC)
      • Encrypt passwords in server.xml
  • Jira Data Center documentation
    • Running Jira Data Center on a single node
    • Running Jira Data Center in a cluster
      • Set up a Jira Data Center cluster
      • Adding and removing Data Center nodes
  • Performance and scaling
    • Best practices for scaling Jira Software
    • Jira Software guardrails
    • Jira Service Management guardrails
    • Performance and scale testing
    • Use a CDN with Atlassian Data Center applications
    • Configure your CDN for Jira Data Center
    • Jira Data Center monitoring
  • Security overview and advisories
  • Getting help