Liferay Portal is an open source enterprise web platform for building business solutions that deliver immediate results and long-term value. Liferay Portal started out as a personal development project in 2000 and was open sourced in 2001.

To get started, check out the project's homepage at portal.liferay.dev!

Liferay Portal is built from the source code found in liferay-portal repository and several other related open source projects. It includes features for end users, business professionals, system administrators, and enterprise developers.

• Modular architecture for maximum flexibility and reliability
• Portal features for managing users, groups, and permissions
• Single page applications for blazingly fast performance
• Rich web services for integrating with other systems
• Web content management including Personalization and Content Targeting
• Documents and rich media management
• Mobile development platform
• Business forms and workflow
• Collaboration features such as blogs, wikis, and social networking
• Consistent and powerful Lexicon user experience
• Integrated development environment using Liferay Dev Studio

For more details on these and other features, please refer to the user guide or developer guide

To get up and running quickly, follow the steps below:

1. Download a pre-built Liferay Portal release bundled with Tomcat.

2. Download and install Java (JDK) 8 (if necessary) in your local environment.

3. Extract the downloaded pre-built Liferay Portal bundle into a folder.

4. Navigate to the bundle's liferay-ce-portal-[version]/tomcat-[version]/bin folder and execute startup.bat (Windows) or startup.sh (Unix/Linux/Mac OS X), depending on your operating system.

5. A server console opens, which starts your Liferay Portal instance. Once your instance is ready to use, the portal URL address (http://localhost:8080) is automatically opened in your default browser.

6. You're presented a Basic Configuration page. Complete the configuration options.

   Liferay Portal uses an embedded database (HSQL) to make installation fast and easy. This database is not ready for production, so consider configuring a production-ready database (e.g., MySQL) if you plan on doing more than just exploring/testing.

7. Agree to the terms and conditions, create a password, and configure a security question/answer.

You can now use Liferay Portal!

For more detailed installation instructions, refer to the deployment guide.

If you wish to build core Liferay Portal or its plugins, read Building Liferay Portal from source code. It includes details on using the repositories and building the software.

The Liferay Portal website is the best place to learn about Liferay Portal.

It has over 200 tutorials, guided learning, and much more. Developer documentation explains

• How to build various applications,
• How to use provided frameworks
• How to customize existing features
• How to solve common challenges,

It is also your place to learn hot to participate in making Liferay Portal better:

• How to report an issue.
• How to request new features
• How to provide feedback
• How to help a fellow developer
• How to help with translations

If you create apps that you want to share or sell, you can visit Liferay Marketplace Developer Portal to learn how to publish apps to the Liferay Marketplace.

Liferay Portal's main source code resides in the liferay-portal repository. Liferay maintains many other repositories related to features and supporting documentation.

Liferay Portal releases are built from the liferay-portal repository. You can build Liferay Portal, its modules, and/or any of the other supporting technologies from their respective folders/repositories.

There are many ways for you to learn what's new in Liferay Portal, get answers to questions, and connect with other Liferay community members.

Follow us on Twitter:

• @Liferay tweets Liferay's latest announcements
• @LiferayDocs tweets about new articles and tutorials
• @LiferayEng tweets from the core engineering and Developer Relations team
• @liferaydesign tweets from Liferay UI/UX designers
• @liferayfaces tweets from Liferay Faces team

Read our announcements, engage in discussions, and learn more by following Liferay's Blog Stream.

Do you have questions? Ask them on our very active forums!

Join the conversation on Liferay's Community Chat.

• Get your invite: https://liferay.dev/chat
• Enter the chat: liferay-community.slack.com
• Channel: #portal

Liferay welcomes any and all contributions! Please read the CONTRIBUTING guide for details on developing and submitting your contributions.

For transparency and insight into Liferay's release cycle, and for striving to maintain backward compatibility, we make a strong effort to uphold the versioning for our software. See the Semantic Versioning article for more information about how Liferay versions software.

If you need professional consultation or help with Liferay and your business, check out the offerings from Liferay, Inc. and its partner network.

Liferay Portal is produced by the worldwide Liferay engineering team, and involves many hours of development, testing, writing documentation, and working with the wider Liferay community of customers, partners, and open source developers. We are glad you have chosen Liferay Portal, and hope that it meets or exceeds your expectations!

In addition to Liferay's engineering staff, a special thanks goes to the many open source developers who volunteer their time and energy to help with the release, whether it was bug fixing, idea generation, documentation, translations, or other contributions that helped to improve this release.

SPDX-License-Identifier: LGPL-2.1-or-later

Liferay Portal Community Edition is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 2.1 of the License, or (at your option) any later version.

Liferay Portal Community Edition is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with Liferay Portal Community Edition. If not, see https://www.gnu.org/licenses/