All Categories > ​Onyx Documentation ​ > ​ ​Getting Started with Onyx > Onyx WordPress site importer - Importing a site using SSH

Onyx WordPress site importer - Importing a site using SSH

Updated 1 year ago by Tristan Payne

Onyx offers several options to import your site. This guide walks you through importing a WordPress site in to an existing Onyx WordPress site. This will import all files and the WordPress database.

If you would prefer to import a WordPress site from a cPanel account to a new Onyx site, we have a separate guide on using the KARMA Onyx export tool.

Mailbox Migrations

This process will only move your site files and databases.

If you wish you migrate your emails into your Onyx Mail account, you can use our KARMA Import Email tool to sync mailboxes (external link to Krystal guide opens in a new window).

Accessing the Import tool

Before we begin, please note that SSH will have to be enabled on the source server before the transfer can take place.
  1. Log in to your Onyx Portal
  2. Select the site you wish to import to.

  1. From the sites Dashboard select Import from the left hand menu.

Using an SSH Key in cPanel

The GIF below covers the steps to add your SSH key to cPanel.

The steps involved are specific to cPanel and will vary with other control panel providers, however, the ssh key provided within your Onyx dashboard will always go into ~/.ssh/authorized_key.

You can click the GIF above to enlarge it!
  1. Log Into cPanel
  2. Navigate to the "File Manager" option
  3. Click Settings in the top right corner
  4. Ensure that "Show Hidden Files (dotfiles)" is ticked
  5. Click "Save"
  6. Navigate to the ".ssh" directory
  7. Right click the "authorized_keys" file.
If this does not exist by default, you can create your own.
  1. Paste the SSH key from your Onyx Dashboard into the file.
  2. Save!

Completing an import

Warning: Importing a site will overwrite any sites / files that already exist within your Onyx site.

Complete the following details:

  1. Maintenance page - select to either enable Maintenance Mode on the source site (Yes) or leave it running as normal (No).
  2. Hostname - enter the source server hostname.
  3. Port - enter the source servers SSH port.
  4. Username - enter the SSH login username.
  5. Password - enter the SSH login password (leave blank if you have authorised the Onyx SSH key on the source server).
  6. Path - enter the path to the sites public web root (docroot).
  7. Click Start import to continue. Once the progress bar shows complete your site imported is finished.

How did we do?

Powered by HelpDocs (opens in a new tab)
© Krystal Hosting Ltd 2002–