# FreePBX Debian Install

### VM Setup

##### 1. Create a New VM and give it a name

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/clkbo8B2lC0foq7l-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/clkbo8B2lC0foq7l-image.png)

##### 2. Make sure it is Generation 2

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/TAcHvDCkNt4RiJ8w-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/TAcHvDCkNt4RiJ8w-image.png)

##### 3. Make sure it has at least 4000 MB of memory. This is enough but more can be allocated if available.

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/ILLW4GAQhUW9oeTs-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/ILLW4GAQhUW9oeTs-image.png)

#####  4. It is important to make sure it has a working internet connection

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/Y5fvAqR5e2W2Ifhh-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/Y5fvAqR5e2W2Ifhh-image.png)

##### 5. Create a virtual hard disk. Make sure it has at least 40 GB of Storage. This should be plenty but more can be used if available

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/7mJgY3G5iqwye2s2-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/7mJgY3G5iqwye2s2-image.png)

##### 6. Choose to install from a bootable image file and pick the Debian.iso which can be downloaded from [here.](https://www.debian.org/download "Debian Download")

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/22bMG7Gobr2V2Ikx-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/22bMG7Gobr2V2Ikx-image.png)

##### 7. Finish

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/p61WlcXrMHJ1s0WV-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/p61WlcXrMHJ1s0WV-image.png)

### Debian Install

##### 1. After booting the ISO choose graphical install. Make sure there is a working network connection otherwise the install will not work.

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/FagHMcPc0buoebcH-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/FagHMcPc0buoebcH-image.png)

##### 2. English

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/CAJVLTMA3LaFdSxz-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/CAJVLTMA3LaFdSxz-image.png)

##### 3. United States

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/SBPnFkuwyC33V4B4-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/SBPnFkuwyC33V4B4-image.png)

##### 4. American English

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/MMSBqFnQQJDh8Eoj-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/MMSBqFnQQJDh8Eoj-image.png)

##### 5. Enter SangomaPBX

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/f1lqTZIhiQxMEtr6-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/f1lqTZIhiQxMEtr6-image.png)

##### 6. Enter the domain of the network or just leave it blank.

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/Sn1O4Jxd0E0xLH6G-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/Sn1O4Jxd0E0xLH6G-image.png)

##### 7. Create a password for the Root user that will also be used for the login user that will be created later

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/PXPl0VYtJgh4n44Q-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/PXPl0VYtJgh4n44Q-image.png)

##### 8. This will be the main user that will login with ssh make sure to record this username

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/DoOYZrrPuhN978Mk-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/DoOYZrrPuhN978Mk-image.png)

##### 9. Use the same password as used for the root account

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/sqiLytix2wletVTU-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/sqiLytix2wletVTU-image.png)

##### 10. Usually Central

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/BLRSS8gcnXWIPPbh-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/BLRSS8gcnXWIPPbh-image.png)

##### 11. Choose "use entire disk"

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/5v3DIuEAKsBT7mcB-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/5v3DIuEAKsBT7mcB-image.png)

##### 12. In a VM there should only be 1 option

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/fKKQHTF8wD7ADaNO-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/fKKQHTF8wD7ADaNO-image.png)

##### 13. All files in 1 partition

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/FQHkRg8hjMlCntw6-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/FQHkRg8hjMlCntw6-image.png)

##### 14. Finish partitioning

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/PDy3ifAhRl0YyIC2-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/PDy3ifAhRl0YyIC2-image.png)

##### 15. Make sure to change this to Yes and continue

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/ueDGRP2wKyy3fHuI-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/ueDGRP2wKyy3fHuI-image.png)

##### 16. Do not scan for additional media

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/WteIrsQS76nb0rTp-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/WteIrsQS76nb0rTp-image.png)

##### 17. Choose United States

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/6GngznYPLFzsegSU-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/6GngznYPLFzsegSU-image.png)

##### 18. Choose deb.debian.org

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/jqMT91BV4oNeHkR4-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/jqMT91BV4oNeHkR4-image.png)

##### 19. No proxy is needed leave it blank and click continue

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/SOYgTils9CTYMoIs-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/SOYgTils9CTYMoIs-image.png)

##### 20. Choose No and continue

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/dqwvb8zAXxV7NWmt-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/dqwvb8zAXxV7NWmt-image.png)

##### 21. Make sure that the following are selected:

- ##### Debian desktop environment
- ##### Cinnamon
- ##### SSH server
- ##### standard system utilities

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/X2gFdChERbWodNzE-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/X2gFdChERbWodNzE-image.png)

##### 22. This will take about ~5 minutes to download and install all of the packages

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/Y0uoV4vSN9UCWs2F-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/Y0uoV4vSN9UCWs2F-image.png)

##### 23. Choose yes to install grub

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/nrADlItJXay2ay6p-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/nrADlItJXay2ay6p-image.png)

##### 24. There should only be one option available make sure to select it

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/jdHtbnS2rXpiiJVg-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/jdHtbnS2rXpiiJVg-image.png)

##### 25. Choose continue to reboot

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/9tFnznDdnMvBqReK-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/9tFnznDdnMvBqReK-image.png)

### Post install

##### 1. login with the root user to do final configuration

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/PpehKq9wXYteUyu1-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/PpehKq9wXYteUyu1-image.png)

#####  2. Open the terminal from the taskbar on the bottom and run the command

```bash
usermod -aG sudo pbxenjoyer
```

##### Replace pbxenjoyer with a different username if a different username was used

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/WMbUlIeyTQwgN9Uv-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/WMbUlIeyTQwgN9Uv-image.png)

##### 3. Logout by clicking the menu in the bottom left and then clicking the Green exit button. Log back in as pbxenjoyer with the password that was set for it earlier (should be the same as the root user)

##### [![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/pNy3X3Q46RcPNWXT-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/pNy3X3Q46RcPNWXT-image.png)  
  


### FreePBX install

##### 1. At this point SSH is installed and running you can ssh into the server:

```bash
ssh pbxenjoyer@10.0.0.10
```

##### Replace the IP with the server IP which can be found by clicking the Network Icon on the bottom right.

##### 2. Either in SSH or the Terminal run this command to install FreePBX. This will take about 5 minutes to install.

```
cd /tmp
wget https://github.com/FreePBX/sng_freepbx_debian_install/raw/master/sng_freepbx_debian_install.sh  -O /tmp/sng_freepbx_debian_install.sh
sudo bash /tmp/sng_freepbx_debian_install.sh
```

##### 3. After it is finished running you can go the IP address in your browser to access the FreePBX webui and complete the PBX setup.

### Optional Steps

##### 1. Run this command to install Doom

```
sudo apt install chocolate-doom
```

##### 2. Open the menu in the bottom left and searching for Doom. Run the first option

[![image.png](https://bookstack.archfox.org/uploads/images/gallery/2025-02/scaled-1680-/jL7voiwlX9JM25Ir-image.png)](https://bookstack.archfox.org/uploads/images/gallery/2025-02/jL7voiwlX9JM25Ir-image.png)

<div id="bkmrk--38" style="display: none;"></div><div id="bkmrk--39" style="display: none;"></div><div id="bkmrk--40" style="display: none;"></div>