{"id":20777766,"url":"https://github.com/fiware/tutorials.step-by-step","last_synced_at":"2026-01-27T19:05:07.201Z","repository":{"id":54139484,"uuid":"140250033","full_name":"FIWARE/tutorials.Step-by-Step","owner":"FIWARE","description":"Tutorials for the complete 𝑭𝑰𝑾𝑨𝑹𝑬 ecosystem for developers wishing to learn how to use NGSI-v2 and NGSI-LD and design context-based Smart Systems 𝒑𝒐𝒘𝒆𝒓𝒆𝒅-𝒃𝒚-𝑭𝑰𝑾𝑨𝑹𝑬.","archived":false,"fork":false,"pushed_at":"2026-01-26T08:22:45.000Z","size":2566,"stargazers_count":78,"open_issues_count":4,"forks_count":71,"subscribers_count":13,"default_branch":"master","last_synced_at":"2026-01-26T22:36:57.865Z","etag":null,"topics":["contextual-data","fiware","ngsi","ngsi-ld","ngsi-v2","tutorial"],"latest_commit_sha":null,"homepage":"https://fiware.github.io/tutorials.Step-by-Step/","language":null,"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/FIWARE.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"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":null,"dco":null,"cla":null}},"created_at":"2018-07-09T07:51:17.000Z","updated_at":"2026-01-26T08:22:49.000Z","dependencies_parsed_at":"2023-02-19T05:30:47.497Z","dependency_job_id":"4dd0d660-edb2-4de7-8d1d-03025b187f4d","html_url":"https://github.com/FIWARE/tutorials.Step-by-Step","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/FIWARE/tutorials.Step-by-Step","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Ftutorials.Step-by-Step","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Ftutorials.Step-by-Step/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Ftutorials.Step-by-Step/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Ftutorials.Step-by-Step/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FIWARE","download_url":"https://codeload.github.com/FIWARE/tutorials.Step-by-Step/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FIWARE%2Ftutorials.Step-by-Step/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28819063,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T18:44:20.126Z","status":"ssl_error","status_checked_at":"2026-01-27T18:44:09.161Z","response_time":168,"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":["contextual-data","fiware","ngsi","ngsi-ld","ngsi-v2","tutorial"],"created_at":"2024-11-17T13:17:05.683Z","updated_at":"2026-01-27T19:05:07.185Z","avatar_url":"https://github.com/FIWARE.png","language":null,"readme":"# Step-by-Step Tutorials[\u003cimg src=\"/img/logo.png\" align=\"left\" width=\"162\"\u003e](https://www.fiware.org/)\n\n[![License: MIT](https://img.shields.io/github/license/fiware/tutorials.Step-by-Step.svg)](https://opensource.org/licenses/MIT)\n[![Support badge](https://img.shields.io/badge/tag-fiware-orange.svg?logo=stackoverflow)](https://stackoverflow.com/questions/tagged/fiware)\n\nThis is an umbrella repository which holds collections of  **NGSI-v2** and **NGSI-LD** tutorials for developers wishing to \nlearn about the [FIWARE](https://www.fiware.org/) ecosystem and allow users and developers to easily navigate to the relevant \nsource code, documentation and Docker images.\n\n\u003c!--- GLOBAL SUMMIT BANNER AD\n| \u003ca href=\"https://www.fiware.org/global-summit/\"\u003e\u003cimg src=\"https://fiware.github.io//catalogue/img/Summit23.png\" width=\"240\" height=\"70\" /\u003e\u003c/a\u003e | \u003ca href=\"https://www.eventbrite.com/e/fiware-on-site-training-tickets-591474775977\"\u003e\u003cimg src=\"https://fiware.github.io//catalogue/img/Training23.png\" width=\"240\" height=\"70\" /\u003e\u003c/a\u003e |\n| --- | --- |\n---\u003e\n\n---\n\n\u003e [!NOTE]\n\u003e  ### Should I be using NGSI-v2 or NGSI-LD?\n\u003e \n\u003e  FIWARE offers two flavours of the NGSI interfaces:\n\u003e\n\u003e  -  **NGSI-v2** offers JSON based interoperability used in individual Smart Systems\n\u003e  -  **NGSI-LD** offers JSON-LD based interoperability used for Federations and Data Spaces\n\u003e\n\u003e  NGSI-v2 is ideal for creating individual applications offering interoperable interfaces for web services or IoT devices. It is easier to understand than NGSI-LD and does not require a [JSON-LD\n`@context`](https://www.w3.org/TR/json-ld11/#the-context).\n\u003e\n\u003e  However, NGSI-LD and Linked Data is necessary when creating a data space or introducing a system of systems aproach, and in situations requiring\n\u003e  interoperability across apps and organisations.\n\n---\n\n## [\u003cimg src=\"https://img.shields.io/badge/NGSI-v2-5dc0cf.svg\" width=\"90\"  align=\"left\" /\u003e](\"https://fiware-ges.github.io/orion/api/v2/stable/) Smart Supermarket\n\nThis is a collection of tutorials for the FIWARE ecosystem designed for **NGSI-v2** developers. Each tutorial,  based around a \nSmart Supermarket  consists of a series of exercises to demonstrate the correct use of individual FIWARE components using **NGSI-v2**\ninterfaces and shows the flow of context data within a simple Smart Solution either by connecting to a series of dummy IoT devices \nor manipulating the context directly or programmatically.\n\n| :movie_camera: [Introduction\u003cbr\u003eto NGSI-v2](https://www.youtube.com/watch?v=pK4GgYjlmdY)| :books: [NGSI-v2 Tutorial\u003cbr\u003eDocumentation](https://fiware-tutorials.rtfd.io) | \n| -------------------------------------------------------------------- | --- |\n\n\n🇯🇵 このチュートリアルは[日本語](https://fiware-tutorials.letsfiware.jp/)でもご覧いただけます。\u003cbr/\u003e\n\n## [\u003cimg src=\"https://img.shields.io/badge/NGSI-LD-d6604d.svg\" width=\"90\"  align=\"left\" /\u003e](\"https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf) Smart Farm\n\nThis is a collection of tutorials for the FIWARE ecosystem designed for **NGSI-LD** developers. Linked data concepts are explained\nusing the entities from a Smart Farm. Each tutorial then demonstrates the correct use of individual FIWARE components via the **NGSI-LD**\ninterface and shows the flow of context data within a simple Smart Solution either by connecting to a series of dummy IoT devices or \nmanipulating the context directly or programmatically.\n\n| :movie_camera: [Introduction\u003cbr\u003eto Linked Data](https://www.youtube.com/watch?v=4x_xzT5eF5Q) |  :movie_camera: [Introduction\u003cbr\u003eto NGSI-LD](https://www.youtube.com/watch?v=rZ13IyLpAtA) | :books: [NGSI-LD Tutorial\u003cbr\u003eDocumentation](https://ngsi-ld-tutorials.rtfd.io/) | \n|---| ---------------------------------------------------------------------- | --- |\n\n---\n\n## Install\n\nTo download the full set of tutorials, simply clone this repository:\n\n```console\ngit clone https://github.com/FIWARE/tutorials.Step-by-Step.git\ncd tutorials.Step-by-Step/\ngit submodule update --init --recursive\n```\n\nThe **NGSI-v2** and **NGSI-LD** tutorials are then available under the `NGSI-v2` and `NGSI-LD` directories respectively.\n\n### Docker and Docker Compose \u003cimg src=\"https://www.docker.com/favicon.ico\" align=\"left\"  height=\"30\" width=\"30\"\u003e\n\nEach tutorial runs all components using [Docker](https://www.docker.com). **Docker** is a container technology which\nallows to different components isolated into their respective environments.\n\n-   To install Docker on Windows follow the instructions [here](https://docs.docker.com/docker-for-windows/)\n-   To install Docker on Mac follow the instructions [here](https://docs.docker.com/docker-for-mac/)\n-   To install Docker on Linux follow the instructions [here](https://docs.docker.com/install/)\n\n**Docker Compose** is a tool for defining and running multi-container Docker applications. A series of `*.yaml` files\nare used configure the required services for the application. This means all container services can be brought up in a\nsingle command. Docker Compose is installed by default as part of Docker for Windows and Docker for Mac, however Linux\nusers will need to follow the instructions found [here](https://docs.docker.com/compose/install/)\n\nYou can check your current **Docker** and **Docker Compose** versions using the following commands:\n\n```console\ndocker-compose -v\ndocker version\n```\n\nPlease ensure that you are using Docker version 24.0.x or higher and Docker Compose 2.24.x or higher and upgrade if\nnecessary.\n\n### Postman \u003cimg src=\"https://raw.githubusercontent.com/FIWARE/tutorials.Step-by-Step/master/img/postman.svg\" align=\"left\"  height=\"30\" width=\"30\"\u003e\n\nThe tutorials which use HTTP requests supply a collection for use with the Postman utility. Postman is a testing\nframework for REST APIs. The tool can be downloaded from [www.getpostman.com](https://www.postman.com/downloads/). All the FIWARE\nPostman collections can downloaded directly from the\n[Postman API network](https://explore.postman.com/team/3mM5EY6ChBYp9D)\n\n\n### Apache Maven \u003cimg src=\"https://maven.apache.org/favicon.ico\" align=\"left\"  height=\"30\" width=\"30\" style=\"border-right-style:solid; border-right-width:10px; border-color:transparent; background: transparent\"\u003e\n\n[Apache Maven](https://maven.apache.org/download.cgi) is a software project management and comprehension tool. Based on\nthe concept of a project object model (POM), Maven can manage a project's build, reporting and documentation from a\ncentral piece of information. Maven can be used to define and download our dependencies and to build and package Java or\nScala code into a JAR file.\n\n### Windows Subsystem for Linux\n\nWe will start up our services using a simple bash script. Windows users should download the\n[Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/install) to provide a command-line\nfunctionality similar to a Linux distribution on Windows.\n\n---\n\n## License\n\n[MIT](LICENSE) © 2018-2024 FIWARE Foundation e.V.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiware%2Ftutorials.step-by-step","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiware%2Ftutorials.step-by-step","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiware%2Ftutorials.step-by-step/lists"}