Aikido — Security Platform for Code & Cloud logo

Migrating to Aikido

This is the migration hub for teams replacing an incumbent code, cloud, or supply-chain security tool with Aikido. The safe pattern is phased: onboard assets, preserve evidence, route ownership, run in parallel, then move enforcement one capability at a time.

Who this is for

Security leads, platform engineers, and CTOs migrating any incumbent code, cloud, or supply-chain scanner to Aikido. That includes teams replacing older SAST programs, point tools, or multi-tool stacks and wanting one rollout pattern that works across repositories, cloud accounts, container registries, and related scanning surfaces.

The migration pattern in one paragraph

Aikido migrations are usually run as a phased overlap, not a freeze-and-cutover event. Start with visibility, keep one tool as the blocker while the other measures, baseline historic debt so only net-new issues drive enforcement, make sure every onboarded asset has an owner, preserve legacy evidence in read-only form during the overlap, and cut over by capability or category rather than by one big-bang retirement date.

The migration playbook (any path)

Visibility first, blocking later

Connect the assets you want to migrate first, confirm coverage, and let teams see findings before you enforce on them.

Parallel run: one tool blocks, the other measures

During overlap, avoid double-blocking pull requests. Keep the incumbent tool as the active gate while Aikido runs in warn-only mode, then flip the gate once ownership, routing, and signal quality are stable.

Baseline historic debt vs net-new

Aikido distinguishes existing findings from newly introduced ones, so historical backlog stays visible without becoming a fresh blocking event. Use that distinction to focus rollout on new issues first.

Ownership and smart issue routing

Before you turn on enforcement, map every onboarded asset to an owner. Use teams, CODEOWNERS, assignment rules, and task-tracker routing so new findings land with the responsible team.

Audit and evidence continuity

Keep the incumbent tool's historical reports, exports, and other evidence available in read-only form during the overlap for audit continuity. For ongoing evidence in Aikido, use the Security Audit Report and the available export and integration surfaces: PDF report export, issue export, activity log API, SBOM and VEX export, REST API, webhooks, and Vanta integration.

Cutover and decommission criteria

Cut over by capability or category, not by one calendar date. For example, move one category at a time from report-only to enforcement, confirm routing and evidence collection are working, then decommission the incumbent tool for that category. Full retirement follows once the categories you care about have clean ownership, stable gating, and acceptable evidence coverage.

Vendor-specific migration guides

Onboarding surfaces

Aikido onboards across source code management systems, cloud accounts, container registries, and, where documented, DAST / Surface Monitoring app domains. Before enforcement, configure teams, CODEOWNERS and assignment rules, roles and permissions, task-tracker routing, and SAML / SSO so the rollout model is already in place when blocking begins.

Related resources