# Import ICS

Import ICS is a Python container that downloads ICS (iCalendar) files on a schedule and imports them into named calendars on a CalDAV (Calendar Access Protocol) server for homelab calendar synchronization. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1815/import-ics

## Description

Import ICS is a Python container that downloads ICS (iCalendar) files on a schedule and imports them into named calendars on a CalDAV (Calendar Access Protocol) server for homelab calendar synchronization.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

12/100 (Low), based on 4 of 4 factors.
- Maintained: 0 (last commit 1627 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (16 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/repository/docker/vilhjalmr26/import_ics
- GitHub: https://github.com/Vilhjalmr26/import_ics
- Unraid: https://ca.unraid.net/apps/import-ics-0yapf241wz72v4?q=import_ics

## Common questions

### How do I tell import_ics which calendars to import from which ICS URLs?

It uses a calendar_download_map.py file in the config path, where each key is the calendar name and each value is the ICS URL.

### Can import_ics import an ICS file that is not fetched from a URL?

Yes. Put the file in the /config/ical_export folder with the name calendar_name.ics, and the script will import it into calendar_name.

### What CalDAV connection settings must be configured?

Set ICS_USERNAME, ICS_PASSWORD, and ICS_URL for the CalDAV server.

### How do I control when import_ics runs and which timezone it uses?

Set CRONTAB_SCHEDULE to a crontab time string, such as 0 0 * * *, and TZ to a timezone like America/Chicago.

---
Source: Our Local Host (https://ourlocalhost.com/app/1815/import-ics), the self-hosted and open-source app directory.
