spoonest/geminabox repository overview

⁠Docker Geminabox image

geminabox is a very simple private rubygems server where you can store your private gems. This is a Debian based image with Geminabox⁠ listening on port 9292.

⁠Gemtoabox

Also check out my gemtoabox⁠ Ruby gem. It can backup all gems (including dependencies) from your project Gemfile to the geminabox server.

⁠Quickstart

docker run -d -p 9292:9292 --name geminabox spoonest/geminabox:latest

⁠Authentication

You can limit upload and remove access by adding -e USERNAME=myuser -e PASSWORD=mypassword variables right after run command.

docker run -d -p 9292:9292 -P -h geminabox --name geminabox -e USERNAME=myuser -e PASSWORD=mypassword spoonest/geminabox:latest

Also you can limit any access to your repository by adding -e PRIVATE=true variables right after run command.

docker run -d -p 9292:9292 -P -h geminabox --name geminabox -e PRIVATE=true -e USERNAME=myuser -e PASSWORD=mypassword spoonest/geminabox:latest

⁠Folder to store saved gems

It's recommended to store saved gems outside your docker container. Use docker volumes -v to specify storage location:

docker run -d -v /path_where_to_store_gems:/webapps/geminabox/data --name geminabox -p 9292:9292 -P -h geminabox -e PRIVATE=true -e USERNAME=myuser -e PASSWORD=mypassword spoonest/geminabox:latest

If you need to enter in the app, use docker exec since Docker 1.3 https://github.com/ahmet2mir/docker-memo⁠

docker exec -it geminabox /bin/bash

Then visit http://localhost:9292⁠

⁠Upload Gems

To upload gems to a private repository you need to install gemtoabox⁠ gem. Then tun following command:

gem inabox gem-0.0.1.gem -g http://USERNAME:PASSWORD@HOST:9292

⁠Install Gems from private repository

Add following line to Gemfile:

source 'http://USERNAME:PASSWORD@HOST:9292'

⁠Proxy to RubyGems

Geminabox can be configured to pull gems, it does not currently have, from rubygems.org. I recommend to enable it - set -e RUBYGEMS_PROXY=true.

⁠Configuration

⁠Data Store and persistent storage

• packages: mount to /webapps/geminabox/data
• config: mount to /webapps/geminabox/config.ru

If you mount data, when you stop, destroy your container and then run it, data are preserved.

⁠Password and user

If you wan't to use different configuration for authentication, mount config folder containing your own config.ru Check Geminabox Wiki⁠

### Logs

Output are in docker log collect

docker logs -f geminabox

-f like tail -f