{"id":18782711,"url":"https://github.com/gatblau/boot","last_synced_at":"2026-05-15T20:03:11.389Z","repository":{"id":98867916,"uuid":"294167499","full_name":"gatblau/boot","owner":"gatblau","description":"merge environment variables in static configuration files before launching docker containers","archived":false,"fork":false,"pushed_at":"2021-01-03T09:24:46.000Z","size":14706,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-02T16:47:28.028Z","etag":null,"topics":["boot","configuration-files","docker-image","environment-variables","merge"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gatblau.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":"2020-09-09T16:23:10.000Z","updated_at":"2021-01-03T09:24:48.000Z","dependencies_parsed_at":"2023-04-17T21:14:33.416Z","dependency_job_id":null,"html_url":"https://github.com/gatblau/boot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gatblau/boot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gatblau%2Fboot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gatblau%2Fboot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gatblau%2Fboot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gatblau%2Fboot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gatblau","download_url":"https://codeload.github.com/gatblau/boot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gatblau%2Fboot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33077947,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["boot","configuration-files","docker-image","environment-variables","merge"],"created_at":"2024-11-07T20:36:51.988Z","updated_at":"2026-05-15T20:03:11.356Z","avatar_url":"https://github.com/gatblau.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://icon-icons.com/icon/boot-stomp/39342\"\u003e\u003cimg src=\"boot.png\" alt=\"By Lorc, Delapouite \u0026 contributors\" width=\"100\" height=\"100\" align=\"right\" /\u003e\u003c/a\u003e\n\n# BOOT\n\n*BOOT* is a utility that merges environment variables into (configuration) files. It is designed to pass environment variables to applications with static configuration files running inside Docker containers.\n\nIt is an alternative to overlaying the configuration file on the container on start up.\n\nSimply:\n\n- add environment variable placeholders into the files\n- export environment variables with the required values\n- call *boot* passing the file names to be updated\n- launch your app\n\n## Getting Started\n\n1. Download the *boot* utility platform specific versions from [here](./build).\n\n2. Create a bootstrap file to merge the variables and launch the app like follows:\n\n```shell script\n# start.sh\n/app/boot /app/conf1 /app/conf2 ...\nexec \"$@\"\n```\n\n3. Copy boot and the configuration with placehoslders to the docker image\n\n4. Call the bootstrap script from the CMD line (mosquitto mqtt broker example):\n   \n```dockerfile   \nCMD [\"sh\", \"/app/start.sh\", \"/app/mosquitto\", \"-c\", \"/app/mosquitto.conf\"]\n```\n\n## Merging Vars\n\ngiven the following *test.cfg* config file:\n\n```shell script\ncfg1=${ENV_VAR_1}\n# ADS2 is a default value\ncfg2=${ENV_VAR_2:ASD2}\ncfg3=${ENV_VAR_3}\ncfg4=${ENV_VAR_4}\n```\n\non the command line run:\n\n```shell script\n# export environment variables\n# note no variable ENV_VAR_2 is defined \nexport ENV_VAR_1=AAA\nexport ENV_VAR_3=CCC\nexport ENV_VAR_4=DDD\n\n# merge variables in the config file\n./boot test.cfg\n```\n\ncheck the contents of the file:\n\n```shell script\ncfg1=AAA\n# merged default\ncfg2=ASD2\ncfg3=CCC\ncfg4=DDD\n```\n\n**NOTE**: using \"PWD\" as environemtn variable is not allowed as it can retrieve the path of the current process in some OS.\n\nIf no variables are exported the execution will fail.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgatblau%2Fboot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgatblau%2Fboot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgatblau%2Fboot/lists"}