Deploy Rybbit on Sealos

Rybbit is a modern, open-source, privacy-friendly web and product analytics platform.

Tools

Deploy Rybbit in a few clicks from the Sealos App Store.Run a self-hosted open-source service on Kubernetes-backed infrastructure.Get automatic HTTPS, routing, and resource management from Sealos.Avoid manual YAML while keeping control of the deployed workload.

Official Website GitHub README

sealos.io

Why deploy on Sealos

Sealos makes deploying any app effortless, secure, and production-ready. From one-click launch to ongoing operations, we handle the heavy lifting so you can focus on what matters.

One-Click Deploy

Compute

Networking

Storage

Security

Observability

Your Application is Live

One-Click Deployment

Deploy any app template in seconds. No compose setup, manual configure, and go live.

Managed Kubernetes Reliability

Built on Sealos Managed Kubernetes for high availability, auto-scaling, and self-healing by default.

Automatic HTTPS & Security

Every deployment includes a secure domain with automatic SSL. We handle certificates and text protection for you.

Persistent Storage

Attach persistent volumes with ease. Your data stays safe, durable, and always accessible.

Scale when needed

Adjust resources as your app grows, no downtime required.

You Get the Whole Stack

Sealos provisions and connects every resource your application needs. Everything is ready to use.

One-click, fully provisionedSecure by defaultProduction ready

App Service

Your application is running and ready to serve requests.

Public HTTPS URL

Secure, global endpoint to access your application.

Database

Managed database instance for your application.

Persistent Volume

Durable storage for uploads and application data.

Environment Variables

Configuration and secrets injected securely into your app.

Logs & Metrics

Centralized logs and basic metrics are enabled.

README

README.md

Deploy and Host Rybbit on Sealos

Rybbit is a modern, open-source, privacy-friendly web and product analytics platform. This template deploys Rybbit with a separate web client, backend API, ClickHouse analytics storage, and PostgreSQL metadata database on Sealos Cloud.

About Hosting Rybbit

Rybbit helps teams understand website and product usage without relying on invasive third-party analytics platforms. It supports traffic analytics, product events, session insights, and a privacy-focused analytics workflow for modern web applications.

This Sealos template runs Rybbit as a multi-service deployment. The client serves the web dashboard, the backend API handles authentication and analytics APIs, ClickHouse stores high-volume analytics events, and PostgreSQL stores application metadata. Sealos automatically provisions public HTTPS access, internal service discovery, persistent storage, and database credentials.

The deployment is designed for a straightforward self-hosted setup. Signup is enabled by default so you can create the first account after deployment, while application secrets and database credentials are generated automatically by the template.

Common Use Cases

Privacy-friendly website analytics: Track page views, referrers, devices, locations, and visitor behavior without sending data to Google Analytics.
Product analytics: Collect and analyze product events to understand feature adoption and user journeys.
Self-hosted analytics for SaaS products: Keep analytics data under your own infrastructure while still using a modern dashboard.
Lightweight analytics for content sites: Monitor content performance, acquisition channels, and audience trends.
Internal application monitoring: Analyze usage patterns for private dashboards, portals, and internal tools.

Dependencies for Rybbit Hosting

The Sealos template includes all required runtime components: Rybbit client, Rybbit backend API, ClickHouse for analytics event storage, PostgreSQL 16 for metadata storage, persistent volumes, internal Services, and HTTPS Ingress resources.

Deployment Dependencies

Rybbit Website - Product overview and hosted analytics information
Rybbit GitHub Repository - Source code, issues, and upstream project updates
ClickHouse Documentation - ClickHouse database documentation
PostgreSQL Documentation - PostgreSQL database documentation
Sealos Documentation - Sealos platform documentation

Implementation Details

Architecture Components:

This template deploys the following services:

Rybbit Client: Next.js web dashboard exposed as the primary public application on port 3002.
Rybbit Backend: API service exposed under the same public host at /api on port 3001.
ClickHouse: Stateful analytics database using clickhouse/clickhouse-server:25.4.2 with persistent storage for event data.
PostgreSQL: Kubeblocks-managed PostgreSQL 16 database used for Rybbit metadata and application state.
PostgreSQL Init Job: Idempotently creates the analytics database before the backend starts.
Ingress and App Entry: Sealos-managed HTTPS entrypoint for the Rybbit dashboard and backend API.

Configuration:

The template automatically generates the application name, public host, Better Auth secret, and ClickHouse password. PostgreSQL credentials are provided through Sealos-managed database secrets, and the backend reads them through Kubernetes secretKeyRef values.

The client uses NEXT_PUBLIC_BACKEND_URL to point to the generated public URL. The backend uses BASE_URL with the same public host, connects to ClickHouse over the internal Kubernetes Service, and connects to PostgreSQL through the Kubeblocks connection secret.

Signup is enabled by default with DISABLE_SIGNUP=false. After deployment, open the public Rybbit URL and register the first user account. Optional map-based features may require a Mapbox token if you choose to enable them later.

License Information:

Rybbit is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). This Sealos template is provided as deployment configuration for running Rybbit on Sealos Cloud.

Why Deploy Rybbit on Sealos?

Sealos is an AI-assisted Cloud Operating System built on Kubernetes that unifies the application lifecycle, from development and deployment to production operations. By deploying Rybbit on Sealos, you get:

One-Click Deployment: Deploy Rybbit without manually writing Kubernetes manifests or wiring databases by hand.
Kubernetes-Native Runtime: Run the client, backend, ClickHouse, and PostgreSQL on a Kubernetes-based platform with service discovery and workload management.
Persistent Storage Included: Keep ClickHouse analytics data and PostgreSQL metadata available across restarts and upgrades.
Instant Public Access: Get an automatic HTTPS URL for the Rybbit dashboard and backend API.
Easy Customization: Adjust environment variables, resources, and storage from the Canvas using AI dialog or resource cards.
Pay-as-You-Go Resources: Allocate only the CPU, memory, and storage you need, then scale as your analytics workload grows.
Simplified Operations: Focus on analytics and product decisions while Sealos handles infrastructure provisioning and orchestration.

Deploy Rybbit on Sealos when you want self-hosted analytics without spending time managing Kubernetes infrastructure directly.

Deployment Guide

Open the Rybbit template and click Deploy Now.
Configure the parameters in the popup dialog. The default generated values are enough for a standard deployment.
Wait for deployment to complete, typically 2-3 minutes. After deployment, you will be redirected to the Canvas. For later changes, describe your requirements in the AI dialog, or click the relevant resource cards to modify settings.
Access your application via the provided URL:
- Rybbit Dashboard: Open the generated public URL and register your first account.
- Backend API: Available under the same host at /api for Rybbit client and tracking requests.

Configuration

After deployment, you can configure Rybbit through:

AI Dialog: Describe the changes you want, such as disabling signup or adding optional API tokens, and let AI apply updates.
Resource Cards: Open the backend Deployment card to adjust environment variables such as DISABLE_SIGNUP, MAPBOX_TOKEN, or resource limits.
Canvas Resources: Review the ClickHouse StatefulSet, PostgreSQL Cluster, Services, and Ingress resources created by the template.
Rybbit Dashboard: Create your first account, add websites or products, and follow Rybbit's in-app setup instructions to install tracking scripts.

Scaling

Rybbit includes separate client, backend, ClickHouse, and PostgreSQL resources. Start with the default deployment, then scale based on event volume and dashboard traffic.

Open the Canvas for your deployment.
Click the client or backend Deployment card to adjust CPU, memory, or replica count.
Click the ClickHouse StatefulSet card to increase CPU or memory for higher analytics query volume.
Apply changes through the dialog and monitor readiness from the Canvas.

For high-volume analytics workloads, prioritize ClickHouse CPU, memory, and storage capacity before increasing frontend replicas.

Troubleshooting

Signup is not available

Cause: DISABLE_SIGNUP may have been changed to true after the first account was created.
Solution: Set DISABLE_SIGNUP=false on the backend Deployment if you need to allow new account registration again.

Map or globe features ask for a token

Cause: Some map-based visualizations require MAPBOX_TOKEN.
Solution: Add your Mapbox token to the backend Deployment environment variables and restart the backend.

Backend is not ready

Cause: The backend waits for ClickHouse and PostgreSQL before starting.
Solution: Check the backend Deployment, ClickHouse StatefulSet, PostgreSQL Cluster, and PostgreSQL init Job from the Canvas. Make sure all database resources are running before troubleshooting the backend itself.

Getting Help

Additional Resources

License

This Sealos template is provided as deployment configuration for Sealos users. Rybbit itself is licensed under the GNU Affero General Public License v3.0.