{"id":20550040,"url":"https://github.com/thiskevinwang/waypoint-plugin-nixpacks","last_synced_at":"2025-11-03T11:03:15.833Z","repository":{"id":102359739,"uuid":"600019521","full_name":"thiskevinwang/waypoint-plugin-nixpacks","owner":"thiskevinwang","description":"A HashiCorp Waypoint plugin to build images using railwayapp/nixpacks","archived":false,"fork":false,"pushed_at":"2023-02-23T04:35:08.000Z","size":46288,"stargazers_count":12,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-04T18:51:15.486Z","etag":null,"topics":["docker","hashicorp","nixpacks","oci-image","waypoint"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thiskevinwang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-02-10T12:00:44.000Z","updated_at":"2024-12-31T20:38:41.000Z","dependencies_parsed_at":"2023-07-22T05:28:17.361Z","dependency_job_id":null,"html_url":"https://github.com/thiskevinwang/waypoint-plugin-nixpacks","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/thiskevinwang/waypoint-plugin-nixpacks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiskevinwang%2Fwaypoint-plugin-nixpacks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiskevinwang%2Fwaypoint-plugin-nixpacks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiskevinwang%2Fwaypoint-plugin-nixpacks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiskevinwang%2Fwaypoint-plugin-nixpacks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thiskevinwang","download_url":"https://codeload.github.com/thiskevinwang/waypoint-plugin-nixpacks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thiskevinwang%2Fwaypoint-plugin-nixpacks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":282445597,"owners_count":26670239,"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-11-03T02:00:05.676Z","response_time":108,"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","hashicorp","nixpacks","oci-image","waypoint"],"created_at":"2024-11-16T02:22:54.461Z","updated_at":"2025-11-03T11:03:15.815Z","avatar_url":"https://github.com/thiskevinwang.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Screenshot of waypoint-plugin-nixpacks in HCP Waypoint](https://user-images.githubusercontent.com/26389321/218119583-9dabe325-9295-4098-90ac-b9f32ccb7b74.png)\n\n---\n\n# waypoint-plugin-nixpacks\n\nThis [Waypoint][waypoint] plugin builds OCI images using [`nixpacks`][nixpacks].\n\nThis plugin only implements the [builder][builder] interface.\n\n## Building\n\nTo build this plugin, run `make`. (See [`Makefile`](./Makefile) for more details.)\nA plugin binary will be built and outputted to the [`./bin`](./bin) folder as well as copied into the example project folder.\n\nThis requires the following packages:\n\n- `go`\n- `protoc`\n- `protoc-gen-go`\n\n## Usage\n\nThe Waypoint runner (such as the CLI) that ends up picking up a job (such as `waypoint build`) will need [`nixpacks`][nixpacks] installed.\n\nCheck out the [examples](./examples) folder for usage examples.\n\nAlso check out [waypoint.yml](./examples/node-express/.github/workflows/waypoint.yml) for very _rough idea_ of how to use Waypoint, and _this plugin_ w/ GitHub actions.\n\n- This workflow uses a GitHub runner to connect to a Waypoint server on HCP, build `waypoint-plugin-nixpacks`, build the example app, and publish the resulting Docker image to DockerHub.\n\n[builder]: https://developer.hashicorp.com/waypoint/docs/extending-waypoint/plugin-interfaces/builder\n[waypoint]: https://github.com/hashicorp/waypoint\n[nixpacks]: https://github.com/railwayapp/nixpacks\n\n### Note on `nixpacks`\n\nThe machine (or runner) that executes this plugin will require `nixpacks` to be installed. Here are 2 different scenarios to help explain this.\n\n### `waypoint up -local=true`\n\nIn this scenario, the `waypoint` CLI will serve as the **runner**, and maybe it is connecting out to the **server** running on HCP.\n\nIn this scenario the host machine executing `waypoint up -local=true` will also need `nixpacks` installed for the plugin to function correctly. This may already be the case if you're like me and doing development and testing from the same machine.\n\n### `waypoint up -local=false`\n\nIn this scenario, the `waypoint` CLI only queues up jobs and a remote **runner** will be hosted elsewhere. That runner could be running on various platforms, such as:\n\n- Directly on EC2, via\n  ```bash\n  waypoint runner agent\n  ```\n- As `docker` container, via\n  ```\n  waypoint runner install \\\n    -platform=docker \\\n    -server-addr=api.hashicorp.cloud:443 \\\n    -docker-runner-image=hashicorp/waypoint\n  ```\n\nIn the EC2 option, the EC2 instance itself will need `nixpacks` installed.\n\nIn the Docker option, the `-docker-runner-image` will need `nixpacks` installed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthiskevinwang%2Fwaypoint-plugin-nixpacks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthiskevinwang%2Fwaypoint-plugin-nixpacks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthiskevinwang%2Fwaypoint-plugin-nixpacks/lists"}