> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doploy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrating from On-Premises

> Migrate your self-hosted Odoo installation to doploy

## Overview

Migrate your self-hosted Odoo installation to doploy in three simple steps: prepare your instance, create a backup, and restore to doploy.

**Need help?** Free migration assistance is available. Contact [support@doploy.io](mailto:support@doploy.io)

## Step 1: Update your odoo configuration file

Edit your `odoo.conf` and set the following:

```ini theme={null}
[options]
# Set list_db to True to allow database selection
list_db = True
```

### Restart Odoo

```bash theme={null}
# Restart Odoo to apply changes
sudo systemctl restart odoo
```

## Step 2: Create Backup Using Odoo Web Interface

1. Log in to your Odoo instance
2. Go to the database manager: `http://your-domain.com/web/database/manager`
3. Enter your master password
4. Click **Backup** next to your database
5. Choose format: **zip (includes filestore)**
6. Click **Backup**
7. Download the backup file

<img src="https://mintcdn.com/doploy/SZfNe33GmF9L0H9e/images/migration/odoo-backup-manager.png?fit=max&auto=format&n=SZfNe33GmF9L0H9e&q=85&s=b842f572c34675c2c57120a5aafa8ca2" alt="Odoo Backup Manager" width="1184" height="1306" data-path="images/migration/odoo-backup-manager.png" />

## Step 3: Upload to doploy

### Create Your Project (skip if you already have a project)

1. Sign in to doploy: [https://cloud.doploy.io](https://cloud.doploy.io)
2. Create a new project
3. Select your Odoo version (must match your current version)
4. Choose your server plan

### Upload Your Backup

1. Navigate to the **Backups** tab in your project
2. Click **Upload Backup**
3. Select your backup file (`.zip` file from Step 2)
4. Click **Upload**

Wait for the upload to complete. This may take a while to complete based on your backup size and internet speed.

## Step 4: Create Instance and Restore

### Create New Instance

1. Go to the **Deployments** tab
2. Click **Deploy Odoo Instance**
3. Configure your instance:
   * **Branch**: Select your Git branch
   * **Domain**: Choose a domain name
   * **Database**: Enter a database name
   * **Admin Password**: Set your admin password

### Restore Your Backup

1. After the instance is created, go to the **Backups** tab
2. Find your uploaded backup
3. Click **Restore**
4. Select the instance you just created
5. Click **Confirm Restore**

The restore process will:

* Replace the empty database with your data
* Restore all filestore attachments
* Preserve all users and permissions

This may take a while to complete based on your backup size.

## Step 5: Verify Your Migration

### Check Your Data

1. Access your new doploy instance
2. Log in with your admin credentials
3. Verify your data restored successfully

## Step 6: Update DNS

Once you've verified everything works:

1. Update your DNS settings to point to your doploy instance once ready

See our [DNS Setup guide](/getting-started/dns-setup) for detailed instructions.

## Need Help?

**Free migration assistance is available.**

Contact [support@doploy.io](mailto:support@doploy.io) with:

* Current platform, Odoo version, database size

We'll guide you through the entire process.

## Next Steps

* [Configure DNS](/getting-started/dns-setup)
* [Set up automatic backups](/getting-started/backup-schedule)
* [Add team members](/managing-odoo/project-collaborators)