{"id":21855626,"url":"https://github.com/zeropsio/recipe-nestjs","last_synced_at":"2026-02-13T06:04:06.906Z","repository":{"id":242591042,"uuid":"809985289","full_name":"zeropsio/recipe-nestjs","owner":"zeropsio","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-24T12:06:53.000Z","size":754,"stargazers_count":1,"open_issues_count":6,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-23T05:50:34.788Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/zeropsio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2024-06-03T20:40:31.000Z","updated_at":"2025-02-24T12:06:57.000Z","dependencies_parsed_at":"2024-11-28T02:17:04.695Z","dependency_job_id":"ded6e450-dbaa-49ed-85da-4f7d09fbb71a","html_url":"https://github.com/zeropsio/recipe-nestjs","commit_stats":null,"previous_names":["zeropsio/recipe-nestjs-backend","zeropsio/recipe-nestjs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zeropsio/recipe-nestjs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeropsio%2Frecipe-nestjs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeropsio%2Frecipe-nestjs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeropsio%2Frecipe-nestjs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeropsio%2Frecipe-nestjs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zeropsio","download_url":"https://codeload.github.com/zeropsio/recipe-nestjs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeropsio%2Frecipe-nestjs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29397594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-13T04:26:15.637Z","status":"ssl_error","status_checked_at":"2026-02-13T04:16:29.732Z","response_time":78,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2024-11-28T02:16:55.793Z","updated_at":"2026-02-13T06:04:06.892Z","avatar_url":"https://github.com/zeropsio.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Zerops x Nest.js\n[Nest.js](https://nestjs.com/) is an amazing and popular Node.js framework. This recipe aims to showcase, through a simple file upload demo application, advanced concepts that unlock the scalebility powers of Nest.js by running it on [Zerops](https://zerops.io/).\n\n![nestjs](https://github.com/zeropsio/recipe-shared-assets/blob/main/covers/svg/cover-nestjs.svg)\n\n\u003cbr/\u003e\n\n## Deploy on Zerops\nYou can either click the deploy button to deploy directly on Zerops, or manually copy the [import yaml](https://github.com/zeropsio/recipe-nestjs/blob/main/zerops-project-import.yml) to the import dialog in the Zerops app.\n\n[![Deploy on Zerops](https://github.com/zeropsio/recipe-shared-assets/blob/main/deploy-button/green/deploy-button.svg)](https://app.zerops.io/recipe/nestjs)\n\n\u003cbr/\u003e\n\n## Recipe features\n- Load balanced Nest.js API running on **Zerops Node.js** service\n- Zerops **PostgreSQL 16** service as database\n- Zerops **Object Storage** (S3 compatible) service as file system\n- **Idempotent** TypeORM database migrations setup\n- Logs set up to use **syslog** and accessible through Zerops GUI\n- Utilization of Zerops built-in **environment variables** system\n- [Mailpit](https://github.com/axllent/mailpit) as **SMTP mock server**\n- [Adminer](https://www.adminer.org) for **quick database management** tool\n\n\u003cbr/\u003e\n\n## Production vs. development\n\nBase of the recipe is ready for production, the difference comes down to:\n\n- Use highly available version of the PostgreSQL database (change `mode` from `NON_HA` to `HA` in recipe YAML, `db` service section)\n- Use at least two containers for the Nest.js service to achieve high reliability and resilience (add `minContainers: 2` in recipe YAML, `api` service section)\n- Use production-ready third-party SMTP server instead of Mailpit (change `SMTP_` secret variables in recipe YAML, `api` service section)\n- Disable public access to Adminer or remove it altogether (remove service `adminer` from recipe YAML)\n\n\u003cbr/\u003e\n\n## Changes made over the default installation\n\nIf you want to modify your existing Nest.js app to efficiently run on Zerops, these are the general steps we took:\n\n- Add [zerops.yml](https://github.com/zeropsio/recipe-nestjs/blob/main/zerops.yml) to your repository, our example includes health checks and idempotent migrations\n- Utilize Zerops environment variables management to securely pass [environment variables](https://github.com/zeropsio/recipe-nestjs/blob/main/src/config/db.config.ts#L8-L12) to your app\n- Add multer, aws-sdk packages and [utilize them](https://github.com/zeropsio/recipe-nestjs/blob/main/src/file/file.service.ts#L26-L36) to upload files to S3 compatible Zerops object storage\n\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\nNeed help setting your project up? Join [Zerops Discord community](https://discord.com/invite/WDvCZ54).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeropsio%2Frecipe-nestjs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeropsio%2Frecipe-nestjs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeropsio%2Frecipe-nestjs/lists"}