Install Yeastar P-Series Software Edition on KVM

Kernel-based Virtual Machine (KVM) is an open source virtualization technology built into Linux, which allows you to run multiple virtual machines. This topic describes how to create a virtual machine on KVM and install Yeastar P-Series Software Edition on the created virtual machine.



  1. Launch Virtual Machine Manager, click the Create a new virtual machine icon at the top-left corner.

  2. Select the image file of P-Series Software Edition.
    1. Select Local install media (ISO image or CDROM), then click Forward.

    2. Select Use ISO image, click Browse to choose the image file of P-Series Software Edition, then click Forward.

  3. Set memory and CPU based on the concurrent calls for your PBX system, then click Forward.
    Table 1.
    0-75 CC 76-125 CC 126-250 CC 251-500 CC 501-750 CC 751-1000 CC CC>1000
    vCPU 4 6 8 16 48 64 Contact Yeastar
    Memory 4 GB 6 GB 16 GB 16 GB 32 GB 32 GB

  4. Specify disk space for the virtual machine , then click Forward.
    Important: Do NOT add extra hard disk before you finish the installation task, or an installation error may occur.

    1. Select the checkbox of Enable storage for this virtual machine.
    2. Select Create a disk image for the virtual machine, specify disk space based on the Concurrent Calls (CC) for your PBX system.
      Table 2.
      0-75 CC 76-125 CC 126-250 CC 251-500 CC 501-750 CC 751-1000 CC CC>1000
      Call Recording Disabled 50 GB 100 GB 200 GB 300 GB 500 GB 500 GB Contact Yeastar
      Call Recording Enabled Recommended: 1 TB
      Tip: 1 GB of storage holds approximately 1000 minutes of recorded calls. You can set up the storage based on your recording usage.
  5. Verify the above configurations and configure network for the virtual machine.

    1. In the Name field, enter a name to help you identify the virtual machine.
    2. Extend Network selection menu, select the network card to be paired with the virtual machine, and set Source mode as Bridge.
    3. Review your configurations.
    4. Click Finish.

      The system starts creating the virtual machine and install Yeastar P-Series Software Edition.

  6. Select Continue without updating or wait for seconds to check if there is a new version of installer.

  7. Select Custom storage layout and select Done.

  8. In the AVAILABLE DEVICES section, select the local disk, then select Add GPT Partition.

  9. In the pop-up window, partition the hard disk according to your needs.
    Note: The following partitions are required. You can also add other partitions.
    Table 3.
    Partition Name Description Format Recommended Partition Space
    /swap This is where you extend the system memory by dedicating part of the hard drive to it. swap Minimum 10 GB
    / The slash / alone stands for the root of the file system tree. ex4 Minimum 10 GB
    /home This holds all the home directories for the users. ex4 Remaining Free Space after other partitions created or second drive.

  10. Select Done.
  11. In the pop-up dialog box, select Continue to start installing P-Series Software Edition.

  12. Wait till the installation process is not running, then press Enter.

    If a IPPBX login prompt is displayed and no errors like wait for basicsrv run ok occur, it indicates that P-Series Software Edition is installed with default IP address

  13. Optional: If you prefer another IP address or your PC is on a different network segment such as 192.168.28.X, you can change the PBX's default IP address.
    Important: PBX's IP address MUST be on the same network segment as your PC, or you can NOT access the PBX from your PC.

    We assume that your PC is on the network segment 192.168.28.X and your desired PBX IP address is Refer to the following instructions to change the PBX's IP address.

    1. Access the PBX via SSH.
      1. At the IPPBX login prompt, type support and press Enter.

      2. At the Password prompt, type QhcyaxsGcywymg2022 and press Enter.

        Note: Generally, you will NOT get any visual feedback from the screen when you type the password.

        You are presented with a prompt, displaying the Ubuntu information and system information. In the meanwhile, you are given the option to ping an IP address, view or update current network configuration, and log out the support account. You can type a specific number to run the command of the corresponding number.

    2. Type 1 and press Enter to update the network configuration.

    3. Change the IP address of Yeastar P-Series Software Edition as follows.

      1. At the Please enter IP address prompt, type the desired IP address and press Enter.

        In this example, type

      2. At the Please enter netmask prompt, type the subnet mask and press Enter.

        In this example, type

      3. At the Please enter gateway prompt, type the gateway address and press Enter.

        In this example, type

        It takes about two minutes to change the PBX's IP address from to your desired IP address.


Yeastar P-Series Software Edition is installed successfully.

Open a web browser, enter the PBX's IP address in the address bar, and press Enter.

What to do next

Yeastar P-Series Software Edition is inactivated and not ready for use. To activate the PBX, see Activate and Initially Set up Yeastar P-Series Software Edition.
Important: With P-Series Software Edition activated, next time you want to access the PBX via SSH, you should use the username support and the console password configured on PBX web portal (Security > Security Settings > Console/SSH Access > Console > Console Password).