{"id":26668780,"url":"https://github.com/brazil-data-cube/sits-docker","last_synced_at":"2025-10-09T06:08:16.963Z","repository":{"id":44666564,"uuid":"330053690","full_name":"brazil-data-cube/sits-docker","owner":"brazil-data-cube","description":"Docker images for the SITS R package","archived":false,"fork":false,"pushed_at":"2023-11-06T18:24:09.000Z","size":1628,"stargazers_count":8,"open_issues_count":2,"forks_count":4,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-12T01:56:24.581Z","etag":null,"topics":["docker","earth-observation","earth-science","giscience","r","rstudio","sits","time-series"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","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/brazil-data-cube.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}},"created_at":"2021-01-16T00:39:29.000Z","updated_at":"2023-06-21T14:28:59.000Z","dependencies_parsed_at":"2024-01-12T04:53:49.275Z","dependency_job_id":"0aa3ae72-d663-4e43-9cb9-54f66732f4a6","html_url":"https://github.com/brazil-data-cube/sits-docker","commit_stats":{"total_commits":122,"total_committers":6,"mean_commits":"20.333333333333332","dds":0.5983606557377049,"last_synced_commit":"d0a419536b60448e0be7ad763c3311c8ce4f794b"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/brazil-data-cube/sits-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Fsits-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Fsits-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Fsits-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Fsits-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brazil-data-cube","download_url":"https://codeload.github.com/brazil-data-cube/sits-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brazil-data-cube%2Fsits-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000853,"owners_count":26082950,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["docker","earth-observation","earth-science","giscience","r","rstudio","sits","time-series"],"created_at":"2025-03-25T21:35:00.102Z","updated_at":"2025-10-09T06:08:16.940Z","avatar_url":"https://github.com/brazil-data-cube.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SITS Docker Images \u003cimg src=\".github/logo/sits-docker-sticker.png\" align=\"right\" width=\"150\"/\u003e\n\n[![Software License](https://img.shields.io/badge/license-MIT-green)](https://github.com//brazil-data-cube/sits-docker/blob/master/LICENSE) [![Software Life\nCycle](https://img.shields.io/badge/lifecycle-maturing-blue.svg)](https://www.tidyverse.org/lifecycle/#maturing) [![Release](https://img.shields.io/github/tag/brazil-data-cube/sits-docker.svg)](https://github.com/brazil-data-cube/sits-docker/releases) [![Docker Image Version (latest by date)](https://img.shields.io/docker/v/brazildatacube/sits?label=Docker%20Hub)](https://hub.docker.com/r/brazildatacube/sits) [![Docker Pulls](https://img.shields.io/docker/pulls/brazildatacube/sits)](https://hub.docker.com/r/brazildatacube/sits) [![Join us at\nDiscord](https://img.shields.io/discord/689541907621085198?logo=discord\u0026logoColor=ffffff\u0026color=7389D8)](https://discord.com/channels/689541907621085198#)\n\nThis is the official repository of Docker images for the [SITS R package](https://github.com/e-sensing/sits). In this repository, you can find the recipes to build RStudio-based and Jupyter-based environments to use the SITS package.\n\n## Available images\n\nThe `composable images` approach was adopted in this repository to facilitate the construction of SITS-enabled environments that allow the full use of the SITS package features. In this approach, following a hierarchical structure, the installations and configurations are done at different levels. The lower level provides the base capabilities and resources for the higher level images. Because of this, the relationship of these images generates a tree of dependencies, which is presented below.\n\n\u003cbr/\u003e\n\u003cdiv align=\"center\"\u003e\n \u003cimg src=\".github/arch/sits-docker-arch.png\" width=\"640\"/\u003e\n\u003c/div\u003e\n\u003cbr/\u003e\n           \nIn total, five images are available, with the following responsibilities:\n\n- `SITS Base`: Provides the base resources for building an **R** environment to allow the use of the SITS package (e.g., OS libraries for compiling geospatial dependencies, resources for using `LaTeX`, etc);\n- `SITS R`: Provides an environment with **R** installed along with all the libraries and dependencies needed to use SITS (e.g., `gdal`, `terra`, `sf`). It does not include the SITS package;\n- `SITS`: Provides installation of the SITS package;\n- `SITS Rstudio`: RStudio environment with SITS-enabled;\n- `SITS Jupyter`: Jupyter Notebook environment with SITS-enabled. It also provides access to an RStudio Server.\n\nIf you want to get started, see below for a step-by-step guide to using the `RStudio` and `Jupyter Notebook` images that are ready to use and are available on [DockerHub](https://hub.docker.com/u/brazildatacube). However, you can also build these images on your machine if you prefer. To do this, see the `Building the Docker Image` section.\n\n## Using the SITS R Package with RStudio \u003cimg src=\".github/logo/sits-docker-env-rstudio.png\" align=\"right\" width=\"120\"/\u003e\n\nTo use the RStudio environment with SITS-enabled, you can run a container from the [brazildatacube/sits-rstudio:1.4.1](https://hub.docker.com/r/brazildatacube/sits-rstudio) image, which is made available on DockerHub. For this, the following command can be used:\n\n```shell\ndocker run --detach \\\n           --publish 127.0.0.1:8787:8787 \\\n           --name my-sits-rstudio \\\n           brazildatacube/sits-rstudio:1.4.1\n```\n\nThen, open the URL `http://127.0.0.1:8787` in a web browser:\n\n```shell\nfirefox http://127.0.0.1:8787\n```\n\n\u003e To login use `sits` as user and password.\n\n## Using the SITS R Package with Jupyter Notebook \u003cimg src=\".github/logo/sits-docker-env-jupyter.png\" align=\"right\" width=\"120\"/\u003e\n\n\u003e In this image, its available the Jupyter Notebook environment together with RStudio.\n\nTo use the Jupyter Notebook environment with SITS-enabled, you can run a container from the [brazildatacube/sits-jupyter:1.4.1](https://hub.docker.com/r/brazildatacube/sits-jupyter) image, which is made available on DockerHub. For this, the following command can be used:\n\n```shell\ndocker run --detach \\\n           --publish 127.0.0.1:8888:8888 \\\n           --name my-sits-jupyter \\\n           brazildatacube/sits-jupyter:1.4.1\n```\n\nAfter running the above command, it is necessary to recover the Jupyter access token. To do this, use the command below:\n\n```shell\ndocker exec -it my-sits-jupyter jupyter lab list\n```\n\nThe Jupyter server should respond with a message that looks like this:\n\n```\nCurrently running servers:\nhttp://cea9535dd267:8888/?token=d8817e283ad216ef1d920bb5cdd125a1cd104c4374df20bf :: /home/sits\n```\n\nUse the access token shown on your server output to access the Jupyter environment in your browser at the local address of the host machine. Example:\n\n```shell\nfirefox http://127.0.0.1:8888/?token=d8817e283ad216ef1d920bb5cdd125a1cd104c4374df20bf\n```\n\n## Building the Docker Images\n\nTo build the images with the Dockerfiles contained in this repository, it is possible to use the `build.sh` utility script. This script presents options for the customization of the images generated for the use of the SITS package. The script has the following options that can be used to customize the generated images:\n\n- `-n`: Build with `--no-cache` flag (Default uses pre-built image cache).  \n- `-t`: SITS Tag version used in generated image (Default is `1.4.1`).\n- `-p`: Image name prefix (Default is `bdc`).\n- `-e`: SITS environment type (`full` or `minimal`. Default is `full`).\n- `-h`: show a help message.\n\n\nBelow is an example of using the utility script. The tag name defined for the SITS image is `1.4.1`.\n\n```shell\n./build.sh -n -p brazildatacube -t 1.4.1\n```\n\nThe above command will create the following images:\n\n```shell\ndocker image ls | grep sits\n```\n\n```\nbrazildatacube/sits-jupyter   1.4.1     c84b566b3919   7 days ago          9.82GB\nbrazildatacube/sits-rstudio   1.4.1     1a5bfbfb0493   7 days ago          9.56GB\nbrazildatacube/sits           1.4.1     e5a8029eb6c1   7 days ago          8.75GB\nbrazildatacube/sits-r         1.4.1     f6d54ebcb385   7 days ago          6.2GB\nbrazildatacube/sits-base      1.4.1     2ef474f5c2fa   7 days ago          3.57GB\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrazil-data-cube%2Fsits-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrazil-data-cube%2Fsits-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrazil-data-cube%2Fsits-docker/lists"}