jrcribb / tigris

Tigris is a modern, scalable backend for building real-time websites and apps.

Tigris is a Serverless NoSQL Database and Search Platform that offers an open source alternative to MongoDB and DynamoDB. Tigris is built on FoundationDB and combines the consistency of ACID transactions with the scale and flexibility of NoSQL, at a fraction of the cost.

Website | Quickstart | API Reference | Discord | Twitter

Helpful Links

• Quickstart
• Architecture
• Databases and Collections
• Documents
• Search
• Observability
• TypeScript Reference
• Go Reference
• Java Reference
• CLI
• Guides

Community & Support

• Discord Community
• GitHub Issues
• GitHub Discussions

Developing

Setup local development environment

To setup your local development environment. Make sure you have Go installed or run:

sh scripts/install_go.sh

Add your $GOPATH to your $PATHS environment variable. And then to download and install the build dependencies and FoundationDB run:

sh scripts/install_build_deps.sh

Building with Docker Containers

Start local Tigris server listening on http://localhost:8081 by running:

make run

This would bring dependencies and server up in the docker containers with all your changes.

Alternatively, you can run make run_full to bring up monitoring tools as well.

• Grafana: http://localhost:3000
• Prometheus: http://localhost:9090

Running tests

Run in the docker container

Tests are executed using make test. This runs both unit and integration tests in the docker containers.

Run in the IDE

Run make run to bring the server up in the docker container. Now you can run individual tests in the IDE of your choice. Entire test suite can be run using make local_test.

Debugging the server in the IDE

Run make local_run to start Tigris server on the host. Now you can attach to the process and debug from the IDE.

License

This software is licensed under the Apache 2.0.