DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones AWS Cloud
by AWS Developer Relations
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones
AWS Cloud
by AWS Developer Relations
11 Monitoring and Observability Tools for 2023
Learn more
  1. DZone
  2. Data Engineering
  3. Databases
  4. Step-By-Step Guide to Setting up A Local SuiteCRM Instance

Step-By-Step Guide to Setting up A Local SuiteCRM Instance

Check out the easy installation and configuration process for installing SugarCRM locally.

Moiz Arif user avatar by
Moiz Arif
·
Mar. 05, 19 · Tutorial
Like (5)
Save
Tweet
Share
5.69K Views

Join the DZone community and get the full member experience.

Join For Free

SuiteCRM is a software fork of the SugarCRM. SuiteCRM is a free and open source Customer Relationship Management Software. It is one of the most popular alternatives to the famous paid SugarCRM and SalesForce.

In order to test SuiteCRM, one can either subscribe for a demo instance which only lasts a couple of days. If more time is required for SuiteCRM testing, there are a couple of options including deploying pre-baked SuiteCRM instances on Amazon AWS, Microsoft Azure, Alibaba Cloud, and Google Cloud Platform. One can also setup his/her own SuiteCRM instance on either any of these public cloud platforms or on local servers.

In this article, we will deploy a manual SuiteCRM instance on Ubuntu 16.04 LTS. We assume that you have a Ubuntu 16.04LTS instance already setup and ready to use.

1. Update all the software packages:

sudo apt-get update

2. Install the required software stack for SuiteCRM. This includes the LAMP stack and some additional PHP modules.

sudo apt-get install apache2 apache2-utils libapache2-mod-php php php-common php-curl php-xml php-json php-mysql php-mbstring php-zip php-imap libpcre3 libpcre3-dev zlib1g zlib1g-dev mariadb-server unzip

3. Start the Apache service

sudo systemctl start apache2

4. Start MariaDB service

sudo systemctl start mysql

5. Enable Apache and MariaDB services to automatically start at system boot.

sudo systemctl enable apache2
sudo systemctl enable mysql   

enable services on Linux.png

6. Secure the MariaDB instance by running the following script. Enter the root password and select options as per requirement.

sudo mysql_secure_installation

Secure Installation.png

SuiteCRM requires the max upload file size to be 6 MB. In order to make this change in PHP open the file /etc/php/7.0/apache2/php.ini with your favorite editor and set upload_max_filesize = 6M.

apache php max upload size.png

7. Restart the Apache service.

sudo systemctl restart apache2

8. Create a database that will save all the data related to SuiteCRM.

sudo mysql -u root -p

MariaDB [(none)]> CREATE DATABASE suitecrm;
MariaDB [(none)]> CREATE USER 'bluestack'@'localhost' IDENTIFIED BY 'bluestack';
MariaDB [(none)]> GRANT ALL PRIVILEGES ON suitecrm.* TO 'bluestack'@'localhost';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> exit;

create MariaDB database.png













9. Download the latest SuiteCRM files available here. For this blog, we will use the SuiteCRM version 7.10.7

wget https://suitecrm.com/files/160/SuiteCRM-7.10.7/297/SuiteCRM-7.10.7.zip

Download SuiteCRM.png

10. Unzip the downloaded file

sudo unzip SuiteCRM-7.10.7.zip -d /var/www/html/
sudo mv /var/www/html/SuiteCRM-7.10.7 /var/www/html/suitecrm

11. Assign appropriate permission to the unzipped folder

sudo chown -R www-data:www-data /var/www/html/suitecrm
sudo chmod -R 755 /var/www/html/suitecrm

12. Open your internet browser and enter any of the below URL:

http://<instance-ipv4-address>/suitecrm/install.php
http://localhost/suitecrm/install.php

13. On the first screen, accept the license agreement by checking the checkbox and click on Next.

SuiteCRM License Agreement.png

14. Verify all the system environment parameters and ensure that there are no errors displayed.

SuiteCRM Installation parameters.png

15. Enter the database name, hostname, username and password. Also, specify the Admin user details on the right side of the screen.

SuiteCRM installation Database details.png

Note: You can choose to configure the “More Options” section now or leave it out for later.

16. Click next on the screen, make sure there are no errors.

SuiteCRM installation Summary.png

17. Enter the admin credentials on the SuiteCRM login screen.

SuiteCRM login Screen.png

18. Now you are logged into the SuiteCRM instance and you can now start to configure and use your instance.

SuiteCRM installation Home Page.png

19. Setup crontab for SuiteCRM:

sudo crontab -e -u www-data

20. Add the following line:

*    * *    * * cd /var/www/html/suitecrm; php -f cron.php > /dev/null 2>&1

Conclusion

Many organizations prefer being absolutely sure that they are investing in the right product and that they can ensure full adoption. This is a great way to have a group of people start using SuiteCRM and get a feel of what this powerful platform has to offer. We encourage readers to get started with SuiteCRM and start thinking towards customizing SuiteCRM according to the business and personal needs.

Open source Customer relationship management Software Internet Browser (Nintendo 3DS) Cloud MariaDB Database

Published at DZone with permission of Moiz Arif. See the original article here.

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Real-Time Analytics for IoT
  • Container Security: Don't Let Your Guard Down
  • GitLab vs Jenkins: Which Is the Best CI/CD Tool?
  • Cloud Performance Engineering

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: