migrate-domain

Imports a virtual server from some other product

Virtualmin has the capability to import servers from other hosting programs, such as cPanel and Plesk. This program can perform an import from the command line, which will create a new server in Virtualmin with all the same settings and content as the original server.

The --source parameter must be followed by the name of the backup or export file to migrate from. The --type parameter must be followed by the short name of the product that originally created the backup, such as cpanel, ensim, plesk or psa (for Plesk 7).

By default, Virtualmin will attempt to work out the domain name from the backup automatically. However, this can be overridden with the --domain parameter, which must be followed by a domain name. Similarly, the original username and password will be used unless set with --user and --pass respectively. Some migration formats do not contain the password, in which case --pass must be given (and an error will be displayed if it is missing).

To migrate a server under the ownership of an existing Virtualmin user, use the --parent parameter to specify the name of the parent domain.
The optional --webmin parameter will cause a Webmin login to be created for the migrated server, which is typically what you want unless using --parent.

If the original server had a private IP address, either the --ip or --allocate-ip parameter should be used to create an IP for the new virtual server. Failure to do this may cause the migration attempt to be rejected, or for features of the migrated server to not work properly (such as its SSL virtual website). If you want to use a virtual IP that is already active on the system, you must add the --ip-already command-line option.

The --template parameter can be used to specify a Virtualmin template by name to use when creating the migrated virtual server. If not given,
the default settings template will be used.

Command Line Help

Migrates a Virtualmin server from a backup created by another product
like cPanel, Ensim or Plesk.

virtualmin migrate-domain --source file
                          --type cpanel|ensim|psa|plesk|plesk9|lxadmin
                          --domain name
                         [--user username]
                         [--pass password]
                         [--webmin]
                         [--template name]
                         [--ip address] [--allocate-ip]
                         [--ip-already]
                         [--parent domain]
                         [--prefix string]
                         [--delete-existing]

The source can be one of :
 - A local file, like /backup/yourdomain.com.tgz
 - An FTP destination, like ftp://login:pass@server/backup/yourdomain.com.tgz
 - An SSH destination, like ssh://login:pass@server/backup/yourdomain.com.tgz
 - An S3 bucket, like s3://accesskey:secretkey@bucket