{"id":34213043,"url":"https://github.com/cloud-gov/cf-service-connect","last_synced_at":"2026-03-10T08:32:42.856Z","repository":{"id":38026139,"uuid":"77628836","full_name":"cloud-gov/cf-service-connect","owner":"cloud-gov","description":"Cloud Foundry CLI Service Connection Plugin","archived":false,"fork":false,"pushed_at":"2025-10-01T16:29:42.000Z","size":8498,"stargazers_count":18,"open_issues_count":14,"forks_count":8,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-01-15T03:32:32.181Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloud-gov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2016-12-29T17:32:24.000Z","updated_at":"2025-10-01T16:29:44.000Z","dependencies_parsed_at":"2024-04-09T22:23:19.272Z","dependency_job_id":"22caffa4-558e-45bf-abdd-84d2ce7bfb18","html_url":"https://github.com/cloud-gov/cf-service-connect","commit_stats":{"total_commits":102,"total_committers":14,"mean_commits":7.285714285714286,"dds":"0.32352941176470584","last_synced_commit":"200f3f5795818cb7c25d4b63ffc837c49f3328b9"},"previous_names":["18f/cf-service-connect","18f/cf-db-connect"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/cloud-gov/cf-service-connect","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fcf-service-connect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fcf-service-connect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fcf-service-connect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fcf-service-connect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloud-gov","download_url":"https://codeload.github.com/cloud-gov/cf-service-connect/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloud-gov%2Fcf-service-connect/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30328251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: 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":[],"created_at":"2025-12-15T21:34:03.956Z","updated_at":"2026-03-10T08:32:42.821Z","avatar_url":"https://github.com/cloud-gov.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cloud Foundry CLI Service Connection Plugin [![Code Climate](https://codeclimate.com/github/18F/cf-service-connect/badges/gpa.svg)](https://codeclimate.com/github/18F/cf-service-connect)\n\nThis plugin makes it easy to connect to your databases or other Cloud Foundry service instances from your local machine. This condenses the steps listed in [Accessing Services with SSH](https://docs.cloudfoundry.org/devguide/deploy-apps/ssh-services.html) to a single command.\n\n![demo screencast](demo.gif)\n\nRequires Diego architecture with [SSH enabled](https://docs.cloudfoundry.org/running/config-ssh.html).\n\n## Support\n\nCurrently supports (most) service brokers for the following:\n\n* MongoDB (requires [`mongo` shell](https://docs.mongodb.com/getting-started/shell/installation/))\n* MySQL (requires [`mysql` CLI](https://dev.mysql.com/doc/refman/8.0/en/installing.html))\n* PostgreSQL (requires [`psql` CLI](https://postgresapp.com/documentation/cli-tools.html))\n* Redis (requires [`redis-cli`](https://redis.io/topics/quickstart))\n\n## Local installation\n\n1. Install the [Cloud Foundry CLI](https://docs.cloudfoundry.org/cf-cli/install-go-cli.html) v6.15.0 or later.\n2. Install this plugin, using the appropriate binary URL from [the Releases page](https://github.com/18F/cf-service-connect/releases).\n\n    ```sh\n    cf install-plugin \u003cbinary_url\u003e\n    # will be of the format\n    # https://github.com/cloud-gov/cf-service-connect/releases/download/\u003cversion\u003e/cf-service-connect_\u003cos\u003e-\u003carch\u003e\n    # For non-M1 Macs, use `cf-service-connect_darwin_amd64`\n    # For M1 Macs, use `cf-service-connect_darwin_arm64`\n    ```\n\n3. Install the CLI corresponding to your service type (see above).\n\n## Usage\n\n\u003e **Note**\n\u003e If you are using this tool to connect to a service on cloud.gov, your space must be configured with the `trusted_local_networks_egress` security group. Do this by running `cf bind-security-group trusted_local_networks_egress ORG --space SPACE` with your organization and space. Skipping this step will result in a `connection refused` error. For more, see [cloud.gov: Controlling egress traffic](https://cloud.gov/docs/management/space-egress/).\n\n* `app_name` is the name of the app in your space you want to tunnel through.\n* `service_instance_name` is the service instance you wish to connect to.\n\n```shell\n$ cf target --organization \u003corg\u003e --space \u003cspace\u003e\n$ cf connect-to-service \u003capp_name\u003e \u003cservice_instance_name\u003e\nFinding the service instance details...\nSetting up SSH tunnel...\n...\nmysql\u003e\n```\n\nIf you get an error such as \"connection refused\", \"error opening SSH connection\", or \"psql: could not connect to server: Connection refused\" this is usually caused by being on a network that blocks the SSH port that this tool is trying to use. Try using a different network, or consider asking your network administrator to unblock the port (typically 22 and/or 2222).\n\n### Optional: overriding `cf` CLI binary name\n\nIf you are in Windows or another environment where the Cloud Foundry CLI was installed as `cf7` or `cf8`, you can set an environment to tell the plugin what binary name to use for the Cloud Foundry CLI:\n\n```shell\nCF_BINARY_NAME=cf7 cf connect-to-service \u003capp_name\u003e \u003cservice_instance_name\u003e\n```\n\nOr in PowerShell:\n```\n$env:CF_BINARY_NAME = \"cf7\";\ncf7 connect-to-service \u003capp_name\u003e \u003cservice_instance_name\u003e\n```\n\n### Manual client connection\n\nIf you're using a non-default client (such as a GUI), run with the `-no-client` option to set up your client connection on your own.\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloud-gov%2Fcf-service-connect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloud-gov%2Fcf-service-connect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloud-gov%2Fcf-service-connect/lists"}