{"id":20486282,"url":"https://github.com/undp-data/geo-cogserver","last_synced_at":"2025-04-13T15:21:15.606Z","repository":{"id":199430764,"uuid":"702869023","full_name":"UNDP-Data/geo-cogserver","owner":"UNDP-Data","description":"GeoHub COG server","archived":false,"fork":false,"pushed_at":"2025-02-24T05:15:06.000Z","size":162,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T06:13:15.345Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UNDP-Data.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":"2023-10-10T07:03:06.000Z","updated_at":"2025-02-24T05:12:38.000Z","dependencies_parsed_at":"2023-12-06T14:27:18.784Z","dependency_job_id":"86cb08f7-ce91-4174-b072-283d5adb8f31","html_url":"https://github.com/UNDP-Data/geo-cogserver","commit_stats":null,"previous_names":["undp-data/geo-cogserver"],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fgeo-cogserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fgeo-cogserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fgeo-cogserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UNDP-Data%2Fgeo-cogserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UNDP-Data","download_url":"https://codeload.github.com/UNDP-Data/geo-cogserver/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248733214,"owners_count":21152979,"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":[],"created_at":"2024-11-15T16:35:55.940Z","updated_at":"2025-04-13T15:21:15.585Z","avatar_url":"https://github.com/UNDP-Data.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Geohub's COGserver\nGeoHub COG server is powering UNDP GeoHub visualization of raster datasets\n\nCOG server builds on [titiler](https://github.com/developmentseed/titiler) a customisable dynamic raster tiling.\nIt contains following components:\n\n- [x] COG tiler - render tiles from COG's\n  - [x] create STAC item from COG\n- [x] MosaicJSON tiler - create/render MosaicJSON docs \n- [x] STAC tiler - render STAC items\n- [ ] Multiband tiler - render heterogenous COGs \n\nAdditionally, **COG server** aims to hold generic and specific [titiler algos](https://devseed.com/titiler/advanced/Algorithms/)\nintended to provide a geospatial analytics toolbox\n\n# versioning \u0026 realeases\n\nAs per [titiler's](https://github.com/developmentseed/titiler) recommendation\nCOGserver employs the titiler's API to build a customised server and keeps its own versioning\nsystem.\n\nReleases ca be created by:\n\na) pushing tags\n   1. commit your changes in a branch \n       ```bash\n            git checkout -b branch_name\n            git add .\n            git commit -m \"a message\"\n            \n       ```\n   2. make and merge the branch through a PR\n   3. create a local tag and push it to remote\n       ```bash\n          git tag -a v0.0.1 -m \"v0.0.1\"\n          git push --tag\n       ```\n   4. potentially delete/overwrite \n       ```bash\n          git push --delete origin v0.0.1 #remote\n          git tag -d v0.0.1 #local\n       ```\n# local development\n\nThe server's config variables are defined in [.env](.env). To create `.env` file, please copy `env.example` file by using the command of `cp .env.example .env`. By passing this file at runtime to \ndocker-compose the server can be started using:\n\n```commandline\n docker-compose --env-file .env up --build\n \n \n docker compose  run --build --rm --service-ports  cogserver\n```\n\n[gdal_rio.env](/gdal_rio.env) contains several important environmental variables.\nSOme oare related to teh server/fastapi components while other to the\nGDAL/rasterio machinery\n\n```commandline\nHOST=0.0.0.0\nPORT=8000\n```\nThese two variables control the hostname and port number of the local dev server\nwhen started.\n\nThe [Dockerfile](/Dockerfile) contains two more environmental variables that control the behavious of the server\n\n```commandline\nENV LOG_LEVEL=info\nENV RELOAD=--reload\n```\nThe **RELOAD** if left empty will result in reloading being turned off which is desirable for production\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundp-data%2Fgeo-cogserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fundp-data%2Fgeo-cogserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundp-data%2Fgeo-cogserver/lists"}