schachr/openshift-snorby repository overview

⁠Openshift

This container is a test for openshift deployments.

⁠Snorby Docker Image

Docker Image⁠ with Snorby using latest CentOS-7, Ruby on Rails, Daq and Snort. Using ENV variable called OINKCODE this docker image can download rules provided for registered and subscribed users from snort.org⁠.

Snorby is build on:

ruby-1.9.3-p551
daq-2.0.6-1
snort-2.9.11-1 using community rules.  

This container is built that any extra parameters provided to docker run will be passed directly to rails server command. For example, if you run docker run [run options] schachr/openshift-snorby -e production you pass -e production to rails server daemon.

⁠Automatic Build details

This image has a repository link to the underlying base image centos. Whenever this receives an update this container will automatically build itself again. There is an automatic build dependency to the github repository https://github.com/schachr/openshift-snorby⁠ as well. All you need to do is to pull it, remove the container (docker rm) if neccessary and restart it (docker create/run).

⁠Database deployment

To be able to connect to database we would need one to be running first.

⁠Environmental Variable

In this Image you can use environmental variables to connect into external MySQL/MariDB database.

DB_USER = database user
DB_PASS = database password
DB_ADDRESS = database address (either ip or domain-name).

Snorby Config:
SNORBY_CONFIG=/usr/local/src/snorby/config/snorby_config.yml
If you mount your config to different location, simply edit it.

⁠Usage

⁠Basic

docker run \
-d \
--name snorby \
-p 3000:3000 \
--env="DB_ADDRESS=database_ip" \
--env="DB_USER=snorbyuser" \
--env="DB_PASS=password" \
schachr/openshift-snorby

⁠Mount custom config , override some options

docker run \
-d \
--name snorby \
-p 80:80 \
--env="DB_ADDRESS=database_ip" \
--env="DB_USER=snorbyuser" \
--env="DB_PASS=password" \
--env="OINKCODE=my_oinkcode" \
-v /my-snorby-config.yml:/usr/local/src/snorby/config/snorby_config.yml \
-v /my-email-settings.rb:/usr/local/src/snorby/config/initializers/mail_config.rb \
schachr/openshift-snorby \
-e development -p 80

⁠Rails Server CMD params

rails server command can be used with some parameters to define address and port on which rails server should work.
Simple --help output below:

Usage: rails server [mongrel, thin, etc] [options]
-p, --port=port                  Runs Rails on the specified port.
                                 Default: 3000
-b, --binding=ip                 Binds Rails to the specified ip.
                                 Default: 0.0.0.0
-c, --config=file                Use custom rackup configuration file
-d, --daemon                     Make server run as a Daemon.
-u, --debugger                   Enable ruby-debugging for the server.
-e, --environment=name           Specifies the environment to run this server under (test/development/production).
                                 Default: development
-P, --pid=pid                    Specifies the PID file.
                                 Default: tmp/pids/server.pid

-h, --help                       Show this help message.

⁠Access Snorby web interface

Visit your snorby_ip:port to access snorby interface and use default credentials:
Username: [email protected]⁠
Password: snorby