You can import Azure DevOps wiki pages into Phonemos using the phonemos-azure-devops-import command-line tool. The tool connects to your Azure DevOps organization, reads the wiki structure, and creates a matching hierarchy of pages in Phonemos.

Prerequisites

Java 18 or later installed
A Phonemos import token (see step 1 below)
An Azure DevOps Personal Access Token (PAT) with read access to wikis
The phonemos-azure-devops-import.jar file

How It Works

The tool connects to your Azure DevOps organization and imports all wiki pages from a project. The page hierarchy in Azure DevOps is mirrored as pages in Phonemos. Attachments (images, files) referenced in wiki pages are downloaded and imported alongside the content.

If you omit the --project argument, all projects in the organization are imported.

Steps

1. Get a Phonemos Import Token

Open the settings menu in the top bar and choose Import from External System. Copy the import token — it looks like:

phonemos:import:<site-id>:<hostname>/<secret>

2. Create an Azure DevOps Personal Access Token

In Azure DevOps, go to User Settings → Personal Access Tokens and create a token with read access to wikis.

3. Preview the Import (Optional)

Run a dry run to see what will be imported without making any changes:

java -jar phonemos-azure-devops-import.jar upload \
  --importToken=phonemos:import:... \
  --serverUrl=dev.azure.com \
  --organization=my-organization \
  --project=my-project \
  --pat=MY_AZURE_PAT \
  --upload.dryRun=true

4. Run the Import

java -jar phonemos-azure-devops-import.jar upload \
  --importToken=phonemos:import:... \
  --serverUrl=dev.azure.com \
  --organization=my-organization \
  --project=my-project \
  --pat=MY_AZURE_PAT

The tool will display a plan of all pages to be created and ask for confirmation before proceeding. Once confirmed, it imports all wiki pages into Phonemos.

To import all projects in the organization, simply omit --project.

Example Structure Mapping

The following Azure DevOps wiki structure:

my-project wiki
├── Getting Started
├── Architecture
│   ├── Overview
│   └── Decisions
└── How-To Guides
    └── Deployment

…produces this page hierarchy in Phonemos:

my-project wiki
├── Getting Started
├── Architecture
│   ├── Overview
│   └── Decisions
└── How-To Guides
    └── Deployment

Links between pages in your wiki will be preserved. Attachment Images that are linked in the page will also be included.

Phonemos User Guide

Migrate Azure DevOps Wiki