---
title: Installation
url: 'https://docs.joomdonation.com/oscalendar/getting-started/installation'
markdown: 'https://docs.joomdonation.com/oscalendar/getting-started/installation.md'
date: '2026-10-11'
description: '[TOC] This section covers how to install OS Calendar. Prerequisites Before installing OS Calendar, make sure you have: A working Joomla 4.x / 5.x / 6.x installation. (Optional) OS Property, only if you want to use OS Calendar together with OS Property. It is not required for standalone use. Insta…'
taxonomy:
  category:
    - docs
---

[](#) [ edit this page](https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/pages/01.getting-started/03.installation/docs.md) 

# Installation

\[TOC\] This section covers how to install OS Calendar.

## Prerequisites

Before installing OS Calendar, make sure you have:

1. A working Joomla 4.x / 5.x / 6.x installation.
2. *(Optional)* **OS Property**, only if you want to use OS Calendar together with OS Property. It is not required for standalone use.

## Install OS Calendar

Download the OS Calendar package from our website after purchasing. The package file is named similar to `com_oscalendar.zip`.

To install:

1. Log in to your Joomla administrator panel (e.g. `http://www.mysite.com/administrator`).
2. Go to **Extensions → Extension Manager**.
3. Click the **Browse** button and select the file `com_oscalendar.zip`.
4. Click **Upload & Install**.

After successful installation you will see a success confirmation message. OS Calendar will appear under **Components → OS Calendar** in the administrator menu.

After installation, continue with [Operating Modes](https://docs.joomdonation.com/oscalendar/getting-started/operating-modes) to choose how you will use OS Calendar, then follow **Frontend Booking Setup**.

> > > > **Notice:** Do not uninstall the old version before installing a new one. Installing a newer version over the existing one is a safe upgrade that preserves all your booking data and configuration.

## Install the Availability Search Module

The package also includes `mod_ospropertyavailabilitysearch`, a front-end search module that allows visitors to search **OS Property** listings by available check-in / check-out dates.

The module is installed automatically with the main package. It is intended for sites that use OS Property. In standalone mode you do not need it — use the **Booking Search** menu item instead (see **Frontend Booking Setup**). If you use OS Property, go to **Extensions → Modules**, find **OS Property Availability Search**, and publish it to the desired module position.

## Upgrade OS Calendar

When a new version of **OS Calendar** is released, you will see an update notification in the OS Calendar Dashboard.

There are two ways to upgrade:

**A. Manual upgrade**

1. Download the latest package from our website (**My Downloads** section after login).
2. Install it the same way as a new installation via **Extensions → Extension Manager**.
3. Your data and configuration will not be affected.

**B. Automatic update from back-end**

1. Register a Download ID at: <https://www.joomdonation.com/download-ids.html>
2. Enter the Download ID in **OS Calendar → Configuration → Upgrade tab → Download ID** field.
3. Go to **Extensions → Manage → Update** to update to the latest version automatically.

> > > > > **Tip:** Before any upgrade, back up your site using [Akeeba Backup](https://www.akeebabackup.com/products/akeeba-backup.html) or a similar tool so you can roll back if anything goes wrong.

 [ ](https://docs.joomdonation.com/oscalendar/getting-started/requirements) [](https://docs.joomdonation.com/oscalendar/getting-started/operating-modes)

---

## Navigation

- Parent: [Getting Started](https://docs.joomdonation.com/oscalendar/index.md)
- Previous: [Requirements](https://docs.joomdonation.com/oscalendar/getting-started/requirements.md)
- Next: [Operating Modes](https://docs.joomdonation.com/oscalendar/getting-started/operating-modes.md)
