{"id":15132793,"url":"https://github.com/qbituniverse/iot-admin","last_synced_at":"2026-02-13T07:40:02.617Z","repository":{"id":257653411,"uuid":"858118016","full_name":"qbituniverse/iot-admin","owner":"qbituniverse","description":"IoT admin tools for managing solutions running in Docker on Raspberry Pi.","archived":false,"fork":false,"pushed_at":"2024-10-09T14:00:51.000Z","size":509,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T08:51:36.111Z","etag":null,"topics":["docker","iot","raspberry-pi"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":false,"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/qbituniverse.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}},"created_at":"2024-09-16T10:43:37.000Z","updated_at":"2024-10-09T14:00:55.000Z","dependencies_parsed_at":"2024-09-18T00:02:57.455Z","dependency_job_id":"aa7d46fe-4315-48f4-943a-8bd4883d5dbf","html_url":"https://github.com/qbituniverse/iot-admin","commit_stats":null,"previous_names":["qbituniverse/iot-admin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbituniverse%2Fiot-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbituniverse%2Fiot-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbituniverse%2Fiot-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qbituniverse%2Fiot-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qbituniverse","download_url":"https://codeload.github.com/qbituniverse/iot-admin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248578874,"owners_count":21127714,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["docker","iot","raspberry-pi"],"created_at":"2024-09-26T04:40:25.960Z","updated_at":"2025-10-03T22:49:25.284Z","avatar_url":"https://github.com/qbituniverse.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IoT Admin\n\nAdmin tools to manage Raspberry Pi deployment. Allows access to control GPIO pins directly on the Pi.\n\n## Application Design\n\n![IoT.Admin](/.docs/IoT.Admin.Application.png)\n\n## Hardware Specification\n\n|Component|Description|\n|-----|-----|\n|Raspberry Pi|Raspberry Pi 4 Model B Rev 1.5, 4GB RAM\u003cbr /\u003eLinux 6.1.0-rpi4-rpi-v8\u003cbr /\u003eDebian GNU/Linux 12 (bookworm)\u003cbr /\u003earm64 architecture|\n\n## Projects\n\n|Name|Description|\n|-----|-----|\n|[IoT.Admin.Domain](/.docs/IoT.Admin.Domain.md)|Domain project containing reusable models, modules and data repositories.|\n|[IoT.Admin.Api](/.docs/IoT.Admin.Api.md)|Api (REST) project used to control the Raspberry Pi GPIO pins.|\n|[IoT.Admin.Web](/.docs/IoT.Admin.Web.md)|Web app project used to control the Raspberry Pi GPIO pins through the IoT.Admin.Api.|\n\n## Deployment\n\nThe easiest way to deploy the IoT Admin application is to run the [docker-compose.yaml](/.cicd/compose/docker-compose.yaml) Docker Compose file with the following command. This will deploy all the containers, volumes and networking on the Docker instance.\n\n```bash\ndocker compose -f docker-compose.yaml --env-file vars.env up -d\n```\n\nTo remove the IoT Admin application from Docker instance, use this command. This will remove all the containers, volumes and networking from Docker instance.\n\n```bash\ndocker compose -f docker-compose.yaml --env-file vars.env down\n```\n\nThe [vars.env](/.cicd/compose/vars.env) file provides all the environment specific configuration for the application. Use this table below as guide to configure the deployment.\n\n|Key|Values|Description|\n|-----|-----|-----|\n|ENVIRONMENT|Development, Test, Production|Defines the release environment.|\n|COMPOSE_PROJECT_NAME|dev-iot-admin, test-iot-admin, prod-iot-admin|This is used to prefix resources and set environmental boundaries for the application components. It allows to run Dev, Test and Prod simultaneously on the same Docker instance at the same time and not clash with each other.|\n|COMPOSE_PROFILES|Mock, SQLite, MySql, MongoDb|Defines which application components are created and used as backend data storage, i.e. SQLite, or MySql or MongoDb database or Mock in-memory only hard-coded data samples.|\n|DB_DIR_SQLITE|C:\\Path\\SQLite or /home/path/sqlite|SQLite database folder location where the database artifacts are stored.|\n|DB_PORT_SQLITE|30xx, ex. 3007|Port number to access SQLite database.|\n|DB_DIR_MYSQL|C:\\Path\\MySql or /home/path/mysql|MySql database folder location where the database artifacts are stored.|\n|DB_PORT_MYSQL|33xx, ex. 3307|Port number to access MySql database.|\n|DB_DIR_MONGODB|C:\\Path\\MongoDb or /home/path/mongodb|MongoDb database folder location where the database artifacts are stored.|\n|DB_PORT_MONGODB|270xx, ex. 27007|Port number to access MongoDb database.|\n|DB_PWD|Password|Password to access the database, only applicable to MySql _root_ user.|\n|API_PORT|80xx, ex. 8001|Port to access the Api.|\n|WEB_PORT|80xx, ex. 8004|Port to access the Web app.|\n|LOGLEVEL_CONSOLE|Verbose, Debug, Information, Warning, Error, Fatal|Log levels for the console output.|\n|LOGLEVEL_DATABASE|Verbose, Debug, Information, Warning, Error, Fatal|Log levels to log in the Database.|\n|GPIO|Mock, Pi|Define if the application is wired to Raspberry Pi or just in a Mock mode.|\n\n## Modules\n\n### Gpio\n\nUse to control GPIO pins running on the Raspberry Pi.\n\n|Type|Description|\n|-----|-----|\n|Mock|Module is controlled through mock calls, no Pi required.|\n|Pi|Module is executing GPIO commands on the Pi. Raspberry Pi is required for this.|\n\n## Repository\n\nBackend database details, used across all projects in the Admin solution.\n\n|Object|Name|Description|\n|-----|-----|-----|\n|**Database**|IotAdmin|Main database name for the IoT Admin solution.|\n|**Tables**|ApiLogs|Store the API execution logs.|\n||WebLogs|Store the Web app execution logs.|\n\n### Configuration\n\n|Name|Description|\n|-----|-----|\n|Mock|Defaults to *empty string (\"\")*. Hard coded in-memory, stateless, mock calls to sample data set, no data persistance.\u003cbr /\u003e Connection string is not required.|\n|SQLite|SQLite backed database that is stored on a host machine file system as _.db_ file.\u003cbr /\u003eCommunication with the database through a file system.\u003cbr /\u003eDefault SQLite deployment doesn't configure any user credentials and can be accessed without such permissions.\u003cbr\u003e_NOTE: Works on AMD and ARM architectures_.|\n|SQLite.Url|PATH_TO_DATABASE\\DATABASE_NAME.db|\n|MySql|MySql backed database that can run either in Docker container or as standalone installation on the machine.\u003cbr /\u003eCommunication with the database is on port _33xx_ over the network (IP Address) or localhost (127.0.0.1).\u003cbr /\u003eUse the default _root_ account and password of your choice that is configured during MySql database deployment.\u003cbr\u003e_NOTE: Works on AMD and ARM architectures_.|\n|MySql.Url|Server=127.0.0.1;Port=33xx;User ID=root;Password=YOUR_PASSWORD;Database=DATABASE_NAME|\n|MongoDb|MongoDb backed database that can run either in Docker container or as standalone installation on the machine.\u003cbr /\u003eCommunication with the database is on port _270xx_ over the network (IP Address) or localhost (127.0.0.1).\u003cbr /\u003eDefault MongoDb deployment doesn't configure any user credentials and can be accessed without such permissions.\u003cbr\u003e_NOTE: Works on AMD and ARM architectures (Pi 5 or higher)_.|\n|MongoDb.Url|mongodb://localhost:270xx|","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqbituniverse%2Fiot-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqbituniverse%2Fiot-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqbituniverse%2Fiot-admin/lists"}