Guides
Learn Port by building. Real guides for real workflows.
FEATURED
NEW
AI-powered incident management
Implement an AI-powered incident lifecycle with triage, orchestration, incident updates, RCA context, and postmortems
FEATURED
NEW
Automatically resolve tickets with Port
Resolve Jira tickets with coding agents through Port-native orchestration or an n8n workflow enriched with Port context
FEATURED
Calculate blast radius with AI
Calculate deployment blast radius and production risk using AI, service dependencies, and Port self-service actions.
FEATURED
Auto-heal unhealthy Kubernetes pods with Port workflows
Detect unhealthy Kubernetes workloads and automatically diagnose and fix them with a single Port workflow and Port AI
FEATURED
Create cloud resources using IaC
Create a self-service action that provisions cloud resources from a pre-defined template in your Git repository
FEATURED
Create and manage Kubernetes clusters
Create and delete Kubernetes clusters using Crossplane & ArgoCD with Port Workflows
FEATURED
NEW
Create Survey Intelligence
Deploy the Survey Builder, Forms, and Analytics plugins to run engineering surveys and turn responses into insights
FEATURED
Triage incidents using external MCP tools
Triage incidents using AI, Sentry MCP, GitHub MCP, and Slack — fetch live errors, query code context, and post a structured root-cause summary directly from Port AI.
FEATURED
Track AI adoption and impact
Track AI adoption and impact across your engineering teams and assess the impact of AI usage on delivery metrics like PR throughput and cycle time
FEATURED
Remediate vulnerabilities with AI
Use Port AI agents with Claude Code to remediate security vulnerabilities and trigger automated fixes
FEATURED
Track DORA metrics
Set up DORA metrics, dashboards, and scorecards for services and teams
FEATURED
Auto-create Slack channel & GitHub issue for PagerDuty incidents
Create Slack channels and GitHub issues for PagerDuty incidents, automatically or manually
Smart PR reviewer assignment using AI
Automatically assign qualified PR reviewers based on CODEOWNERS, ownership, and capacity using Port AI
Promote to production workflow
Deploy to production with Port Workflows or GitHub Actions, safety checks, incident creation, and team notifications
Auto-enhance PR descriptions with AI
Automatically generate comprehensive, template-compliant PR descriptions using a Port workflow that gathers catalog context and dispatches a coding agent
Summarize Zendesk tickets with AI
Build a workflow that fetches ticket context and summarizes it with Port AI
NEW
Provision Azure resources from Terraform with Azure DevOps MCP
Build a workflow that reads Terraform modules from Azure DevOps via MCP, then triggers Claude Code to open a pull request
NEW
Build workflows with AI
Use AI and the Port MCP server to build Port workflows through natural language
NEW
Provision cloud resources with an agentic IaC workflow
Build a self-service workflow that drafts an IaC implementation plan with AI and opens a real pull request against your GitOps repository using a Cursor Agent node
NEW
Trigger Datadog incident (Workflows)
Trigger a Datadog incident from a self-service workflow and sync it to your catalog
NEW
Create Slack channel for reported incident
Automatically open a Slack channel and GitHub issue when a PagerDuty incident is reported
NEW
Manage and visualize cloud resources
Manage and visualize AWS, Azure, and GCP cloud resources with dashboards and self-service actions
NEW
Respond to New Relic alerts
Create Jira issues or PagerDuty incidents from New Relic alerts using Port workflows with webhook nodes
NEW
Build and configure Port using the MCP server
Build Port data models, self-service actions, automations, and scorecards through natural-language MCP interactions
NEW
Visualize and manage Git deployments
Create dashboards and self-service actions to visualize and manage GitHub and GitLab deployments
NEW
Ingest cloud resources using APM integrations
Ingest cloud resources monitored by Datadog, Dynatrace, or New Relic into Port
NEW
Ingest data via Airbyte and S3
Ingest HiBob or Okta data using Airbyte, S3, and a custom webhook integration
NEW
Ingest repository files into your context lake
Parse package manifests, API specifications, SBOMs, SARIF files, and security scan results from repositories into Port
NEW
Prepare work items with AI
Enrich work items with catalog context, support human review, and route approved tickets to coding agents
NEW
Manage Argo CD applications
Create a Port workflow that syncs and restarts Argo CD applications, and self-heals them with Port AI when they drift or degrade
NEW
Nudge Pull Request Reviewers
Create a Port workflow that nudges reviewers of a pull request
NEW
Build GitHub dashboards in Port
Build GitHub dashboards for dependency security, identity and access, repository activity, and engineering metrics
NEW
Visualize Claude metrics
Create dashboards to monitor Claude API usage, track costs, analyze model performance, and measure workspace-level metrics
NEW
Visualize Cursor metrics
Create dashboards to monitor Cursor adoption, acceptance rates, and engineering impact at the user, team, and organization level
NEW
Assign PR reviewers with a Claude managed agent
Assess pull request risk, assign reviewers, comment, and auto-approve low-risk PRs using a Claude managed agent triggered from a Port workflow
NEW
Measure GitHub Copilot adoption and usage with plugins
Deploy the GitHub Copilot AI Adoption and Usage plugin to track Copilot adoption, acceptance rates, and AI-generated insights in Port
NEW
Map external tool users and teams to Port accounts
Map external user and team identities to Port accounts for accurate ownership and access
NEW
Manage incident lifecycle
Create self-service actions to acknowledge, escalate, and resolve PagerDuty incidents
NEW
Add tags to AWS resources
Create Port workflows that add tags to AWS S3 buckets and ECR repositories
NEW
Manage Humanitec applications
Ingest Humanitec resources and manage applications with self-service actions
NEW
Deploy Azure resource with Terraform
Create self-service actions that deploy Azure storage accounts with Terraform using GitHub Actions, Azure DevOps, or Jenkins
NEW
Manage MCP Server Registry
Build a centralized MCP server registry with governance, discovery, and automated metadata extraction
NEW
Set up a PRD agent for ticket triage
Set up a PRD agent, a PM agent running a PRD skill, that turns thin tickets into a clear spec and routes each one to an AI coding agent or a human
NEW
Enrich tasks with AI-powered context
Use Port workflows to enrich Jira tasks with AI-powered context for task assignees
NEW
Trigger AI coding assistants from Port
Trigger GitHub Copilot, Claude Code, and Google Gemini Assistant from Port using governed workflows
NEW
Scaffold a new service
Create a workflow that scaffolds a new service and registers it in your catalog
Sync Port configurations between environments using Port AI and MCP
Move Port configurations between environments using Port AI and GitHub MCP
Build an AI Agent Registry
Build a centralized AI Agent Registry to discover, govern, and manage AI agents across AWS Bedrock and Azure AI Foundry
Remediate CI/CD failures with Port AI & Cursor
Remediate CI/CD failures with a Port workflow that gathers catalog context, launches a Cursor agent, and notifies Slack
Manage and surface technical documentation
Centralize markdown technical docs in Port by syncing them from a Git source, displaying them on service pages, and optionally adding a TechDocs plugin
Create foundational Engineering Intelligence data model
Build the foundational data model for Engineering Intelligence with organizations, teams, services, and repository blueprints
Triage incidents using Dynatrace MCP
Triage incidents using AI, Dynatrace MCP, GitHub MCP, and Slack to build root-cause summaries from live telemetry and code context.
Ingest .NET framework versions
Track .NET framework versions across repositories by ingesting .csproj files into Port
Keep your Azure catalog up to date with incremental syncing
Keep your Azure catalog data up to date by syncing only what changed, without full rescans
Route scorecard failures to Jira issues with AI
Route scorecard failures to Jira issues using a Port workflow and Port AI
Onboard developers using internal docs and Port MCP
Onboard developers from internal docs using Port MCP to help new developers get up to speed quickly
Set up delivery performance scorecard
Define and track delivery performance standards across services, teams, groups, and organizations using scorecards
Sync Port properties to GitHub custom properties
Sync Port properties to GitHub custom properties using Port's GitHub integration and automation system
Set up pipeline reliability scorecards
Grade services, teams, groups, and organizations on CI/CD workflow failure rates and reliability trends using Bronze, Silver, and Gold maturity levels
Set up a service production readiness scorecard
Grade services on ownership, documentation and repository hygiene
Visualize lead time using Jira
Track and visualize Jira lead time metrics at the service and team level with weekly and monthly averages
Surface resource actions from Jira with AI
Use Port's AI agent to analyze Jira issues and surface relevant self-service actions for cloud resources and permissions
Measure pipeline reliability
Measure CI/CD pipeline reliability at service and team level including failure rates, failure trends, and failing workflow identification
Ingest LinearB metrics into your context lake
Ingest metrics from LinearB into Port using the Ocean Custom Integration to consolidate DORA and pull request performance data into a single source of truth
Ingest Swarmia metrics into your context lake
Ingest metrics from Swarmia into Port using a scheduled GitHub Actions workflow to establish a single source of truth for engineering performance data
Measure PR delivery metrics
Measure PR delivery metrics at service and team level including cycle time, throughput, stale PRs, and reviewer coverage
Track team work allocation with Jira
Measure and visualize work allocation across Roadmap, Tech Debt, and Support categories at the team level using Jira labels
Measure sprint health with Jira
Track sprint completion rate, scope change, and carryover at the team level using dashboards and scorecards
Ingest GitLab security vulnerabilities into your context lake
Ingest GitLab SAST, DAST, dependency scanning, and container scanning vulnerabilities into Port for centralized security posture visibility and team-level insights
Track AI coding assistants costs
Build a unified dashboard to analyze and compare AI coding tool costs across Cursor, Claude, and GitHub Copilot
Migrate repositories from GitHub to GitLab
Migrate repositories from GitHub to GitLab using a Port workflow and GitHub Actions
Implement the incident blueprint pattern
Learn the recommended pattern for managing incident response workflows using a dedicated incident blueprint
Track Azure resource tagging compliance
Track Azure resource tagging compliance with scorecards, dashboards, and self-service remediation
Measure AI feedback
Collect and analyze feedback on AI tools using Port actions, automations, and AI agents to measure effectiveness and guide adoption decisions
Implement the work item blueprint pattern
Learn the recommended pattern for managing development workflows using a dedicated work item blueprint
Ingest prompts and skills from GitHub using GitOps
Ingest prompts and skills from GitHub using GitOps by mapping repo files to Port blueprints.
Centralize AI coding rules with Port
Use a workflow to centralize AI coding rules with Port and sync consistent standards into repository AGENTS.md files
Ingest Claude Code security reviews
Ingest Claude Code security reviews into Port using Port's GitHub file ingesting feature
Auto-assign bugs to owners with AI
Automatically assign Jira bugs to owning teams and services with Port automations and AI
Visualize Okta security insights
Build a security analytics dashboard for Okta identity and access management
Visualize GitHub Copilot metrics
Create dashboards to monitor GitHub Copilot usage, track acceptance rates, and measure team productivity
RBAC for AI agents with n8n and Port
Implement role-based access control (RBAC) for multi-agent systems using Port and n8n, enabling dynamic tool access control for AI agents based on user roles and permissions
Auto-generate GitHub workflow documentation
Automatically generate and maintain human-readable documentation for GitHub Actions workflows using Port's AI agents and automation system
Remediate security vulnerability with n8n and Port AI
Remediate security vulnerabilities with n8n and Port AI using Port's AI agents and automations
Query DORA metrics using Port MCP
Query DORA metrics using natural language commands directly from your IDE with Port's MCP server
Streamline IaC with AI
Use Port AI agents to automate IaC provisioning and management
Find internal documentation with AI
Find internal documentation using AI by storing documentation as entities in your Port catalog
Manage AI instructions with Port
Learn how to centralize AI instructions in Port and automatically sync them to GitHub repositories
PCI DSS code security scorecard
Continuously track compliance with PCI DSS requirements using code scans and vulnerability data
Enforce AI coding security standards
Learn how to enforce AI coding security standards in your organization
Build an OWASP Top 10 Scorecard
Build an OWASP Top 10 security scorecard in Port using vulnerability data from Snyk
Auto-remediate insecure cloud resources with AI
Learn how to use Port's AI capabilities to detect insecure cloud resources and automatically use a coding agent like Claude Code to fix it
Interact with PagerDuty incidents
Create, trigger, reassign, and resolve PagerDuty incidents from a single native workflow
Track AI-driven pull requests
Track AI-driven pull requests and visualize them in a dashboard
Map PRs to services in a monorepo
Automatically map GitHub pull requests to services in a monorepo using file path analysis
Send Slack messages to users using Port Workflows
Learn how to send Slack messages to users using Port's Slack app and Port Workflows
Auto-fix services when scorecards degrade
Learn how to use Port's AI capabilities to detect scorecard degradation and automatically use a coding agent like GitHub Copilot to fix it
Create an actions ROI dashboard
Create a dashboard that tracks the ROI of actions in Port
Visualize and manage your Azure DevOps deployments
Create a dashboard that visualizes and manages your Azure DevOps deployments
Track and show MTBF for services
Track Mean Time Between Failures (MTBF) for your services to measure reliability and identify improvement opportunities
Manage your Kubernetes deployments
Manage Kubernetes deployments and pods with a self-service Port workflow for restarts, replica changes, and pod deletion
Track leaked GitHub secrets in Port
Create a webhook integration that tracks leaked GitHub secrets in Port
Manage EKS clusters
Build Port workflows to provision, request, deploy to, tag, and delete EKS clusters, with AI triaging requests and deletions
Set up the Platform Request Triage AI agent
Set up an AI agent that helps developers submit and track requests to the platform team
Set up the Service Explorer AI agent
Set up an AI agent with MCP server backend mode that helps developers explore and understand your context lake
Automatically set relations between entities with automation
Set up automations to set relations between entities based on integrations metadata
Manage and visualize your Jira issues
Manage Jira issues with dashboards, automatic labels, status updates, assignee changes, and comments
Manage PagerDuty on-call schedules
Track and manage on-call engineers across teams and services with Port workflows and dashboards
Manage and visualize your PagerDuty incidents
Manage your PagerDuty incidents with self-service actions and create dashboards for visualization
Manage and visualize your LaunchDarkly feature flags
Create a comprehensive feature flag management system to create, toggle, and archive flags
Visualize and manage your Statuspage incidents and components
Create a dashboard that visualizes and manages your Statuspage incidents and components
Visualize and manage your ServiceNow incidents
Create a dashboard that visualizes and manages your ServiceNow incidents
Set up DORA metrics using Jira
Configure DORA metrics tracking using Jira for both deployments and incidents
Auto-label your GitHub PRs with Sonar Scans
Create an automation that applies labels to GitHub pull requests based on SonarQube scans
Automate admin role assignment
Set up automated user role assignment when they are added to Admins group.
Interact with ServiceNow records and incidents
Create self-service actions that create, update, trigger, and delete ServiceNow records and incidents
Visualize your Wiz vulnerabilities
Create a dashboard that visualizes your Wiz vulnerabilities
Notify users upon approval of self-service actions
Create an automation that notifies users when a self-service action is approved/declined
Automatically create Jira issue from Datadog alert
Create a Port workflow that opens a Jira issue from a Datadog alert
Trigger Spacelift stack
Create a Port workflow that triggers a Spacelift stack to automate infrastructure workflows
Track health of Jira projects using scorecards
Create a scorecard to track the health of Jira projects
Enrich pull requests using AI
Set up an AI agent that automatically comments on pull requests with additional context
Enforce code maturity with GitLab file search
Create a scorecard that tracks GitLab code maturity based on file existence
Set up the Incident Manager AI agent
Set up an AI agent that helps developers track and manage incidents efficiently
Enforce Branch Protection Rules with Scorecards
Create a scorecard that tracks branch protection rules and enforces security policies
Set up the Task Manager AI agent
Set up a Task Manager AI agent to help developers track and manage tasks efficiently
Monitor integrations
Monitor and manage your Port Ocean integrations
Manage FireHydrant incidents
Create a self-service action that manages FireHydrant incidents
Create an incident.io Incident
Create a self-service action that creates an incident.io incident
Copy ADO Pipeline Template to Target Repo
Create a self-service action that copies an AzureDevops pipeline template to a target repository
Ingest Slack data into Port
Ingest Slack channels, users, and memberships through Airbyte or Fivetran, S3, and a webhook integration
Manage service deployments using GitLab and ServiceNow
Build a Port workflow that deploys a service via GitLab and routes low-coverage deployments through a ServiceNow approval
Measure pull request standards
Implement working agreements and measure pr standards
Automatically approve actions using an automation
Set up automated approvals for self service actions
Ingest vulnerability alerts from Orca Security
Ingest vulnerability alerts from Orca Security using a custom webhook integration
Sync Service Entities to incident.io
Create a GitHub action that syncs service entities to your incident.io catalog
Manage Kubernetes namespaces via a Port workflow
Create and manage Kubernetes namespaces with GitLab pipelines, approval workflows, and automations
Automate Slack alerts for Overdue PRs
Send a Slack notification for pull requests that have been open longer than a specified time using an automation
Automate AWS Account Creation with GitLab
Validate an AWS account request with AI and provision it with GitLab CI/CD
Connect CODEOWNERS with Service, Team & User
Create a logical connection between your GitHub CODEOWNERS and their corresponding services, teams, and users
Connect GitHub pull request with Jira Issue
Create a logical connection between your GitHub PRs and their corresponding Jira issues
Create an AWS EC2 instance
Create a Port workflow that provisions an AWS EC2 instance with Terraform using GitHub Actions or GitLab CI
Deploy S3 Bucket using Crossplane
Create a self-service action that deploys Crossplane resources in your Kubernetes cluster
Deploy/rollback using ArgoCD
Create a Port workflow that performs a deployment/rollback using ArgoCD
Enrich services using Gitops
Empower developers to independently enrich their services using a self-service action
Ensure production readiness
Define and track metrics for your services to ensure their production readiness
IAM permission management
Empower developers to request and revoke time-bound AWS IAM permissions using Port workflows
Manage GitHub Pull Requests
Create a Port workflow that dispatches a GitHub Actions pipeline to close, merge, or approve pull requests
Provision Cloud Resource using Terraform
Create a self-service action that provisions cloud resources using Terraform
Report a bug to Jira
Create a Port workflow that reports a bug to Jira using a webhook node
Scaffold a new service with Actions
Create a self-service action that scaffolds a new service and can open follow-up GitOps pull requests
Scaffold repositories using Cookiecutter
Create a self-service action that scaffolds GitHub, Bitbucket, or Azure DevOps repositories using a Cookiecutter template
Slack reminders for scorecards
Send a Slack reminder for uncompleted scorecard rules using a self-service action
Trigger Datadog Incident
Create a self-service action that triggers a Datadog incident
Visualize your services' k8s runtime
Create views to track the health, status, and other standards of your services' k8s runtime
Visualize your services' k8s runtime using ArgoCD
Create views to track the health, status, and other standards of your services' k8s runtime using ArgoCD
Create a Jira Issue
Create a self-service action that creates a Jira issue
Lock and Unlock Services
Create a self-service action that locks and unlocks a service