# user_migration

**Repository Path**: mirrors_nextcloud/user_migration

## Basic Information

- **Project Name**: user_migration
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-12-02
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!--
  - SPDX-FileCopyrightText: 2022 Nextcloud GmbH and Nextcloud contributors
  - SPDX-License-Identifier: AGPL-3.0-or-later
-->
# Nextcloud User migration

[![REUSE status](https://api.reuse.software/badge/github.com/nextcloud/user_migration)](https://api.reuse.software/info/github.com/nextcloud/user_migration)
[![PHPUnit GitHub Action](https://github.com/nextcloud/user_migration/workflows/PHPUnit/badge.svg)](https://github.com/nextcloud/user_migration/actions?query=workflow%3APHPUnit)
[![Node GitHub Action](https://github.com/nextcloud/user_migration/workflows/Node/badge.svg)](https://github.com/nextcloud/user_migration/actions?query=workflow%3ANode)
[![Lint GitHub Action](https://github.com/nextcloud/user_migration/workflows/Lint/badge.svg)](https://github.com/nextcloud/user_migration/actions?query=workflow%3ALint)

**👤➡ User migration app for Nextcloud**

This app allows users to easily migrate from one instance to another using an export of their account.

- **🐱 Log in to cat.example.com/nextcloud**
- **⚙ Go into `Personal settings` > `Data migration`**
- **☑ Select what you want to export** (settings, files, profile information, profile picture, calendars, contacts…)
- **⚙ Start the export** and wait for the server to process it
- **📁 Download the resulting file called `user.nextcloud_export`**
- **🐶 Open an account on dog.example.com/nextcloud**
- **🡅 Upload `user.nextcloud_export` into your files**
- **⚙ Go into `Personal settings` > `Data migration` and start the import**
- **🎉 Enjoy your stay on your new instance** and close you old account

---

## Screenshots

### Select what to export from your old instance
![Export data selection](screenshots/export.png)

### Export in progress
![Export in progress](screenshots/exporting.png)

### Import into your new instance
![Import file selection](screenshots/import.png)

---

## occ Commands

The following [`occ`](https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/occ_command.html) commands are available. For a full description of command usage please pass the `--help` flag.

### Export

```
occ user:export [options] [--] [<user> [<folder>]]
```

### Import

```
occ user:import [options] [--] <archive>
```