Website | Maintainers | Community & Forum | Code of Conduct
SuiteCRM is the award-winning open-source, enterprise-ready Customer Relationship Management (CRM) software application.
Our vision is to be the most adopted open source enterprise CRM in the world, giving users full control of their data and freedom to own and customise their business solution.
Find out more about SuiteCRM 8 and checkout the online demo here
Visit the Administration Guide for details on getting started, system compatibility, and installing SuiteCRM 8.
Prerequisites:
- PHP version 7.3 or later
- MySQL version 5.7 or later
- Apache or Nginx web server
Step-by-Step Installation:
- Download the latest release of SuiteCRM from the GitHub Releases page.
- Unzip the downloaded file into your desired directory on the server.
- Set the correct file permissions to ensure your web server can access the SuiteCRM files:
- Use
chown
andchmod
commands to set ownership and permissions appropriately.
- Use
- Access the installation wizard by navigating to your server’s address (e.g.,
http://localhost/suitecrm
) in your browser. - Follow the on-screen instructions to complete the installation process.
Troubleshooting Tips:
- If you encounter permission issues during installation, verify the web server has access rights to the SuiteCRM files.
- If database connection problems arise, confirm that the MySQL service is running and that you are using correct credentials.
See the Release Notes for more detail and known issues in the beta build.
For contributors who wish to fork and modify SuiteCRM, setting up a development environment is straightforward. Follow these steps:
- Clone the repository:
git clone https://github.com/salesagility/SuiteCRM.git
. - Navigate into the SuiteCRM directory.
- Install the necessary dependencies using
composer install
andnpm install
. - Set up a local database and run migrations using the required commands.
- Run the development server for testing using
npm run dev
.
For detailed setup instructions, visit the Developer Guide.
We would love to have your feedback and input to help make SuiteCRM 8 great for everyone.
SuiteCRM 8 is still in active development, and all current releases are not yet production-ready, so be sure to check the Release Notes and list of Known Issues before getting involved.
How to Contribute:
- Fork the repository and clone it to your local machine.
- Create a new branch for your changes using
git checkout -b your-feature-branch
. - Make your changes in your local environment, following the coding standards outlined in the documentation.
- Submit a pull request (PR) once your changes are complete by following the GitHub workflow.
If you have found an issue you think we should know about, or have a suggestion/feedback, please Submit An Issue.
If you want to get involved or submit a Fix, fork the repo and when ready, please Submit A PR – more details for developers will be coming soon, so stay tuned.
We take security seriously here at SuiteCRM, so if you have discovered a security risk, report it by emailing security@suitecrm.com. This will be delivered to the product team who handle security issues.
Please don't disclose security bugs publicly until they have been handled by the security team.
Your email will be acknowledged within 24 hours during the business week (Mon - Fri), and you’ll receive a more detailed response to your email within 72 hours during the business week (Mon - Fri) indicating the next steps in handling your report.
SuiteCRM is an open-source project. If you require help with support, then please use our support forum. By using the forums, the knowledge is shared with everyone in the community. Our developer and community team members answer questions on the forum daily, but it also allows the other members of the community to contribute. If you would like customisations to specifically fit your SuiteCRM needs, then please visit the website.
SuiteCRM is published under the AGPLv3 license.