If you have a LAMP (Linux, Apache, MySQL and PHP), WAMP (Windows, Apache, MySQL and PHP) MAMP (MAcOs, Apache, MySQL and PHP) installed, you can proceed to install Sugar-CE (if you haven’t done this previously with the Stack Installers for Sugar Community Edition – which includes Sugar-CE).
SugarCRM Community Edition
First: Download Sugar-CE files (zip file)
Then: Copy Sugar files to the web server
Now Continue ...
After you download Sugar, you need to unzip the files and set permissions.
1. Locate your webroot directory on your Web server.
This is the directory on your Web server where publicly accessible files are made available by your Web server. Common locations for Web root include:
• for Linux/Apache:
/var/www/html/
• for Windows/IIS:
C:\Inetpub\wwwroot\
• for MacOS X/Apache:
C:\Program Files\Apache Group\Apache\htdocs\ (Windows/Apache)/Library/Webserver/Documents/
2. Unzip the Sugar zip file into your webroot.
A directory is automatically created within webroot.
3. Rename this directory at any time.
4. Set permissions on the Sugar files.
The following directories, all subdirectories, and files must be writable by your Web server user:
• cache
• custom
• data
• modules
• config.php
For example:
"chgrp ApacheUser.ApacheGroup <SugarInstallRoot> -R" recursively sets ownership for root directory to apache user and group.
“chmod 755 <SugarInstallRoot> -R" recursively sets permissions to Read/Write, Execute for the owner, and Read/Execute for everyone else.
The system user that your Web server uses to access files in your webroot varies depending on your operating system configuration. Common Web server users include:
• apache (Linux/Apache)
• nobody (Linux/Apache)
• IUSR_computerName (Windows/IIS)
If you are unsure of your Web server user, consult your system administrator.
5. Prior to viewing Sugar through the browser, ensure that file permissions are set for Read/Execute to “includes” directory and “sugar root directory “(in addition to the already existing list of directories/files).
Using the Sugar Setup Wizard
After you copy the Sugar files into your web root, you can use the Sugar Setup Wizard. The Sugar URL http://<yourServer>/<yourSugarDirectory>/install.php is the URL you will use to access the Sugar Setup Wizard.
For example: http://localhost/Sugar-Full_6.0.0/install.php
You can perform a typical installation or a custom installation. While typical installation is recommended, you can choose custom installation for the following reasons:
- You do not want to use the same Database Admin User as the Sugar database administrator.
- You want to specify the locale settings during installation instead of specifying it after you log into the Sugar application.
To perform a typical installation of Sugar
1. Launch the browser and enter the URL described above.
Sugar displays the Welcome page.
The Installer displays installation instructions and requirements to help determine if you can successfully install Sugar.
The Installer displays the Sugar License Agreement screen.
The installer checks the system for compatibility and then displays the Installation Options screen.
Note: At any time prior to clicking Install in the Confirm Setting menu, you can modify any of your settings. To modify any settings, click the Back button to get back to the
appropriate screen.
6. Click Next.
The Database Type screen displays next.
7. Select the database that is installed on your system and click Next.
The Database Configuration screen displays next.
Click to enlarge |
a. Enter the database name. The Installer uses sugarcrm as the default name for the database. However, you can specify a new name for the database.
b. For My SQL and SQL Server, enter the Host Name or the Host Instance.
c. If your database server is running on the same machine as your Web server, the host name is, by default, set to localhost.
d. Enter the username and password for the Database Administrator. Then, specify the Sugar Database Username.
e. Ensure that the Database Administrator you specify has the permissions to create and write to the Sugar database.
For MySQL and SQL Server, by default, the Installer selects the Admin User as the Sugar Database User. The Sugar application uses Sugar Database User to communicate with the Sugar database. But, at this time, you can create a different Sugar Database user.
To select an existing user, choose Provide existing user from the Sugar Database Username drop-down list. To create a new Sugar Database user, choose Define user to create. Enter the database user name and password in the fields that display below. Reenter the password to confirm it. This new user information will display under “System Credentials” on the Confirm Settings page at the end of the installation process.
f. Accept No as the default value if you do not want the Sugar Demo data. If not, select Yes to specify that you want to populate the database with the Sugar Demo data.
8. Click Next.
The Installer validates the credentials of the specified administrator. If a database with that name already exists, it displays a dialog box asking you to either accept the database name or choose a new database. If you use an existing database name, the database tables will be dropped.
9. Click Accept to accept the database or else click Cancel and enter a new name in the Database Name field.
The Installer displays the Site Configuration screen on the page.
This is the user who will have administrative privileges in Sugar. The default name is “admin”, but you can change it.
11. Enter a password for the Sugar admin, re-enter it to confirm the password, and click Next. The Installer displays the Confirm Settings screen. This screen displays a summary of the settings that you specified. If you want to change the settings, click Back to navigate to the previous screens.
12. To obtain a printout of the settings for your records, click Print Summary.
To include the database user password and the Sugar admin password in the printout, click Show Passwords and then click Print Summary. When you click Show Passwords, the system displays the passwords and changes the button name to Hide Passwords. You can click this button to hide the passwords again.
13. To begin the installation process, click Install.
The Perform Setup page displays the installation progress on the screen.
14. When the setup is complete, click Next.
15. The Installer displays the Registration page on the screen.
Registration is optional.
16. To register your Sugar instance with SugarCRM, enter the necessary information and click Send Registration; or else click No Thanks to skip registration.
Click to enlarge |
17. Congratulations! You have successfully completed the SugarCRM installation. Your application is ready to use. You will need to log in for the first time using the "admin" as user name and the password you entered during the setup.