Gemstash

Spec sheet

Purpose

Gemstash is a cache for remote gem servers such as RubyGems.org and a private gem source.Read 5 Oct 2026 · github.com

Intended users

The project suggests Gemstash for teams using Bundler across machines, publishing private gems, or repeatedly bundling the same gems.Read 5 Oct 2026 · github.com

License

The project is available under the MIT License.Read 5 Oct 2026 · github.com

Access controls

Gemstash API keys can be given specific permissions for pushing, yanking, and fetching gems.Read 5 Oct 2026 · github.com

Authentication caveat

Private gems and specs are accessible without authentication by default; protected fetching can be enabled in setup.Read 5 Oct 2026 · github.com

Bundler integration

Bundler can be configured to mirror gem sources through Gemstash, with the simpler mirror setup requiring Bundler 1.11.0 or later.Read 5 Oct 2026 · github.com

Caching

Gem files are cached indefinitely, while dependency metadata is cached for 30 minutes by default.Read 5 Oct 2026 · github.com

Caching backend

The default in-memory cache can be replaced with a Memcached server or cluster.Read 5 Oct 2026 · github.com

Maintainer

Gemstash is maintained by Ruby Central, which describes itself as a nonprofit supporting Ruby infrastructure.Read 5 Oct 2026 · github.com

Monitoring

Gemstash provides a /health endpoint that reports status for its heartbeat, storage, and database.Read 5 Oct 2026 · github.com

Private gems

Users can push, fetch, and yank private gems using API keys and the RubyGems command line.Read 5 Oct 2026 · github.com

Server limitation

Gemstash uses Puma and Rack, and its server configuration is not customizable, although the bind address and Puma thread count can be configured.Read 5 Oct 2026 · github.com

Storage and database

Gemstash stores files under ~/.gemstash by default, and supports SQLite, PostgreSQL, MySQL, and MySQL2 database adapters.Read 5 Oct 2026 · github.com

Upstream sources

Gemstash can fetch from multiple gem sources, and its default source can be changed in its configuration.Read 5 Oct 2026 · github.com

Plans and prices

Every Gemstash plan and price →

Where Specifiction places it

• Artifact repository software#46 of 647.6