/panel/imports-migrations/imports

Imports

What are imports?

An import is the operation that allows you to insert, automatically, within the Qboxmail systems a list of domains and / or email accounts in a massive way through a specially configured CSV file, making the procedure of inserting a large number of domain and / or account simpler and faster .

Who can import?

Imports can be made from a Admin, a Team member or a Manager authorized to manage the domains.

What can be imported?

You can import domains, email accounts, alias domains and alias email and the respective passwords. Each CSV file can contain up to 250 items.

A CSV file must be prepared for each type of import.

Create a CSV file for an import

To carry out an import it is necessary to create a specific CSV file following the specifications in the file 0-ENG-README-IMPORTS.txt present in the file Imports.zip.

You can choose between a basic and an advanced import, the basic import allows you to create Domains and Email Accounts by specifying only the name and password. Advanced import allows you to specify additional fields in the CSV.

A maximum of 500 lines can be inserted in the CSV file.

The field separator is the; (semicolon). It is also possible to use a text delimiter if the password includes a special character or the field separator itself. The text delimiter is "(quotation marks). See the file imports-delimiters.txt.

Password import with hash

It is possible to specify an hash in the CSV password field if you do not have the current password available. Hashes represent passwords in encrypted format and this is usually how they are stored in databases. Currently it is possible to insert these hash formats in the CSV:

  • MD5-CRYPT
  • SHA512-CRYPT

In this case the password field must contain the name of the password scheme used enclosed in square brackets:

  • Example: {SHA512-CRYPT}$6$xVM3rIc...

It is also possible to import many other Hash types, in the event that the one you have available is not among those supported by CSV import contact our technical support.

Below is the complete list of supported hash:

  • BLF-CRYPT
  • SHA512-CRYPT
  • SHA256-CRYPT
  • MD5-CRYPT
  • CRYPT
  • PLAIN-MD5
  • SHA
  • SSHA
  • SHA256
  • SSHA256
  • SHA512
  • SSHA512
  • SSHA256.hex
  • SSHA512.hex

CSV file for basic imports

To carry out a basic import you must create a CSV file in which each object to be imported must be defined by fields, divided by the field separator; (semicolon) and, if they contain a semicolon, enclosed by a text separator "(double quote).

The basic mode is the default when performing an Import.

Basic Account Email Import Format:

  • 2 columns
  • Email Account (required); Password (required)

Basic Domain Import Format:

  • 2 columns
  • Domain (required); Password (required)

Domain Alias Import Format:

  • 2 columns
  • Real Domain (required); Alias Domain (required)

Domain Email Alias Import Format:

  • 2 columns
  • Email Alias (required); Recipients(required, max 20 separated by comma)

When selecting Basic mode, the CSV file must contain only the mandatory fields.

CSV file for advanced imports

For "Domains" and "Email Accounts" imports there is an "advanced" mode that can be selected when the CSV file is loaded from the control panel. The advanced mode requires that also the optional CSV fields/columns are present, even if empty. Therefore in the CSV, when the "advanced" mode is selected, the fields separated by commas must be present even if they are empty.

Format for Advanced Account Email Import

  • 5 columns
  • Account Email(required);Password(required);Name(optional);Surname(optional);Forward(optional, max 20 separated by comma)

Format for Advanced Domain Import

  • 3 columns
  • Domain(required);Postmaster password(required);Manager codes (optional)

Perform an import

To make a setting click on the entry Imports in the control panel sidebar and click on the + Import button and complete the steps of the creation procedure. Once the procedure is completed, the setting will be visible on your import list.

  • Imports > + Import
  1. Select the type of imports you wish to carry out.
  2. Load the previously prepared CSV file.

In order to import email accounts, alias domains or alias email, the domain to which they belong must first be present.

To complete the procedure click on the Import button. Once the import procedure has been completed, this will be visible on your import list.

List of imports

The list of imports contains all the imports added to the Qboxmail systems belonging to a Admin with the related detailed information. To view the list of imports click on the name on the Imports entry in the control panel sidebar.

Information in the import list:

  • Import status.
  • Name of the user who made the import request.
  • Import code.
  • Subject to import.
  • Import resources.
  • Possible errors in the import procedure.
  • Date and time of the import or its attempt.
Status Description
updateStatus Validation
enableStatus Valid import
disableStatus Not valid import

Delete an import

To delete an import from the import list click on the Trash button trashIcon corresponding to the import, confirming the operation by clicking on the Delete button within the modal.

  • Imports > Import name > Trash TrashIcon > Delete

Deleting an import only deletes the operation. In the event that the import has already been bought and successfully completed, the domains and important accounts will not be deleted.

Imports older than 30 days are automatically deleted.

We use cookies to provide you with a better browsing experience, continuing to accept their use.

Accept