Open Welcome

Welcome to Telebugs

Thank you for choosing Telebugs!

Telebugs is a refreshingly simple error tracking tool designed to help you catch and fix production errors in real-time. Whether you're building web apps, mobile apps, embedded systems, or games, Telebugs ensures you stay on top of issues before they impact your users.

It’s fully compatible with Sentry SDKs, meaning it works seamlessly with a wide range of languages and frameworks right out of the box.

Unlike cloud-based error tracking services, Telebugs is self-hosted — so you own your data, with no restrictions on the number of errors, projects, or team members. Track as much as you want, invite as many collaborators as you need, and maintain complete control over your infrastructure.

This manual will walk you through setting up Telebugs and making the most of its features.

Let’s get started on making your software more reliable than ever!

Open Installation

Installation

Since Telebugs is self-hosted, you'll need to have a few things ready before getting started:

1. Your own domain name (e.g., example.com or telebugs.example.com).
2. A machine connected to the internet.
3. Basic tech skills (familiarity with SSH and terminal commands).

Installation steps

The whole process takes less than 10 minutes. Here’s how to get started:

1. Choose a server: Select a machine to host Telebugs (cloud or local). I recommend DigitalOcean (setup guide) or Hetzner (setup guide).
2. Point your domain: Update your DNS to link your domain to your server’s IP address. Ensure it’s a direct DNS record (no proxying — Telebugs handles SSL). ![Cloudflare DNS configuration example](https://docs.telebugs.com/u/screenshot-2025-04-30-at-12-06-32-am

Open The telebugs command

telebugs command reference

Install and manage your Telebugs instance.~~~~

To run the telebugs command, connect to your server using SSH or your cloud provider’s web-based terminal.

Usage:

• once - [command]

Manage passwords

• password - Manage passwords

Manage automatic updates

• auto-update - Manage automatic updates

Manage application data

• data - Manage application data

Additional Commands:

• help - Help about any command
• setup - Re-run the initial setup of Telebugs
• start - Start Telebugs
• status - Show the current status
• stop - Stop Telebugs
• update - Update Telebugs to the latest version

Flags:

• -h, --help - help for telebugs

Use telebugs [command] --help for more information about a command.

Open Installing on Digital Ocean

Installing on Digital Ocean

Using Digital Ocean to host Telebugs is a great choice. It’s affordable and easy to set up.

After signing up for a Digital Ocean account, follow these steps. It should take about 5 minutes.

1. In your Digital Ocean account, go to Create > Droplets and pick a plan for your server. You need at least 2GB RAM and 1 CPU. IMPORTANT: Don't use ARM64 — Tailwind doesn't work on it yet, and Telebugs relies on Tailwind. Learn more.

2. Set a password to connect to your server.

3. Leave the

Open Installing on Hetzner

Installing on Hetzner

Hosting Writebook on Hetzner is a smart pick. It’s budget-friendly and simple to set up if you’re comfortable with some basic tech steps.

After signing up for a Hetzner account, follow these quick steps. It should take about 5 minutes.

1. In your Hetzner project, click + Create Server and pick a plan. You need at least 2GB RAM and 1 CPU. IMPORTANT: Don't use ARM64 — Tailwind doesn't work on it yet, and Telebugs relies on Tailwind. Learn more

2. Keep the default settings and click Create and Buy now. Your server will be ready in a few minutes.

3. Once it’s ready, copy the Public IP address. This link