Skip to content

Latest commit

 

History

History
86 lines (51 loc) · 2.85 KB

README.md

File metadata and controls

86 lines (51 loc) · 2.85 KB
Raw

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

Thanks

Thanks ahmet2mir for this image.