Easy Chat Room is a Joomla component. This guide covers installing it, the first-run setup, and where to go next.
Before you start
Make sure your site meets the requirements:
- Joomla 4.x +
- PHP 7.4 or higher
- MySQL or MariaDB
You will also need administrator access to your Joomla site.
Installing the component
- Sign in to your Joomla administrator area.
- Go to System → Install → Extensions.
- Upload the Easy Chat Room installation package (the
.zipfile you downloaded). - Wait for Joomla to confirm a successful install. The component's database tables are created automatically during installation.
Easy Chat Room stores its own data in tables that begin with #__ecr_. These are created for you — you do not need to set up any database manually.
Opening the chat for the first time
- In the Joomla administrator menu, go to Components → Easy Chat Room.
- The Easy Chat Room dashboard opens. This is your control centre for everything in the next guides.
First-run setup checklist
Work through these once after installing:
- General settings — set your site name, description, and timezone. See General Settings.
- Create a chat room — you need at least one room for people to chat in. See Creating and Managing Chat Rooms.
- Add a menu item — in Joomla, create a menu item that points to Easy Chat Room so visitors can reach the chat.
- Email — set up email sending so password resets and notifications work. See Email and SMTP Settings.
- Registration — decide whether people can register, and whether guests are allowed. See Registration and Guest Mode.
The download package includes all the libraries Easy Chat Room needs. If you installed from a developer build and the component reports missing libraries, a developer can run Composer inside components/com_easychatroom/chatroom/libraries. A standard package install never needs this step.
Updating later
Install a newer version the same way you installed the first one — upload the new package through System → Install → Extensions. Joomla detects it as an update and applies any database changes automatically. Your settings, rooms, and messages are kept.