Tellery is a tool that empowers teams to build metrics using SQL, enabling seamless collaboration and enhanced productivity. In this guide, we will walk you through the steps to get started with Tellery, its features, and troubleshooting tips to maximize your experience.
Key Features of Tellery
- Empowers business users to get answers quickly—no need to interpret complex tables.
- Design beautiful documents and dashboards effortlessly with a drag-and-drop interface.
- Rich text styling, slash commands, and markdown support enhance your editing experience.
- A modern SQL editor with multi-tabs and auto-complete for increased efficiency.
- Data modeling is simplified with SQL, including the ability to reference CTEs.
- Real-time collaboration allows for multiplayer reviews of work.
- Import dbt models and inspect their metadata while editing SQL.
Supported Databases
Tellery supports both officially connected databases and community-supported connectors. For more information, check out the following links:
Getting Started with Tellery
Try the Demo
Experience Tellery in action by trying out an online demo. No installation is required—just click around and explore!
Run the Demo Project with Docker
To run a local version of Tellery, follow the steps below:
# Clone the Tellery repository
git clone https://github.com/tellery/tellery.git
# Change directories into the demo directory
cd tellery/deploy/compose
# View or edit config file (optional)
# vim .env
# Run docker compose
docker-compose up
Once you run the Docker container, you can access Tellery at http://localhost:8000. Use the default login credentials: admin@tellery.local and password: tellery.
Production Setup
For those interested in running their own production instances of Tellery, refer to the instructions on setting up Tellery with Kubernetes.
Next Steps
To dive deeper into analytics with Tellery, you can:
- Learn how to configure a database for your own dataset.
- Create a new story by visiting this guide.
- Check out our Data Asset example for more inspiration.
Troubleshooting Tips
If you encounter any issues while using Tellery, here are some quick solutions:
- Check if Docker is correctly installed and running on your system.
- Ensure your internet connection is stable when accessing online features.
- If you can’t access the local instance, confirm that nothing else is using port 8000.
- Monitor the logs in your terminal for any error messages that can give insights into the issue.
- For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
Contributing to Tellery
The Tellery community welcomes contributions! You can help by adding support for new databases, translating documentation, or tackling issues listed on GitHub.
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

