{"id":19866101,"url":"https://github.com/versity/versitygw","last_synced_at":"2026-02-10T00:01:54.627Z","repository":{"id":174729191,"uuid":"636903576","full_name":"versity/versitygw","owner":"versity","description":"versity s3 gateway","archived":false,"fork":false,"pushed_at":"2026-02-06T17:28:38.000Z","size":6358,"stargazers_count":1078,"open_issues_count":129,"forks_count":177,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-02-06T18:18:22.853Z","etag":null,"topics":["filesystem","s3","s3-storage"],"latest_commit_sha":null,"homepage":"https://www.versity.com/products/versitygw/","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/versity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-05-05T23:53:40.000Z","updated_at":"2026-02-06T17:29:14.000Z","dependencies_parsed_at":"2023-10-17T04:28:59.686Z","dependency_job_id":"4604125e-7c7b-440f-8bd8-1032dc712247","html_url":"https://github.com/versity/versitygw","commit_stats":null,"previous_names":["versity/versitygw","versity/scoutgw"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/versity/versitygw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/versity%2Fversitygw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/versity%2Fversitygw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/versity%2Fversitygw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/versity%2Fversitygw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/versity","download_url":"https://codeload.github.com/versity/versitygw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/versity%2Fversitygw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29286790,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T21:57:15.303Z","status":"ssl_error","status_checked_at":"2026-02-09T21:57:11.537Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["filesystem","s3","s3-storage"],"created_at":"2024-11-12T15:25:00.352Z","updated_at":"2026-02-10T00:01:54.622Z","avatar_url":"https://github.com/versity.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# The Versity S3 Gateway:\u003cbr/\u003eA High-Performance S3 Translation Service\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/versity/versitygw/blob/assets/assets/logo-white.svg\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://github.com/versity/versitygw/blob/assets/assets/logo.svg\"\u003e\n  \u003ca href=\"https://www.versity.com\"\u003e\u003cimg alt=\"Versity Software logo image.\" src=\"https://github.com/versity/versitygw/blob/assets/assets/logo.svg\"\u003e\u003c/a\u003e\n\u003c/picture\u003e\n\n [![Apache V2 License](https://img.shields.io/badge/license-Apache%20V2-blue.svg)](https://github.com/versity/versitygw/blob/main/LICENSE) [![Go Report Card](https://goreportcard.com/badge/github.com/versity/versitygw)](https://goreportcard.com/report/github.com/versity/versitygw) [![Go Reference](https://pkg.go.dev/badge/github.com/versity/versitygw.svg)](https://pkg.go.dev/github.com/versity/versitygw)\n\n### Binary release builds\nDownload [latest release](https://github.com/versity/versitygw/releases)\n | Linux/amd64 | Linux/arm64 | MacOS/amd64 | MacOS/arm64 | BSD/amd64 | BSD/arm64 |\n |:-----------:|:-----------:|:-----------:|:-----------:|:---------:|:---------:|\n |    ✔️    |  ✔️  |   ✔️   |  ✔️   |  ✔️   |  ✔️   |\n \n### Use Cases\n* Turn your local filesystem into an S3 server with a single command!\n* Proxy S3 requests to S3 storage\n* Simple to deploy S3 server with a single command\n* Protocol compatibility in `posix` allows common access to files via posix or S3\n* Simplified interface for adding new storage system support\n\n### News\nCheck out latest wiki articles: [https://github.com/versity/versitygw/wiki/Articles](https://github.com/versity/versitygw/wiki/Articles)\n\n### Mailing List\nKeep up to date with latest gateway announcements by signing up to the [versitygw mailing list](https://www.versity.com/products/versitygw#signup).\n\n### Documentation\nSee project [documentation](https://github.com/versity/versitygw/wiki) on the wiki.\n\n### Need help?\nAsk questions in the [community discussions](https://github.com/versity/versitygw/discussions).\n\u003cbr\u003e\nContact [Versity Sales](https://www.versity.com/contact/) to discuss enterprise support.\n\n### Overview\nVersity Gateway, a simple to use tool for seamless inline translation between AWS S3 object commands and storage systems. The Versity Gateway bridges the gap between S3-reliant applications and other storage systems, enabling enhanced compatibility and integration while offering exceptional scalability.\n\nThe server translates incoming S3 API requests and transforms them into equivalent operations to the backend service. By leveraging this gateway server, applications can interact with the S3-compatible API on top of already existing storage systems. This project enables leveraging existing infrastructure investments while seamlessly integrating with S3-compatible systems, offering increased flexibility and compatibility in managing data storage.\n\nThe Versity Gateway is focused on performance, simplicity, and expandability. The Versity Gateway is designed with modularity in mind, enabling future extensions to support additional backend storage systems. At present, the Versity Gateway supports any generic POSIX file backend storage, Versity’s open source ScoutFS filesystem, Azure Blob Storage, and other S3 servers.  \n\nThe gateway is completely stateless. Multiple Versity Gateway instances may be deployed in a cluster to increase aggregate throughput. The Versity Gateway’s stateless architecture allows any request to be serviced by any gateway thereby distributing workloads and enhancing performance. Load balancers may be used to evenly distribute requests across the cluster of gateways for optimal performance. \n\nThe S3 HTTP(S) server and routing is implemented using the [Fiber](https://gofiber.io) web framework.  This framework is actively developed with a focus on performance.  S3 API compatibility leverages the official [aws-sdk-go-v2](https://github.com/aws/aws-sdk-go-v2) whenever possible for maximum service compatibility with AWS S3. \n\n## Getting Started\nSee the [Quickstart](https://github.com/versity/versitygw/wiki/Quickstart) documentation.\n\n### Run the gateway with posix backend:\n\n```\nmkdir /tmp/vgw\nROOT_ACCESS_KEY=\"testuser\" ROOT_SECRET_KEY=\"secret\" ./versitygw --port :10000 posix /tmp/vgw\n```\nThis will enable an S3 server on the current host listening on port 10000 and hosting the directory `/tmp/vgw`.\n\nTo get the usage output, run the following:\n\n```\n./versitygw --help\n```\n\nThe command format is\n\n```\nversitygw [global options] command [command options] [arguments...]\n```\nThe [global options](https://github.com/versity/versitygw/wiki/Global-Options) are specified before the backend type and the backend options are specified after.\n\n### Run the gateway in Docker\n\nUse the published image like the native binary by passing CLI arguments:\n\n```bash\ndocker run --rm versity/versitygw:latest --version\n```\n\nWhen no command arguments are supplied, the container looks for `VGW_BACKEND` and optional `VGW_BACKEND_ARG`/`VGW_BACKEND_ARGS` environment variables to determine which backend to start. Backend-specific configuration continues to come from the existing environment flags (for example `ROOT_ACCESS_KEY`, `VGW_PORT`, and others).\n\n```bash\ndocker run --rm \\\n  -e ROOT_ACCESS_KEY=testuser \\\n  -e ROOT_SECRET_KEY=secret \\\n  -e VGW_BACKEND=posix \\\n  -e VGW_BACKEND_ARG=/data \\\n  -p 10000:7070 \\\n  -v $(pwd)/data:/data \\\n  versity/versitygw:latest\n```\n\nIf you need to pass additional CLI options, set `VGW_ARGS` with a space-delimited list, or continue passing arguments directly to `docker run`.\n\n***\n\n#### Versity gives you clarity and control over your archival storage, so you can allocate more resources to your core mission.\n\n### Contact\n![versity logo](https://www.versity.com/wp-content/uploads/2022/12/cropped-android-chrome-512x512-1-32x32.png)\ninfo@versity.com \u003cbr /\u003e\n+1 844 726 8826\n\n### @versitysoftware \n[![linkedin](https://github.com/versity/versitygw/blob/assets/assets/linkedin.jpg)](https://www.linkedin.com/company/versity/) \u0026nbsp; \n[![twitter](https://github.com/versity/versitygw/blob/assets/assets/twitter.jpg)](https://twitter.com/VersitySoftware) \u0026nbsp;\n[![facebook](https://github.com/versity/versitygw/blob/assets/assets/facebook.jpg)](https://www.facebook.com/versitysoftware) \u0026nbsp;\n[![instagram](https://github.com/versity/versitygw/blob/assets/assets/instagram.jpg)](https://www.instagram.com/versitysoftware/) \u0026nbsp;\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fversity%2Fversitygw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fversity%2Fversitygw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fversity%2Fversitygw/lists"}