Skip to main content

Service

Health Check

The service offers a readiness and health check endpoint that can be configured in orchestration tools like Docker Compose and Kubernetes.

The /api/health GET endpoint returns a 200 when the service ready and healthy or a 5xx (typically 503) error if unhealthy. The response contains the current version of Jackson. For example: {"version":"1.0.0"}.

With Docker

The docker container can be found at boxyhq/jackson. It is preferable to use a specific version instead of the latest tag.

docker run \
-p 5225:5225 \
-e JACKSON_API_KEYS="secret" \
-e DB_ENGINE="sql" \
-e DB_TYPE="postgres" \
-e DB_URL="postgres://postgres:postgres@postgres:5432/postgres" \
-d boxyhq/jackson

OR

docker run \
-p 5225:5225 \
-e JACKSON_API_KEYS="secret" \
-e DB_ENGINE="mongo" \
-e DB_URL="mongodb://localhost:27017/jackson" \
-d boxyhq/jackson

See the complete list of Environment Variables

Kubernetes and docker-compose deployment files will be coming soon.

Without Docker

Please follow the below instructions.

Clone the repository

You can clone the source from the Jackson GitHub repo

git clone https://github.com/boxyhq/jackson
cd jackson

Install dependencies

npm install

Add environment variables

cp .env.example .env

Update .env with your values. See the complete list of Environment Variables

Build and run

npm run build
npm run start

Test the service is running

Open a browser and visit http://localhost:5225.

If you see a page asking you to sign in, congrats 🎉 you are seeing the Admin Portal.

Database

Jackson currently supports the following databases.

  • Postgres
  • MySQL
  • Microsoft SQL Server
  • MariaDB
  • MongoDB
  • Redis
  • PlanetScale

Deployment Guides (Coming soon)

  • Heroku
  • DigitalOcean
  • Vercel
  • Docker
  • Kubernetes
  • AWS
  • GCP
  • Azure