Import from Heroku

Heroku imports work best when you already know which apps need a direct Docka target and which add-ons need manual equivalents.

Before You Start

• Create or connect the Docka target server first.
• Collect the Heroku API key from the account that can read the target apps.
• Review buildpack usage, add-ons, and config vars so warnings are easier to interpret during scan.

1. Validate Credentials

POST /api/v1/imports/validate-credentials
{
  "platform": "heroku",
  "api_key": "HEROKU_API_KEY"
}

2. Create Import

POST /api/v1/imports
{
  "platform": "heroku",
  "api_key": "HEROKU_API_KEY"
}

3. Scan Resources

POST /api/v1/imports/{importID}/scan

4. Select + Execute

PUT /api/v1/imports/{importID}/select
{
  "app_ids": ["..."],
  "database_ids": ["..."],
  "target_server_id": "uuid",
  "import_env_vars": true,
  "import_domains": true,
  "migrate_database_data": false
}

POST /api/v1/imports/{importID}/execute

What to Verify After Import

• Check all imported environment variables in the app detail page.
• Confirm custom domains are recreated and DNS records point to Docka.
• Review database credentials before any external data-sync step.
• Deploy once from Docka so logs, metrics, and restart policy are validated on the target server.