Service adapters for KnexJS a query builder for PostgreSQL, MySQL, MariaDB, Oracle and SQLite3
Latest commit ed6e0fd Dec 21, 2016 @arlair arlair committed with daffl Update README Example (#89)
Start server with port mentioned in the following documentation and make it more obvious where `knexService` is imported from.


Build Status Code Climate Test Coverage Dependency Status Download Status Slack Status

A Knex.js service adapter for FeathersJS


npm install feathers-knex --save


Please refer to the Feathers database adapter documentation for more details or directly at:

  • KnexJS - The detailed documentation for this adapter
  • Extending - How to extend a database adapter
  • Pagination and Sorting - How to use pagination and sorting for the database adapter
  • Querying - The common adapter querying mechanism

Complete Example

Here's a complete example of a Feathers server with a todos SQLite service. We are using the Knex schema builder

import feathers from 'feathers';
import rest from 'feathers-rest';
import bodyParser from 'body-parser';
import knexService from 'feathers-knex';

const knex = require('knex')({
  client: 'sqlite3',
  connection: {
    filename: './db.sqlite'

// Clean up our data. This is optional and is here
// because of our integration tests
knex.schema.dropTableIfExists('todos').then(function() {
  console.log('Dropped todos table');

  // Initialize your table
  return knex.schema.createTable('todos', function(table) {
    console.log('Creating todos table');

// Create a feathers instance.
const app = feathers()
  // Enable REST services
  // Turn on JSON parser for REST services
  // Turn on URL-encoded parser for REST services
  .use(bodyParser.urlencoded({ extended: true }));

// Create Knex Feathers service with a default page size of 2 items
// and a maximum size of 4
app.use('/todos', knexService({
  Model: knex,
  name: 'todos',
  paginate: {
    default: 2,
    max: 4

app.use(function(error, req, res, next){

// Start the server.
const port = 8080;
app.listen(port, function() {
  console.log(`Feathers server listening on port ${port}`);

You can run this example by using node server and going to localhost:8080/todos. You should see an empty array. That's because you don't have any Todos yet but you now have full CRUD for your new todos service!


Copyright (c) 2016

Licensed under the MIT license.