{"id":40103577,"url":"https://github.com/imshibaji/jobs-api-server","last_synced_at":"2026-02-17T21:07:24.241Z","repository":{"id":325011771,"uuid":"1099224134","full_name":"imshibaji/jobs-api-server","owner":"imshibaji","description":"This is the Jobs API Server by Shibaji Debnath.","archived":false,"fork":false,"pushed_at":"2026-01-10T19:24:26.000Z","size":2249,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T05:48:28.150Z","etag":null,"topics":["api-server","backend","backend-api","backend-services","content-management-system","jobs-api","jobsearch","jobsystem","open-source","server"],"latest_commit_sha":null,"homepage":"","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/imshibaji.png","metadata":{"files":{"readme":"README.Docker.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-18T18:17:47.000Z","updated_at":"2025-12-10T06:15:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/imshibaji/jobs-api-server","commit_stats":null,"previous_names":["imshibaji/jobs-api-server"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/imshibaji/jobs-api-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshibaji%2Fjobs-api-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshibaji%2Fjobs-api-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshibaji%2Fjobs-api-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshibaji%2Fjobs-api-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imshibaji","download_url":"https://codeload.github.com/imshibaji/jobs-api-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imshibaji%2Fjobs-api-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28565948,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T08:53:44.001Z","status":"ssl_error","status_checked_at":"2026-01-19T08:52:40.245Z","response_time":67,"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":["api-server","backend","backend-api","backend-services","content-management-system","jobs-api","jobsearch","jobsystem","open-source","server"],"created_at":"2026-01-19T11:08:19.246Z","updated_at":"2026-01-19T11:08:22.039Z","avatar_url":"https://github.com/imshibaji.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jobs Portal API Server Application\n\nThis is the Fullstack Jobs Portal Applications APIs. If you wanted to launch your own Jobs Portal then you can use this for your application backend. It is An Open Source Project.\n\n## Description\n\n[Jobs Portal API](https://github.com/imshibaji/jobs-api-server) is based on a [NestJS](https://github.com/nestjs/nest) framework TypeScript starter repository. It is an open source project that anyone can use to launch their own Jobs Portal. Here you can find all the resources you need to get started with the project. \n\n## Environment Variables\n\nTo run this project, you will need to create a `.env` file and add the following environment variables:\n\n```bash\nAPP_NAME=\"Jobs API Server\"\nAPP_VERSION=\"1.0.0\"\nAPP_ENVIRONMENT=development\nAPP_PORT=3300\nAPP_SECRET_KEY=\u003cyour-secret-key\u003e\n\nDB_TYPE=postgres\nDB_HOST=localhost\nDB_PORT=5432\nDB_USER=root\nDB_PASS=password\nDB_NAME=jobs_api_server\nDB_SYNC=true\n\nREDIS_HOST=localhost\nREDIS_PORT=6379\nREDIS_USER=default\nREDIS_PASS=password\nREDIS_DB=1234\n\nSMTP_HOST=smtp.gmail.com\nSMTP_PORT=587 # or 465\nSMTP_USER=admin@gmail.com\nSMTP_PASS=password\nSMTP_SECURITY=TLS # or SSL\n\n\nWHATSAPP_NUMBER=\u003cyour-number\u003e\nSMS_NUMBER=\u003cyour-number\u003e\n```\n\n## Deployment Process with Docker\nIf you wanted to Quickly deploy this Project on Docker then you can follow these steps:\n\ncreate a `docker-compose.yml` file in the root directory of the project.\n\nthen copy the following content into the file:\n```yaml\nserver:\n    image: imshibaji/jobs-api-server:latest\n    container_name: jobs-server\n    restart: unless-stopped\n    env_file:\n      - .env\n    environment:\n      NODE_ENV: production\n    ports:\n      - 3300:3300\n    volumes:\n      - ./uploads:/app/uploads:rw\n    depends_on:\n      db:\n        condition: service_healthy\n      redis:\n        condition: service_healthy\n\n  db:\n    image: postgres:17\n    restart: always\n    user: postgres\n    volumes:\n      - db_data:/var/lib/postgresql/data\n    environment:\n      - POSTGRES_DB=jobs_api_server\n      - POSTGRES_PASSWORD=Spaceranger@123\n    ports:\n      - 5433:5432\n    healthcheck:\n      test: [ \"CMD\", \"pg_isready\" ]\n      interval: 10s\n      timeout: 5s\n      retries: 5\n\n  redis:\n    image: redis:latest\n    restart: always\n    ports:\n      - 6378:6379\n    volumes:\n      - redis_data:/data\n    healthcheck:\n      test: [ \"CMD\", \"redis-cli\", \"ping\" ]\n      interval: 10s\n      timeout: 5s\n      retries: 5\n    environment:\n      - REDIS_PASSWORD=Spaceranger@123\n\nvolumes:\n  server_app:\n    driver: local\n  db_data:\n  redis_data:\n\nnetworks:\n  proxy:\n    external:\n      name: proxy\n```\n\nthen run the following command:\n\n1. copy .env.example file to .env file\n2. Then run `docker compose up -d` command\n3. Then run `docker compose logs -f` command\n4. Then open `http://localhost:3300` in your browser\n5. Check Project Status with `docker compose ps` command\n\n## For upgrading the project \n1. Run `docker compose down` command for stopping the project\n2. Run `docker compose pull` command for updating the project\n3. Run `docker compose up -d` command for starting the project\n\n\nUse this Process to deploy this Project on Docker Easily.\n\nYou can also modify the `Dockerfile` to fit your needs.\n\nBut if you wanted to more control then you can modify the `docker-compose.yaml` file.\n\n## How to use\n\n1. Register a new user\n2. Then login to your account\n3. Get Access Token and Set Authorization Header\n4. Then you can use the API endpoints\n\n## API Endpoints\n\n```bash\n# Register a new user\nPOST /auth/register\n\n# Login a user\nPOST /auth/login\n\n# Get all jobs\nGET /jobs\n\n# Get a single job\nGET /jobs/:id\n\n# Create a new job\nPOST /jobs\n\n# Update a job\nPUT /jobs/:id\n\n# Delete a job\nDELETE /jobs/:id\n\n# Many more API endpoints are available in the project source code\n```\n\n## Hosting on VPS\nYou can deploy your Project on VPS with [Hostinger](https://www.hostinger.in/cart?product=vps%3Avps_kvm_2\u0026period=12\u0026referral_type=cart_link\u0026REFERRALCODE=SHIBAJIDEBNATH\u0026referral_id=019b06a2-98e8-7397-8bd6-f7b0e0cb1dc6). It a very cost-effective and easy-to-use platform for deploying NestJS applications on Hostinger.\n\nIf want to get offer then you can use [Hostinger Offer](https://www.hostinger.in/cart?product=vps%3Avps_kvm_2\u0026period=12\u0026referral_type=cart_link\u0026REFERRALCODE=SHIBAJIDEBNATH\u0026referral_id=019b06a2-98e8-7397-8bd6-f7b0e0cb1dc6) for your project from this link.\n\n\n## Setup Jobs API Server on VPS\n\n1. Create a VPS on [Hostinger](https://www.hostinger.in/cart?product=vps%3Avps_kvm_2\u0026period=12\u0026referral_type=cart_link\u0026REFERRALCODE=SHIBAJIDEBNATH\u0026referral_id=019b06a2-98e8-7397-8bd6-f7b0e0cb1dc6)\n2. Choose your plan and click on checkout\n3. Enter your details and click on checkout\n4. Setup your VPS with Docker\n5. Then Follow this Process to [Setup Jobs API Server](#deployment-process-with-docker) on Docker Easily\n\n## Deployment with Docker\n\nYou can deploy This Project on Docker with [Docker](https://www.docker.com/). It a very cost-effective and easy-to-use platform for deploying NestJS applications on Docker.\n\n## Resources\n\nYou wanted to Modify and Contribute to this Project then you can find all the resources you need to get started with the project:\n\n- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework.\n\n- Visit the [Docker documentation](https://docs.docker.com) to learn more about Docker. \n- For deployment, you can use [Docker Compose](https://docs.docker.com/compose/).\n\n\n\n## Stay in touch\nIf you have any questions or feedback about this project.\n\nAlso you need any setup help, please don't hesitate to reach out to me.\n\n- Author - [Shibaji Debnath](https://shibajidebnath.com)\n- Project - [Jobs API Server](https://github.com/imshibaji/jobs-api-server)\n- LinkedIn - [LinkedIn](https://www.linkedin.com/in/shibaji/)\n\n## License\n\nJobs API Server is [MIT licensed](https://github.com/imshibaji/jobs-api-server/blob/main/LICENSE).\n\n![License: GNU GPL v3](https://img.shields.io/badge/License-gpl3.0-blue.svg)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimshibaji%2Fjobs-api-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimshibaji%2Fjobs-api-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimshibaji%2Fjobs-api-server/lists"}