4 Installation ¶

4.1 System requirements ¶

Telebugs can run on nearly any hardware, including a VPS, cloud server, home server, or even a Raspberry Pi. It supports both AMD64 (also known as x86-64, x64, x86_64, and Intel 64) and ARM64 (also known as AArch64) architectures. In general, if Docker can run on it, Telebugs can too.

**Supported Platforms** Telebugs is compatible with over 100 programming languages and frameworks through Sentry SDKs, including popular choices like JavaScript (Node.js, React, Angular), Python (Django, Flask), Ruby (Rails), Java (Spring), PHP (Laravel), .NET (ASP.NET Core), and Go. For a complete list of supported platforms. See Supported platforms.

When deciding how powerful your machine needs to be, consider the following table:

CPU	Est. max errors/second	Est. max errors/day
2	30	2,592,000
4	60	5,184,000
8	120	10,368,000
16	240	20,736,000

The throughput depends on your machine’s CPU and RAM. The table above provides rough estimates of how many errors Telebugs can handle per second and per day, based on the number of CPU cores. These numbers are approximate and can vary based on your specific setup, the complexity of your applications, and the volume of errors being reported.

The throuput is shared across all projects in your Telebugs installation, so if you have multiple projects, the actual throughput per project will be lower. For example, if you have two projects, each project will have half the throughput of the total. If you have four projects, each project will have a quarter of the total throughput, and so on.

Recommended minimum specs ¶

• RAM: 1 GB
• Disk space: 40 GB
• CPU: 1

Recommended specs for small to medium projects ¶

• RAM: 4 GB
• Disk space: 80 GB
• CPU: 3

Operating system compatibility ¶

• Telebugs is tested on Linux (Ubuntu, Debian, Alpine), and should work on any OS that supports Docker.
• macOS

4.2 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).
3. Connect to your server: Use SSH or your provider’s console to access the server.
4. Run the installation command: Copy the command from your email and run it in your server’s terminal. The installation process may take up to 5 minutes.

   Your personalized installation command will be similar to the following:

   bash -c "$(curl -fsSL https://auth.telebugs.com/install/a12b-c34d-e56f-g78h)"
   

IMPORTANT: Keep your install command private — don’t share it with anyone or post it online. It’s uniquely linked to your account, and the license is tied to you. Your personal purchase token is included in the email you received after downloading Telebugs.

When you run this command, it will automatically install Docker on your server (assuming you’re using Linux, which is standard for most cloud environments). It will then download the latest version of the Telebugs app as a Docker container. During setup, you’ll be prompted to enter your domain name so we can generate an SSL certificate for you.

That’s it! You’re now ready to set up the first user on your new Telebugs installation. Just visit https://YOUR-DOMAIN in your browser to get started. After that, you can begin inviting the rest of your team.

Telebugs will automatically update itself to the latest version every night at 1 AM (based on your server’s local time). You can disable this, or perform other admin tasks — like backing up data, resetting passwords, and more — using the telebugs command. Simply connect to your server and run telebugs to see all available options.

Enjoy error tracking with Telebugs!

P.S. Planning to run multiple Telebugs installations? You’ll need a separate license for each domain.