Install VTEDDY on an Ubuntu 14.04 VPS

vteddyVTEDDY is a free and open source application for a customer-centered workflows and business webmail management. It includes a desktop-like user interface that runs on a standard LAMP server. You can easily manage your inboxes. Each email can trigger a business process and you can turn a message into a calendar event, create an organization starting from an email address or set a chat on a specific topic. In a simple way you can have a unique flow of information from email request from customers to invoices! VTEDDY can be integrated with the main mail servers such as Gmail, MS Exchange, Zimbra and all other IMAP mail servers on your Linux VPS.

It’s core functions are calendaring and integrated Webmail, plus the capability of converting emails into business objects such as: quotes, invoices, marketing stuff, customer requests, project management and more.


Multi account IMAP client with cache
Create Case and business object by email
PDF and ODF viewer with PDF template editor
Mobile open source app created with Sencha Touch
Shared calendar, organizations and up to 4 other business modules


Apache2 web server
PHP Version 5.3 or higher
An IMAP server which supports IMAP4 rev1
An SMTP server

To install VTEDDY on an Ubuntu VPS follow the very easy steps described below.

Make sure your Ubuntu 14.04 Linux VPS is fully up to date using:

# apt-get update
# apt-get upgrade


Let’s navigate to Apache’s document root and download VTEDDY there. You can find the document root in the default configuration file in your Apache configuration directory. You can check it using the following command:

# grep DocumentRoot /etc/apache2/sites-available/000-default.conf


DocumentRoot /var/www/html

The below commands will enter the above mentioned directory, download and extract the VTEDDY installation archive:

# cd /var/www/html

# wget

# tar -xzf vteddy.tgz

You need to set the proper permissions and ownership of the newly created ‘vteddy‘ directory. Issue the following:

# chmod 755 vteddy

# chown www-data: vteddy


Next thing you need to do is to create a database. Login to your MySQL service as root:

# mysql -u root -p

mysql> CREATE DATABASE vteddy;

mysql> GRANT ALL PRIVILEGES on vteddy.* TO 'vtuser'@'localhost' IDENTIFIED BY 'your_password';


mysql> quit;

Create a new virtual host directive in Apache. Copy the default configuration file and replace it with the name of your choice. For our purposes we will name the file vteddy.conf. Execute the following command:

# cp /etc/apache2/sites-available/000-default.conf /etc/apache2/sites-available/vteddy.conf

Now, open the file with your favorite text editor and replace the specific values with the ones needed.

# vim /etc/apache2/sites-available/vteddy.conf

In the end the file should have the following values set:

<VirtualHost *:80>

ServerAdmin webmaster@your_domain
ServerName your_domain
DocumentRoot /var/www/html/vteddy

ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined


Save and exit the file. Now activate the virtual host configuration:

# a2ensite vteddy

Restart Apache for the changes to take effect:

# /etc/init.d/apache2 restart

You can now finish your VTEDDY installation by opening your favorite web browser and navigate to: http://your_domain/

You will be welcomed by VTEDDY configuration wizard.


Press install and proceed with the installation. Further, the system will check your PHP configurations. You need to make sure that the required values are in compliance with present values. The recommended PHP settings are not mandatory, so if they are not complied, the installation will not stop. For your reference if there are values that need to be changed, you need to edit the /etc/php5/apache2/php.ini file. Of course after editing, don’t forget to restart your Apache web server for the changes to take effect.

After the system check, you will need to set the system configuration in the next window. Enter the MySQL values from the MySQL database that you created, set your URL, admin password, email and finish the installation.

When the installation is successful you will be welcomed by the following:


Congratulations, you have successfully installed VTEDDY on your Ubuntu 14.04 server. After your first login, you will be asked to set the outgoing mail server. Please check this article for more information about first configuration of VTEDDY.

Of course you don’t have to do any of this if you use one of our Linux VPS Hosting services, in which case you can simply ask our expert Linux admins to install VTEDDY for you.They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

Leave a Comment

To prove you are human please solve the following *