Contents

# que-web [![Build Status](https://travis-ci.org/statianzo/que-web.svg?branch=master)](https://travis-ci.org/statianzo/que-web)

que-web is a web UI to the [Que](https://github.com/chanks/que) job queue.

![Que Web](https://raw.githubusercontent.com/statianzo/que-web/master/doc/queweb.png)


<a target='_blank' rel='nofollow' href='https://app.codesponsor.io/link/AitzkUqcdsSnujfFtmVhTLXR/statianzo/que-web'>
  <img alt='Sponsor' width='888' height='68' src='https://app.codesponsor.io/embed/AitzkUqcdsSnujfFtmVhTLXR/statianzo/que-web.svg' />
</a>

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'que-web'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install que-web

## Usage

#### With `config.ru`

Add in `config.ru`:

```ruby
require "que/web"

map "/que" do
  run Que::Web
end
```

### Rails

In `config/routes.rb`:

```ruby
require "que/web"
mount Que::Web => "/que"
```

#### Rails 5.0

You must use the master branch of Sinatra for `que-web`.
In your gemfile:

```
gem 'que-web'
gem 'sinatra', git: 'https://github.com/sinatra/sinatra'
```

See https://github.com/sinatra/sinatra/issues/1071

### Authentication

#### Devise
```ruby
# config/routes.rb
authenticate :user do
  mount Que::Web, at: 'que'
end
```

#### Basic HTTP auth

In `config/initializers/queweb.rb`:
```ruby
Que::Web.use(Rack::Auth::Basic) do |user, password|
  [user, password] == [ENV["QUEWEB_USERNAME"], ENV["QUEWEB_PASSWORD"]]
end
```
Then add the two environment variables to your production environment.

### Docker

Run:
```
docker run -e DATABASE_URL=postgres://username:password@hostname/db_name -p 3002:8080 joevandyk/que-web
```
Or use docker/Dockerfile to build your own container.

Version data entries

4 entries across 4 versions & 1 rubygems

Version	Path
que-web-0.6.3	README.md
que-web-0.6.2	README.md
que-web-0.6.1	README.md
que-web-0.6.0	README.md