Skip to content

RubyGems

NORA acts as a caching proxy for rubygems.org. Gem and gemspec files are cached immutably; index metadata uses TTL-based refresh. This is a proxy-only registry — publishing gems through NORA is not supported.

Configure Bundler to use NORA as a mirror for rubygems.org:

Terminal window
bundle config mirror.https://rubygems.org http://nora.example.com:4000/gems/

Or set it in your Gemfile:

source "http://nora.example.com:4000/gems/"

config.toml:

[gems]
enabled = true
proxy = "https://rubygems.org"
proxy_timeout = 30
index_ttl = 300 # seconds

Environment variables:

VariableDescriptionDefault
NORA_GEMS_ENABLEDEnable RubyGems proxyfalse
NORA_GEMS_PROXYUpstream registry URLhttps://rubygems.org
NORA_GEMS_PROXY_AUTHUpstream auth (user:pass)
NORA_GEMS_PROXY_TIMEOUTUpstream timeout in seconds30
NORA_GEMS_INDEX_TTLIndex cache TTL in seconds300
FeatureStatusNotes
Compact index (/info/{name})FullTTL-cached
Gem download (/gems/{name}-{ver}.gem)FullImmutable cache
Gemspec (/quick/Marshal.4.8/...)FullImmutable cache
Full index (specs.4.8.gz)FullTTL-cached
Latest index (latest_specs.4.8.gz)FullTTL-cached
Gem pushProxy-only (read)
  • Proxy-only: gem push is not supported. NORA caches gems downloaded from the upstream registry.
  • Disabled by default. Set NORA_GEMS_ENABLED=true to activate.