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 UI

Database​

Jackson currently supports the following databases.

  • Postgres
  • MySQL
  • MariaDB
  • MongoDB
  • Redis

Deployment Guides (Coming soon)​

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