Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Build Status Build status codecov License codebeat badge Codacy Badge Docker Pulls Main distribution Join the chat at EO badge DevOps By Hits-of-Code Scc Count Badge Mentioned in Awesome database tools

Treat your database as Code

There are many awesome REST-wrappers for your Databases (e.g. PostgREST, pREST, sandman2 and many others), but how about REST-wrapper for your own SQL-queries?

The sql-boot tool is a REST-like wrapper for your own SQL-queries. No ETLs, no generated SQL, no "automagic" - sql-boot simply transform your own SQL-query to Web resources.

sql-boot recursively finds every *.sql files in your folders and start REST-like service and runs scripts against live databases in response to http requests.


Save you SQL-query to big_cities.sql:

select a.airport_code as code
     , a.airport_name
     , a.coordinates
     , a.timezone
  from bookings.airports a
 where in (select
                    from bookings.airports aa
                   group by
                  having count(*) > 1)
 order by
     , a.airport_code

Now sql-boot is ready to receive http requests (without restarting and other actions).

Execute query on "master_db" database:


Execute query against all registered databases:


Execute query against all registered databases with specified columns:


Execute query with ordering:


Execute query with pagination:



sql-boot uses the OpenAPI standard to generate up-to-date documentation for APIs based your SQL-queries metadata. You can use a tool like Swagger-UI or Swagger-Editor to render interactive documentation (for demo requests) or generate client API against the live API server.

How to pronounce

It is pronounced "sequelboot" -

Try with Docker and embedded (H2) demo db:

docker run -t -p 8007:8007 mgramin/sql-boot

Build from source:

git clone
cd sql-boot
mvn package