Guide · Self-hosted
How to run Plane on infrastructure you control. Product fit, architecture, deployment, high availability, security, air-gapped operation, governance, and economics, including a dedicated track for Jira Data Center customers.
1.1 · The context
Plane is a work management platform that combines projects and work items, a workspace wiki, intake, workflows, approvals, automation, analytics, and AI in one product. It runs as a managed cloud service, a connected self-hosted deployment, or a fully disconnected air-gapped deployment.
This guide is about running Plane yourself, and running it well.
It is written for organizations that must control where their work system runs, how it connects, and when it changes.
It covers the full lifecycle of a self-hosted Plane deployment: product fit, architecture, deployment models, high availability, day-two operations, air-gapped supply chains, identity, network and AI boundaries, compliance, and economics.
Some readers will arrive here from Jira Data Center, which is reaching end of life. Part 04 is written for them: the transition timeline, an honest parity assessment, and a complete migration program. The rest of the guide stands on its own: it describes how to run Plane on your infrastructure, whatever you run today.
The guide makes four claims.
The rest of this document is the evidence for those claims, and the working plan for acting on them.
| If you need to | Start with |
|---|---|
| Decide whether Plane fits your constraints | Part 01, The context |
| Design a production deployment | Part 02, The platform |
| Pass security and compliance review | Part 03, The controls |
| Plan a move from Jira Data Center | Part 04, For Jira Data Center customers |
| Standardize Plane across the enterprise | Part 05, The decision |
1.1 · The context
Plane is a work management platform that combines projects and work items, a workspace wiki, intake, workflows, approvals, automation, analytics, and AI in one product. It runs as a managed cloud service, a connected self-hosted deployment, or a fully disconnected air-gapped deployment.
This guide is about running Plane yourself, and running it well.
It is written for organizations that must control where their work system runs, how it connects, and when it changes.
It covers the full lifecycle of a self-hosted Plane deployment: product fit, architecture, deployment models, high availability, day-two operations, air-gapped supply chains, identity, network and AI boundaries, compliance, and economics.
Some readers will arrive here from Jira Data Center, which is reaching end of life. Part 04 is written for them: the transition timeline, an honest parity assessment, and a complete migration program. The rest of the guide stands on its own: it describes how to run Plane on your infrastructure, whatever you run today.
The guide makes four claims.
The rest of this document is the evidence for those claims, and the working plan for acting on them.
| If you need to | Start with |
|---|---|
| Decide whether Plane fits your constraints | Part 01, The context |
| Design a production deployment | Part 02, The platform |
| Pass security and compliance review | Part 03, The controls |
| Plan a move from Jira Data Center | Part 04, For Jira Data Center customers |
| Standardize Plane across the enterprise | Part 05, The decision |
1.2 · The context
Before deploying production infrastructure, prove three things: Plane fits the organization’s non-negotiable deployment boundary, the correct edition and plan are commercially understood, and the product covers the work patterns that matter.
“Self-hosted” and “air-gapped” are not synonyms.
Plane supports both. The distinction belongs in the architecture decision record.
| Model | Where Plane runs | Required external path | Best for |
|---|---|---|---|
| Connected self-hosted | Your servers, VPC, or Kubernetes cluster | License and seat synchronization, plus any integrations, SMTP, telemetry, and model providers you enable | Private infrastructure with governed egress |
| Air-gapped | A disconnected or sealed environment | None at runtime | Classified, regulated, sovereign, or zero-egress networks |
On connected self-hosted Plane, license and seat synchronization are the only required outbound calls. Telemetry can be disabled from instance administration. Integrations, email, and AI can add network paths, depending on how you configure them.
On Plane Airgapped, application services, backing services, licensing, and integrations operate without public-internet connectivity. Images and charts are staged into an internal registry. License activation uses a file. Internal GitHub Enterprise or GitLab endpoints stay inside the isolated network.
This produces a simple decision.
Do not leave this choice until procurement. It changes licensing, artifact movement, updates, AI configuration, integration design, and operational runbooks.
| Edition | Purpose | Important boundary |
|---|---|---|
| Community | Open-source evaluation, audit, customization, and smaller self-hosted use | Feature-equivalent to the Free tier; not the enterprise governance product |
| Commercial | Supported self-hosting with access to paid plans | Connected licensing; full Cloud feature parity by plan |
| Airgapped | Commercial capabilities in a disconnected environment | Offline licensing and internal artifact distribution |
The Community Edition is AGPL-3.0, which lets security and engineering teams inspect the open-source core. The Commercial and Airgapped editions add the licensed product, governance features, and support model used for enterprise production.
Public annual pricing lists four plans: Free at $0 for up to 12 users, Pro at $6 per seat per month, Business at $13 per seat per month, and Enterprise Grid by quote.
Self-hosting should not be justified as “free infrastructure.” A self-hosted buyer pays for Plane and also owns the infrastructure and the operating work. The business case is stronger when it rests on control, consolidation, and predictable architecture, not on a claim that servers cost nothing.
1.3 · The context
An enterprise work platform is not “issues plus a board.”
An evaluation should cover the full operating footprint an organization runs on it.
| Enterprise outcome | Plane capability |
|---|---|
| Plan and execute work | Projects, work items, states, cycles, modules, epics, milestones, releases |
| Coordinate portfolios | Initiatives, dashboards, project updates, workspace views |
| Model different work | Workspace and project work-item types, custom properties, custom relations |
| Control process | Workflows, approvals, pre-validation, post-actions, automations |
| Capture demand | In-app intake, forms, email intake, customers, custom SLAs |
| Keep knowledge with work | Project Pages, workspace Wiki, collections, nested pages, templates |
| Govern access | Workspace and project roles, custom roles, permission schemes, granular access control |
| Integrate systems | REST API, webhooks, native integrations, Plane apps, SDKs, MCP |
| Use AI under policy | OpenAI, Anthropic, Bedrock, Ollama, or OpenAI-compatible endpoints |
The product is progressively complex. Teams start with work items and states, then enable cycles, modules, initiatives, workflows, approvals, automation, and governance when those controls are needed.
That matters at enterprise scale. Complexity should arrive when a team asks for it, not before the team creates its first work item.
A credible evaluation is run against your own work, not against a feature checklist.
Before committing to production, do four things:
Gaps found this way are not a concession. They are the difference between a platform decision and a demo impression.
Proof gate
2.1 · The platform
Plane is a multi-service application with stateless application workloads and stateful backing services. The stack is built from familiar infrastructure rather than a proprietary runtime.
That one sentence carries most of the operational argument. Your platform team will not learn a new database, a new queue, or a new deployment model to run Plane.
Application, stateless
Horizontal scaling behind the ingress
Coordination, singletons
Exactly one replica, or one run per release
State, managed
Replicated or managed equivalents in production
| Service | Responsibility | Scaling model |
|---|---|---|
web | Primary application interface | Stateless, horizontal |
space | Published projects, views, and pages | Stateless, horizontal |
admin | Instance administration | Stateless, horizontal |
api | Core REST API and data operations | Stateless, horizontal |
worker | Imports, notifications, file processing, and background jobs | Stateless, horizontal |
beatworker | Periodic job scheduling | Singleton |
migrator | Schema and data migrations during release | Run-once job |
live | Real-time collaboration and presence | Stateless, horizontal |
monitor | Licensing and activation | Stateful singleton |
silo | GitHub, GitLab, Slack, and other integrations | Stateless, horizontal |
intake | Email-to-work-item processing | Stateless, horizontal |
| Plane AI services | Search, duplicate detection, and AI interaction | Horizontally scalable workers plus dedicated state |
For an evaluation, Plane can deploy these dependencies locally.
For production, the documentation recommends external database and object-storage services. For high availability, every stateful service should be replaced by a replicated or managed equivalent.
2.2 · The platform
Plane publishes multiple installation methods, including Docker Compose, Kubernetes with Helm, Docker Swarm, an all-in-one container for evaluation, Podman Quadlets, managed platforms, and an AWS Marketplace path.
Use the method that matches the stage.
| Stage | Recommended shape | Why |
|---|---|---|
| Local evaluation | All-in-one or Docker Compose | Fastest path to a working instance |
| Department pilot | Docker Compose with external Postgres and object storage | Simple operations with durable state outside the host |
| Enterprise production | Kubernetes with external managed state | Horizontal scaling, controlled upgrades, node and AZ fault tolerance |
| Sealed environment | Airgapped Docker or Kubernetes | Zero public-internet dependency |
Docker minimum CPU
Docker minimum memory
Published baseline storage
For Docker deployments, plan for at least 4 CPU cores and 16 GB of RAM across all required services. Treat this minimum footprint as a starting point for evaluation, not a production sizing promise.
Production sizing should be driven by your real workload: active and peak concurrent users, work-item and activity-history volume, attachment size and retention, import and automation throughput, real-time collaboration load, search index size, AI indexing and inference behavior, and your availability, RPO, and RTO targets.
2.3 · The platform
The documented Kubernetes high-availability model is single-region, multi-availability-zone. It is designed to survive a node or availability-zone failure. It is not an active-active multi-region architecture.
That sentence should appear in every production design review.
The workload model has three tiers.
| Tier | Workloads | Production pattern |
|---|---|---|
| 1. Stateless | api, web, space, admin, live, worker, silo, intake and email, AI workers, automation workers | At least two replicas, spread across nodes and AZs, scaled horizontally |
| 2. Singleton and coordinator | Beat workers, monitor, migrators | Exactly one replica, or one run per release |
| 3. Stateful | PostgreSQL, Redis or Valkey, RabbitMQ, OpenSearch, MinIO | Disable local setup; use replicated, multi-AZ services |
A strong reference topology includes:
The current high-availability guide notes that native rendering of topology-spread constraints, PodDisruptionBudgets, and HorizontalPodAutoscalers is still planned. Operators apply those controls separately today.
Plan for that in the production design. Helm support does not remove the platform team’s responsibility to finish it.
2.4 · The platform
For Docker installations created with the Prime CLI, the CLI handles the common lifecycle tasks: start, stop, restart, configuration, health checks, repair, upgrades, backups, and restores.
For Kubernetes, pin explicit image and chart versions. Promote releases through development, staging, and production instead of following a floating tag.
The minimum operating model has four parts.
Commercial Edition exposes separate liveness, readiness, and detailed health endpoints. Liveness tests the process. Readiness verifies critical dependencies. Detailed health returns diagnostic state.
Do not cross the checks
Prime CLI can create and restore Docker backups, and the documentation calls out backing up the environment file separately. Kubernetes deployments should back up each durable layer according to the organization’s database, object-storage, search, and secrets standards.
A backup is not complete until a restore has been tested. Define and rehearse:
Collect, retain, and alert on four layers of signal.
Every Plane release should pass the same gate:
2.5 · The platform
An air gap is not just a firewall rule.
It is a controlled process for moving software, licenses, updates, and evidence across a trust boundary.
The Airgapped Edition supports Docker and Kubernetes. The documented model uses pre-packaged images, an internal registry, offline license files, internal certificate authorities, and internal integrations. Once artifacts are staged, Plane runs without external APIs, CDNs, telemetry, or license calls.
Connected staging zone
Retrieve the release on an approved connected system
Approved transfer
Move verified artifacts across the boundary
Internal registry
The only source the sealed environment pulls from
Air-gapped deployment
Disconnected operation
The operating runbook should define:
Do not describe this as “connected build, disconnected run forever.” Air-gapped environments still need controlled updates.
The more accurate principle:
Connected preparation. Verified transfer. Disconnected operation. Controlled renewal.
3.1 · The controls
The security advantage of self-hosting is control. The security cost of self-hosting is responsibility.
Plane supplies application controls. The customer remains responsible for the infrastructure, configuration, keys, monitoring, backups, and operational evidence around them.
Everything in this part follows from that split.
Plane supports SAML and OIDC for single sign-on. Enterprise Grid adds LDAP, SCIM, IdP group synchronization, custom roles, granular access control, and API-enabled audit logs.
The access model spans two layers.
Those roles are independent. A user can be a workspace Member and a project Admin. Enterprise permission schemes package reusable permissions into custom roles, which makes access design easier to review and audit.
An enterprise rollout should define, at minimum:
3.2 · The controls
Use an explicit egress register. Every destination gets an owner.
| Destination | Connected self-hosted | Air-gapped | Owner |
|---|---|---|---|
| Plane license service | Required | No | Platform and procurement |
| Plane telemetry | Optional, can be disabled | No | Security and privacy |
| SMTP | If configured | Internal only | Messaging team |
| GitHub, GitLab, Slack, Sentry | If configured | Internal endpoints only | Integration owner |
| OpenAI or Anthropic API | If selected as model provider | No | AI governance |
| Internal model endpoint | Optional | Supported | AI platform team |
| External object store, secrets, or search | Based on architecture | Internal and private endpoints only | Platform team |
Plane documents the telemetry it collects from connected self-hosted instances: instance metadata, usage counts, interaction events, performance information, and the instance administrator’s contact details. It also documents how to disable telemetry.
That is materially different from zero egress. Say which posture you are adopting.
3.3 · The controls
Plane AI supports natural-language chat, duplicate detection, and search across work items, pages, projects, and cycles. Self-hosted Plane can connect to OpenAI, Anthropic, AWS Bedrock, Ollama, Groq, LiteLLM, or another OpenAI-compatible endpoint.
The architecture includes a dedicated Plane AI database, read access to the primary Plane database, OpenSearch for indexed and semantic retrieval, and one or more configured model endpoints.
The model endpoint determines the data boundary.
If Plane calls a public OpenAI or Anthropic API, relevant prompts and context leave your network under that provider’s contract and controls. If Plane calls a private Bedrock, Azure OpenAI, LiteLLM, or local Ollama endpoint inside your approved boundary, the traffic follows that private architecture.
Therefore:
Self-hosting Plane does not automatically make an externally hosted model local.
For a zero-egress AI posture, use an internal model endpoint and mirror every required model and embedding dependency into the environment.
3.4 · The controls
Plane’s public security material states SOC 2 Type II and ISO 27001:2022 compliance and describes GDPR, CCPA, and HIPAA support. It also states AES-256 encryption at rest and TLS 1.3 in transit.
Those are useful procurement inputs. They are not a substitute for a system-level control assessment.
For self-hosted Plane, validate how each control is implemented in your environment.
| Control area | Plane provides | Customer must implement or verify |
|---|---|---|
| Transport security | Application and ingress support | Certificates, TLS policy, internal trust, renewal, external proxy |
| Encryption at rest | Product support and encrypted application secrets | Database, disk, object store, backup, search, queue, and key-management encryption |
| Identity | SAML, OIDC, LDAP, SCIM, roles | IdP configuration, MFA, lifecycle, group mappings, break glass |
| Authorization | RBAC, custom roles, permission schemes, granular access control | Role design, least privilege, periodic review |
| Audit | Activity history and enterprise audit capabilities | Export, retention, SIEM ingestion, alerting, evidence preservation |
| Vulnerability management | Product releases and security fixes | Image scanning, patch SLAs, runtime scanning, host and cluster hardening |
| Resilience | Health endpoints, backup tooling, HA guidance | RPO and RTO design, managed-service redundancy, restore tests, DR exercises |
| Air-gap assurance | Offline deployment model | Transfer process, internal registry, artifact verification, update governance |
This is the level a security review should work at: specific controls, clear ownership, testable evidence.
4.1 · For Jira Data Center customers
This part is for organizations that run Jira Data Center today. It covers the transition constraint, an honest parity assessment, and a complete migration program.
Atlassian has announced the end of life of the affected Data Center products. New Data Center sales ended on 30 March 2026. Existing customers can continue buying expansions and renewals until 30 March 2028. On 28 March 2029, affected Data Center subscriptions and associated Marketplace apps are scheduled to expire and become read-only.
The affected portfolio includes Jira Software, Jira Service Management, Confluence, Bamboo, and Crowd. Bitbucket Data Center is treated differently through Atlassian’s hybrid-license path. Atlassian also says that multi-year extensions beyond March 2029 may be available to some customers by exception.
Those details matter. They turn a broad market announcement into a concrete planning constraint.
| Date | What changes | Enterprise implication |
|---|---|---|
| 30 Mar 2026 | New Data Center sales end | New on-prem Atlassian standardization is closed |
| 30 Mar 2028 | Expansions and renewals end for existing customers | Seat growth and Marketplace planning become constrained |
| 28 Mar 2029 | Affected subscriptions and apps reach end of life and become read-only | Migration, exception, or loss of an operational system of record |
Behind the timeline sits the real question:
What should replace the system that holds your projects, operating history, workflows, controls, and institutional knowledge?
For many organizations, Atlassian Cloud is the natural destination.
For others, it is not an acceptable destination at all.
That second group includes organizations with one or more hard constraints:
These are not preferences. They are architecture requirements.
Central thesis
Plane belongs on that shortlist because it treats deployment choice as part of the product, not as a packaging tier.
The evaluation asks two separate questions.
Parts 02 and 03 answer the simplification question: the platform and the controls you land on. The rest of this part answers the fidelity question, starting with parity in section 4.2 and ending with a data integrity contract in section 4.6.
4.2 · For Jira Data Center customers
Evaluate Plane as a successor to Jira Data Center, not as a pixel-for-pixel clone.
A clone would preserve the same screens, schemes, administrative sprawl, and app dependency tree that many enterprises want to leave behind. A successor keeps the control that made Data Center the default choice in demanding environments, and sheds that accumulated weight.
Core work management maps well: projects, work items, states, sprints to cycles, components to modules, epics, users, comments, attachments, and links all have direct destinations, and section 4.4 covers the importer that moves them. The honest evaluation happens at the edges of the estate.
| Dimension | Data Center | Plane |
|---|---|---|
| Product horizon | Affected products reach end of life in March 2029, with limited exceptions possible | Actively developed self-hosted product line |
| Deployment | Customer-managed Data Center | Cloud, connected self-hosted, or fully air-gapped |
| HA model | Mature clustered deployment | Documented single-region, multi-AZ Kubernetes pattern |
| Core work model | Deep and highly configurable | Progressive hierarchy from work items to initiatives |
| Knowledge | Confluence is a separate product | Project Pages and workspace Wiki built in |
| Service workflows | Jira Service Management is a mature dedicated product | Intake, forms, email, SLAs, workflows, approvals; validate depth |
| Workflow automation | Native rules plus a large Marketplace ecosystem | Native automation, workflows, approvals, Plane Runner, API, webhooks |
| Marketplace breadth | Very large and mature | Smaller ecosystem, more built into the core product |
| Identity and governance | Mature enterprise controls | SAML, OIDC, LDAP, SCIM, custom roles, granular access, audit by plan |
| AI | Atlassian Cloud direction | Customer-selected model endpoints, local and private models supported |
| Extensibility | REST APIs and Marketplace apps | 180+ REST endpoints, webhooks, apps, native integrations, MCP |
| Migration | Source system | Native Jira Cloud, Server, and Data Center importer plus migration support |
A credible evaluation names the areas where a one-to-one replacement is least likely:
Naming these gaps is not a concession. It is the work that separates a successful migration from a sales-led import.
Proof gate
The economics of the decision start from what the Jira estate actually costs. The Jira Data Center baseline includes the Data Center subscription until exit, Jira Service Management, Confluence, Marketplace apps, infrastructure and database operations, Jira administration, upgrades and testing, backup, DR, monitoring, and security, and the migration or exception cost that arrives after 2029.
Weigh that baseline against the Plane self-hosted cost model in section 5.3, on your own estate’s numbers.
4.3 · For Jira Data Center customers
Plane supports imports from Jira Cloud, Jira Server, and Jira Data Center. The importer is available on Plane Cloud and across Commercial Edition plans for self-hosted instances.
The importer is necessary. It is not the whole migration.
A Jira estate is three things layered on top of each other: data, configuration, and behavior. Each layer migrates differently, and each layer is verified differently.
| Layer | What it contains | Migration approach |
|---|---|---|
| Data | Projects, work items, comments, attachments, users, dates, links, cycles | Import, reconcile, and verify |
| Configuration | Types, properties, states, workflows, permissions, views, dashboards | Map, rebuild, simplify, and test |
| Behavior | Automations, scripts, apps, notifications, reporting, admin conventions | Redesign, integrate, train, and govern |
Data fidelity can be measured with counts and hashes. Configuration fidelity requires scenario testing. Behavioral fidelity requires users to complete real work.
Plan all three from the start.
4.4 · For Jira Data Center customers
The Jira importer documentation explicitly lists these mappings.
| Jira | Plane | Documented behavior |
|---|---|---|
| Labels | Labels | Imported |
| Statuses | States | Mapped; missing states can be created |
| Priorities | Priorities | Mapped |
| Users | Users | CSV-assisted import or later manual setup |
| Issues | Work items | Imported |
| Parent-child relation | Parent-child relation | Included |
| Comments | Work-item comments | Username and timestamp included when users are mapped |
| Attachments | Work-item attachments | Imported |
| Reporter | Created by | Mapped |
| Created date | Created at | Mapped |
| Assignee | Assignees | Mapped when users are imported |
| Issue types | Work-item types on paid plans | Imported when the feature is enabled |
| Images in descriptions | Images in work-item descriptions | Imported |
| Linked issues | Links | Original Jira backlinks included |
| Sprints | Cycles | Work items and dates included |
| Components | Modules | Work items included |
The public Jira comparison page also advertises custom-field migration and a controlled cutover with Jira held read-only.
The documentation and marketing page do not define every custom-field type, history event, app-owned object, or edge case. Validate those against your own instance.
Do not assume automatic conversion for:
Plane has native destinations for many of the underlying outcomes.
The goal is not to translate every Jira object mechanically. The goal is to preserve the business intent with fewer moving parts.
4.5 · For Jira Data Center customers
Run the migration as five phases. Each phase produces evidence the next phase depends on.
Inventory the estate before touching it:
Then classify every object: migrate, rebuild, replace, archive, or retire.
Define the target Plane model before importing production data. Map:
Simplify intentionally. If 5 Jira workflows express one real process, design one target workflow.
Choose a representative slice, not the easiest project.
Include one of each: a large project, a workflow-heavy project, a project with custom fields, a project with heavy attachments and history, a cross-functional project, an integration-heavy project, and a regulated or access-sensitive project.
Run the import. Let real users work in Plane. Record every difference.
Validate with evidence.
| Category | Acceptance check |
|---|---|
| Counts | Projects, work items, comments, attachments, users, cycles, modules |
| Identity | Creator, reporter, assignee, commenter, timestamps |
| Content | Rich text, images, attachments, links, child relationships |
| Configuration | Types, states, priorities, properties, workflows |
| Access | Workspace, project, guest, restricted, and admin scenarios |
| Operations | Search, notifications, email, exports, mobile, API |
| Integrations | Git, Slack, Sentry, webhooks, internal systems |
| Performance | List, board, search, detail, bulk edit, import, API latency |
| Governance | Audit trail, retention, SIEM, backup, restore, approvals |
Resolve every discrepancy as a defect, an accepted design change, or an archived limitation.
Use a controlled freeze:
Public guidance says that many teams complete a first dry run in under 3 hours, and that larger workspaces may migrate over 3 to 7 days.
Treat that as a vendor planning reference, not a contractual estimate. Your duration will be driven by data volume, customizations, apps, validation depth, network throughput, and change-management scope.
4.6 · For Jira Data Center customers
“No data loss” is not a marketing sentence. It is an acceptance contract.
Define exactly what it includes:
If a category cannot migrate natively, decide where it lives instead: in Plane, in an archive, in a data warehouse, or in the read-only Jira system.
That is how a migration becomes defensible.
5.1 · The decision
Standardizing on a work platform is a rare event.
It is the one chance most organizations get to consolidate a fragmented operating stack into a platform that stays coherent as they grow.
Enterprise Grid
└── Workspaces
├── Teamspaces
├── Initiatives
│ └── Projects and epics
└── Projects
├── Work-item types
├── Work items and sub-work items
├── Cycles
├── Modules
├── Milestones and releases
└── PagesThis lets an enterprise create boundaries for business units, regions, or legal entities while retaining a shared governance layer. Initiatives aggregate progress across projects. Teamspaces create focused collaboration surfaces. Projects keep their own execution detail.
Jira and Confluence can work well together. They remain separate products, with separate structures, permissions, administration, and cost.
Plane includes project Pages for specifications, decisions, runbooks, and reports; a workspace Wiki for cross-project knowledge; collections and nested pages for information architecture; private and shared pages; and inline collaboration with links back to work.
The benefit is not merely license consolidation.
It is referential integrity between a decision and the work that implements it.
Enterprise Grid adds the controls required to standardize without forcing every team into the same project:
Build reusable standards for workspace creation, project templates, work-item types and properties, workflow and approval patterns, role and permission schemes, intake forms, dashboards, retention and audit, integration registration, and API and automation ownership.
Then let teams vary where variation is useful.
5.2 · The decision
Plane offers several layers of extensibility.
| Layer | Best for |
|---|---|
| Built-in automations | Common trigger-condition-action workflows |
| Workflows and approvals | Controlled state transitions and human gates |
| Plane Runner | JavaScript and TypeScript logic, scheduled jobs, pre-validation, and post-actions |
| REST API | Internal applications and system integration |
| Webhooks | Event-driven synchronization |
| Native integrations | GitHub, GitLab, Slack, Sentry, Bitbucket, and others |
| MCP server | AI clients and agents acting through Plane tools |
More than 180 REST endpoints are documented. API keys use the X-API-Key header, and the API supports cursor-based pagination, selective fields, and relation expansion.
Webhooks cover project, work-item, cycle, module, and comment events. Payloads carry delivery and event identifiers and an HMAC-SHA256 signature, with retries after failed delivery.
The open-source Plane MCP server supports remote OAuth, token-based HTTP, and local stdio for self-hosted instances. The current documentation labels MCP as beta, which should be reflected in production risk assessments.
This is a strong platform surface. Governance still matters.
For every automation and integration, require a named owner, scoped credentials, secrets in an approved store, idempotent handlers, retry and dead-letter behavior, rate-limit handling, audit and execution history, staging tests, and a retirement plan.
Goal
5.3 · The decision
Avoid generic savings percentages. Model the real system.
The Plane self-hosted cost model has four parts: the plan and edition, including Enterprise Grid where required; infrastructure, meaning compute and Kubernetes or Docker operations plus PostgreSQL, cache, queue, object storage, and search; operations, meaning backup, DR, monitoring, security, and upgrades; and adoption, meaning implementation, integration and automation ownership, change management, enablement, and support.
The consolidation value comes from replacing separate tools for project and portfolio management, knowledge management, request intake and forms, workflow and approvals, automation and scripting, and dashboards and reporting.
The strongest business case is usually control + consolidation + operational simplicity + a supported future, not a single headline percentage.
The case for Plane does not rest on a corresponding button for every screen in the tool it replaces. It is strongest when an organization values:
If the system being replaced is Jira Data Center, the cost baseline should also carry the exit constraint. Part 04 covers that baseline, the platform comparison, and the migration cost drivers.
5.4 · The decision
Ninety days is enough to move from interest to a defensible decision. Run it in five stages.
Confirm connected self-hosted or air-gapped. Select the edition and plan. Define security and compliance owners. Choose pilot teams and agree acceptance criteria. If you are migrating from Jira Data Center, run the estate discovery from Part 04 here.
Deploy non-production Plane. Connect identity, SMTP, storage, and observability. Configure backups and restore tests. Establish roles and permission schemes, create the target work model, and configure AI only if its data boundary is approved.
Bring representative work into Plane, built natively or imported from the system you run today. Map types, properties, states, users, cycles, and modules. Build workflows and critical automations. Validate comments, attachments, links, dates, and identity. Test integrations, API, mobile, search, and performance. Capture every exception. Migrating from Jira, this is where the pilot import and reconciliation from Part 04 run.
Run node and dependency failure tests. Test readiness and liveness behavior. Rehearse backup and restore. Test an upgrade and a rollback decision. Validate telemetry and egress. Complete the security and architecture review.
Run real work with pilot teams. Compare user outcomes and administrative effort. Finalize the migration wave plan and the estate-specific TCO. Sign off gaps, mitigations, and exit criteria. Decide whether to scale, remediate, or stop.
Move from proof to program only when all of these are true:
Migrating from Jira Data Center adds three gates:
5.5 · The decision
A work platform decision is one an organization lives with for a decade. Make it deliberately.
The organizations with the most to protect need a platform that respects one hard constraint: control over infrastructure, data, change, and risk.
Plane is designed around that constraint.
It runs on infrastructure the customer controls. Its production architecture uses systems platform teams already operate. It supports connected and fully air-gapped environments. It brings projects, knowledge, intake, governance, automation, and AI into one product. And it can be proven in small, reversible steps before the enterprise commits.
The decision standard is the one this guide has applied throughout: prove the control boundary, prove the platform, prove the controls, and prove the economics, all against your own estate.
For Jira Data Center customers, end of life adds urgency. It should not add haste. Part 04 exists so the move can be run as a deliberate transformation, not a rushed import.
Do not move the old system unchanged. Build the next one deliberately.
5.6 · The decision
This guide is grounded in public Plane product pages, pricing, product documentation, developer documentation, and Atlassian’s official Data Center end-of-life notice, as available on 10 July 2026. Figures that cannot be publicly evidenced are excluded by design.
Atlassian Data Center End of Life
Plane Self-hosted Plane
Plane Developer Docs Understanding Plane’s editions
Plane Pricing
Plane Project management
Plane Developer Docs Plane self-hosted architecture
Plane Developer Docs Kubernetes deployment
Plane Developer Docs High Availability on Kubernetes
Plane Developer Docs Command line tools
Plane Developer Docs Health checks
Plane Developer Docs Backup and restore data
Plane Developer Docs Airgapped deployment architecture
Plane Developer Docs Deploy Plane Commercial in an Airgapped Kubernetes Environment
Plane Developer Docs Data collection and usage
Plane Developer Docs Configure Plane AI
Plane Security
Plane Enterprise Grid
Plane Plane vs Jira
Plane Docs Plane Query Language
Plane Docs Workflows and Approvals
Plane Docs Initiatives
Plane Docs Wiki
Plane Developer Docs API introduction
Plane Developer Docs Webhooks
Plane Developer Docs MCP server
FAQ
The Plane Self-Hosting Guide