{"id":13561162,"url":"https://github.com/strangelove-ventures/heighliner","last_synced_at":"2025-12-29T23:48:16.591Z","repository":{"id":40492764,"uuid":"454589542","full_name":"strangelove-ventures/heighliner","owner":"strangelove-ventures","description":"Repository of docker images for the node software of Cosmos chains","archived":false,"fork":false,"pushed_at":"2025-03-31T16:02:14.000Z","size":512,"stargazers_count":60,"open_issues_count":18,"forks_count":59,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-03-31T17:02:27.367Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","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/strangelove-ventures.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":"2022-02-01T23:50:29.000Z","updated_at":"2025-03-31T16:02:16.000Z","dependencies_parsed_at":"2023-02-17T08:55:16.181Z","dependency_job_id":"5c0da905-3a8c-4003-be33-799f9c480209","html_url":"https://github.com/strangelove-ventures/heighliner","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Fheighliner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Fheighliner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Fheighliner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/strangelove-ventures%2Fheighliner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/strangelove-ventures","download_url":"https://codeload.github.com/strangelove-ventures/heighliner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247037115,"owners_count":20873098,"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-08-01T13:00:53.106Z","updated_at":"2025-12-29T23:48:16.564Z","avatar_url":"https://github.com/strangelove-ventures.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile"],"sub_categories":[],"readme":"\n🌌 Why use Heighliner?\n=============================\n\n![Heighliner photo](https://static.wikia.nocookie.net/dune/images/7/72/51mMK0akBOL._AC_SY400_-1.jpg/revision/latest)\n\nWe built Heighliner to streamline the management and building of production-grade container images for blockchain node software, Cosmos and beyond.\n\n🌌🌌 Who benefits from Heighliner?\n=============================\n\nHeighliner container images are useful for anyone who's responsible for infrastructure deployments like\n\n- validator + [horcrux](https://github.com/strangelove-ventures/horcrux),\n- full nodes,\n- archive nodes,\n- end-to-end testing ([interchaintest](https://github.com/strangelove-ventures/interchaintest)),\n- and more.\n\n🌌🌌🌌 What does Heighliner do?\n=============================\n\nHeighliner images are minimally constructed from scratch images, packaging only the chain binary and a useful reduced set of busybox utilities.\n\nThis repository has a CI/CD pipeline to automatically build images when new git tags are detected on the chain repos in [chains/](chains). These images are hosted as packages in the Github Container Registry (ghcr) [here](https://github.com/orgs/strangelove-ventures/packages?repo_name=heighliner)\n\n\n\n🌌🌌🌌🌌 How do I use Heighliner?\n=============================\n\n## Add a New Chain\n\nTo add a chain to the heighliner built-in configuration and have your chain images available on our repository's [ghcr](https://github.com/orgs/strangelove-ventures/packages?repo_name=heighliner), submit a PR adding it to the [chains directory](chains) so it will be included in the automatic builds.\n\nFor further instructions see: [addChain.md](./addChain.md)\n\n## Add Heighliner Images to your Chain Repo\n\nTo publish heighliner images on your chain repository and/or incorporate heighliner images into your chain repo's CI/CD flow, see [heighliner-build-action](https://github.com/strangelove-ventures/heighliner-build-action)\n\n## Build Your Own\n\nIf you would like to build the images yourself, heighliner is a CLI tool to help you do so.\nDownload the latest [release](https://github.com/strangelove-ventures/heighliner/releases), or build it yourself with:\n\n```shell\nmake build\n```\n\n## Build and put binary in path. \n\nIf you would like to build an image and put it in your local path , you can do the following.\n\n```shell\nmake install\n```\n\n\n\n#### Example: build the docker image for gaia v6.0.0:\n\n```shell\nheighliner build --chain gaia --git-ref v6.0.0\n```\n\nDocker image `heighliner/gaia:v6.0.0` will now be available in your local docker images\n\n#### Example: Cosmos SDK chain development cycle, build a local repository\n\n```shell\ncd ~/gaia-fork\nheighliner build -c gaia --local\n```\n\nDocker image `gaia:local` will be built and stored in your local docker images.\n\n#### Example: Build from a Github fork\n\n```shell\ncd ~/gaia-fork\nheighliner build -c gaia -o strangelove-ventures -g working_branch -t image_tag\n```\n\nHeighliner will build the `working_branch` branch from the `strangelove-ventures/gaia` github organization/repository. Docker image `gaia:image_tag` will be stored in your local docker images.\n\n#### Example: build with all overrides.\n\nHeighliner can build without a chain present in chains.yaml if the necessary flags are provided.\n\n```shell\nheighliner build -c somegaia -o somefork --repo gaia --dockerfile cosmos --build-target \"make install\" --build-env \"LEDGER_ENABLED=false BUILD_TAGS=muslc\" --binaries \"/go/bin/gaiad\" -g v8.0.0 -t v8.0.0-somefork\n```\n\nDocker image `somegaia:v8.0.0-somefork` will be built and stored in your local docker images.\n\n#### Example: build and push the gaia v6.0.0 docker image to ghcr:\n\n```shell\n# docker login ...\nheighliner build -r ghcr.io/strangelove-ventures/heighliner -c gaia -g v6.0.0\n```\n\nDocker image `ghcr.io/strangelove-ventures/heighliner/gaia:v6.0.0` will be built and pushed to ghcr.io\n\n#### Example: build and push last n releases of osmosis chain\n\n```shell\n# docker login ...\nheighliner build -r ghcr.io/strangelove-ventures/heighliner -c osmosis -n 3\n```\n\nheighliner will fetch the last 3 osmosis release tags from github, build docker images, and push them, e.g.:\n- `ghcr.io/strangelove-ventures/heighliner/osmosis:v6.1.0`\n- `ghcr.io/strangelove-ventures/heighliner/osmosis:v6.0.0`\n- `ghcr.io/strangelove-ventures/heighliner/osmosis:v5.0.0`\n\n#### Example: build and push last n releases of all chains\n\nThis will make a request to each chain's Github repository to fetch all recent releases. Github rate-limits unauthenticated requests to 60 requests per hour. Authenticated requests have either 1000 (personal) or 15000 (enterprise) per hour. To add Github API authentication, set the `GH_USER` and `GH_PAT` environment variables with your Github username and Github Personal Access Token (PAT), respectively.\n\n```shell\n# docker login ...\nexport GH_USER=github_username GH_PAT=github_personal_access_token\nheighliner build -r ghcr.io/strangelove-ventures/heighliner -n 3\n```\n\nheighliner will fetch the last 3 release tags from github for all chains in [chains](chains), build docker images, and push them.\n\n\n\n🌌🌌🌌🌌🌌 Extras\n=============================\n\n## Cross compiling\nDepends on docker [buildkit](https://github.com/moby/buildkit). Requires `buildkitd` server to be running.\nPass `-b` flag to use buildkit.\n\nThe build will look for the local buildkit unix socket by default. Change address with `--buildkit-addr` flag.\n\nCustomize the platform(s) to be built with the `--platform` flag.\n\n#### Example: build x64 and arm64 docker images for gaia v7.0.1:\n\n```shell\nheighliner build -b -c gaia -g v7.0.1\n```\n\nDocker images for `heighliner/gaia:v7.0.1` will now be available in your local docker. The manifest for the tag will contain both amd64 and arm64 images.\n\n#### Example: Use custom buildkit server, build x64 and arm64 docker images for gaia v7.0.1, and push:\n\n```shell\nheighliner build -b --buildkit-addr tcp://192.168.1.5:8125 -c gaia -g v7.0.1 -r ghcr.io/strangelove-ventures/heighliner\n```\n\nDocker images for `heighliner/gaia:v7.0.1` will be built on the remote buildkit server and then pushed to the container repository. The manifest for the tag will contain both amd64 and arm64 images.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrangelove-ventures%2Fheighliner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstrangelove-ventures%2Fheighliner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstrangelove-ventures%2Fheighliner/lists"}