{"id":13401784,"url":"https://github.com/open-condo-software/condo","last_synced_at":"2026-05-04T09:02:24.706Z","repository":{"id":36958417,"uuid":"337513916","full_name":"open-condo-software/condo","owner":"open-condo-software","description":"Condo is an Open Source property management SaaS that allows users to manage tickets, resident contacts, properties, payment tracking, create invoices, and oversee a service marketplace, all while offering an extension system for mini-apps, making it an ideal platform for property management companies and those servicing shared properties.","archived":false,"fork":false,"pushed_at":"2026-04-30T11:54:11.000Z","size":246333,"stargazers_count":337,"open_issues_count":106,"forks_count":116,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-04-30T12:12:24.841Z","etag":null,"topics":["community-management","condominium","condominium-management","crm","household","intercom","jira","pms","property","property-management","property-management-system","property-manager","proptech","real-estate","saas","support","ticketing-system","zendesk"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/open-condo-software.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2021-02-09T19:31:06.000Z","updated_at":"2026-04-30T11:44:36.000Z","dependencies_parsed_at":"2023-09-22T10:58:22.562Z","dependency_job_id":"93afed53-625c-4b00-9d9e-7026c13920ab","html_url":"https://github.com/open-condo-software/condo","commit_stats":{"total_commits":11681,"total_committers":63,"mean_commits":185.4126984126984,"dds":0.8653368718431641,"last_synced_commit":"eaa579097167eaf1bb5a88dc28442a67791b72eb"},"previous_names":[],"tags_count":1052,"template":false,"template_full_name":"8iq/nodejs-hackathon-boilerplate-starter-kit","purl":"pkg:github/open-condo-software/condo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-condo-software%2Fcondo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-condo-software%2Fcondo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-condo-software%2Fcondo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-condo-software%2Fcondo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/open-condo-software","download_url":"https://codeload.github.com/open-condo-software/condo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/open-condo-software%2Fcondo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32600968,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T22:12:39.696Z","status":"online","status_checked_at":"2026-05-04T02:00:06.625Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["community-management","condominium","condominium-management","crm","household","intercom","jira","pms","property","property-management","property-management-system","property-manager","proptech","real-estate","saas","support","ticketing-system","zendesk"],"created_at":"2024-07-30T19:01:07.096Z","updated_at":"2026-05-04T09:02:24.670Z","avatar_url":"https://github.com/open-condo-software.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Project Categories"],"sub_categories":[],"readme":"# CONDO\n\n[Condo](https://github.com/open-condo-software/condo) is an Open Source property management SaaS \nthat allows users to manage tickets, resident contacts, properties, \npayment tracking, create invoices, and oversee a service marketplace, \nall while offering an extension system for mini-apps, \nmaking it an ideal platform for property management companies and those servicing shared properties.\n\n![condo](./docs/images/condo-preview.png)\n\n## Table of contents\n- [Getting started](#getting-started)\n    1. [Databases setup](#1-databases-setup)\n    2. [Environment setup](#2-environment-setup)\n    3. [Installing dependencies](#3-installing-dependencies)\n    4. [Building `@open-condo` dependencies](#4-building-open-condo-dependencies) \n    5. [Preparing the local app environment](#5-preparing-the-local-app-environment)\n    6. [Starting app in dev / prod mode](#6-start-app-locally-in-dev--prod-mode)\n    7. [Starting the worker](#7-start-the-worker)\n- [Developing](/docs/develop.md)\n- [Contributing](/docs/contributing.md)\n- [Migration guides](/docs/migration.md)\n- [Deploying](/docs/deploy.md)\n\n## Getting started\n\n### 1. Databases setup\n\nWe use [Postgres 16.4](https://www.postgresql.org) to store most of the information, \nand [Redis 6.2](https://redis.io) to store session information, asynchronous tasks, and various caches. \nIn addition to them, we use s3 to store files, but it is optional to get started.\n\nYou can start the databases using docker compose with this command:\n\n```bash\ndocker compose up -d postgresdb redis\n```\n\nOr you can bring up the databases directly on the host machine, using the corresponding tutorials\n\n### 2. Environment setup\n\n#### Node.js 22.x\n\nAll of our applications are written in [Node.js](https://nodejs.org/en), \nso you should also install it before you run the project.\n\n\u003e We run our applications on the **current LTS** version of node, which is **22.x**. \n\u003e You can check node version using `node -v` command in your terminal.\n\nWe recommend using [nvm](https://github.com/nvm-sh/nvm) for local development, \nand for deploying the application there is [Dockerfile](https://github.com/open-condo-software/condo/blob/main/Dockerfile)\nready to use at the root of the repository.\n\n#### Python 3.x\n\nWe also use Python with packages for database migrations. So make sure you have one installed. \n\n### 3. Installing dependencies\n\nTo install Node.js dependencies simply type the following command:\n```bash\nyarn install\n```\n\n\u003e If you get errors related to missing yarn, \n\u003e use [these instructions](https://yarnpkg.com/getting-started/install) to install it.\n\n\u003e We also use [turborepo](https://turbo.build/repo/docs) to orchestrate npm modules in this monorepo. \n\u003e Even though it is specified in the global `package.json`, in some environments you may get the error \n\u003e `“turbo: command not found”` in further steps... \n\u003e \n\u003e In such cases, we recommend installing it globally using:\n\u003e ```bash\n\u003e npm i -g turbo@^2\n\u003e ```\n\n\nTo install python packages type the command:\n```bash\npip install Django psycopg2-binary\n```\n\n### 4. Building `@open-condo` dependencies\n\nCondo depends on several packages located in `./packages` directory, \nso it is required to build them before launching the main application. \nYou can do it using this command:\n\n```bash\nyarn workspace @app/condo build:deps\n```\n\n### 5. Preparing the local app environment\n\nWe have a mechanism in place to get applications ready for launch, specifically:\n1. Copy the global and local .env.example to .env\n2. Create a database for each application and perform the necessary migrations in it\n3. Assign dedicated ports to the applications\n4. Run the local prepare of each application\n\n\u003e During the \"local prepare\" step each app prepares itself by filling extra environment variables, \n\u003e creating test users and other entities, needed for the first launch.\n\nTo launch prepare script, run the following command:\n```bash\nnode bin/prepare -f condo\n```\n\n\u003e This step is only used in local development,\n\u003e so consider manually setting all environment variables\n\u003e and migrating databases using `yarn workspace @app/condo migrate` in real deployment pipelines.\n\n### 6. Start app locally in dev / prod mode\n\n\n#### Development mode\n\nThe application is now fully ready to be started. \nTo start the application locally in development mode, simply run the following command:\n```bash\nyarn workspace @app/condo dev\n```\n\n#### Production mode\n\nIf, however, you want to build the app in production mode, then to do so, execute:\n```bash\nyarn workspace @app/condo build\n```\n\nAnd then run the project with:\n```bash\nyarn workspace @app/condo start\n```\n\nNow open your browser and navigate to http://localhost:4006, where you should see the app running 🥳. \n\n\u003e You can control the port assigned by manually setting it in `apps/condo/.env` file. \n\u003e Default one is assigned by prepare script during the prepare step\n\u003e (You can verify the `SERVER_URL` and `PORT` in the `apps/condo/.env` file)\n\nTo log in, go to http://localhost:4006/admin/signin and enter the following credentials:\n- **Email:** `DEFAULT_TEST_ADMIN_IDENTITY`\n- **Password:** `DEFAULT_TEST_ADMIN_SECRET`\n\nThese credentials can be found in the `app/condo/.env` file, which is generated by the `./bin/prepare.js` script.\n\n### 7. Start the worker\n\nWorker is a separate process that handles asynchronous tasks (such as sending notifications, importing, exporting and others)\n\nTo run it, you need to first build the application using:\n```bash\nyarn workspace @app/condo build\n```\n\nAnd then start it using:\n```bash\nyarn workspace @app/condo worker\n```\n\n## Major version migration guide\n\nCheck [migration.md](docs/migration.md)\n\n## Developing\n\nCheck [developing.md](docs/develop.md)\n\n## Contributing\n\nCheck [contributing.md](docs/contributing.md)\n\n## Major versions migration guide\n\nCheck [migration.md](docs/migration.md)\n\n\n## Deploying\n\nCheck [deploy.md](docs/deploy.md)\n\n## Open Source partners\n\n - This project is tested with [BrowserStack](https://www.browserstack.com/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-condo-software%2Fcondo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopen-condo-software%2Fcondo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopen-condo-software%2Fcondo/lists"}