Back to articles
DevOps & Systems

Guide to Self-Hosting Dubco on a VPS for Customizable Business Link Shortening with Advanced Analytics Integration

This comprehensive guide details how to self-host the open-source link shortening platform Dubco on a customizable VPS, enabling full control over data, enhanced security, and deep...

DPTCloud Engineering5 min read
Guide to Self-Hosting Dubco on a VPS for Customizable Business Link Shortening with Advanced Analytics Integration

This comprehensive guide details how to self-host the open-source link shortening platform Dubco on a customizable VPS, enabling full control over data, enhanced security, and deep integration with analytics tools like Umami, ClickHouse, or Prometheus. By deploying Dubco on your own infrastructure, businesses can build a private, scalable, and privacy-conscious link management system tailored to internal workflows. The guide covers setup, configuration, security, database integration, and analytics, using Docker, Nginx, and open-source technologies suitable for modern DevOps environments. This approach eliminates reliance on third-party services, reduces long-term costs, and allows seamless integration with existing CRM, email, or monitoring systems.

Dubco is an open-source link shortening platform that allows users to generate memorable, short URLs and track their performance. Self-hosting Dubco on a VPS offers significant advantages such as complete data control, enhanced security for sensitive information, and the ability to customize the interface and functionality to meet specific business needs. Unlike third-party link services, self-hosting prevents data leakage, reduces dependency on external providers, and enables integration with internal systems like CRM, email platforms, or existing analytics stacks. The architecture relies on Docker, Nginx, and databases such as PostgreSQL or Redis, making it ideal for environments requiring high I/O performance, such as frequent link access.

For optimal performance, a VPS with high I/O throughput is recommended. The NVMe Cloud VPS for Docker, Nginx & Databases is a suitable choice due to its fast read/write speeds, which are essential for handling high volumes of link redirections and database operations.

Requirements and Setup Preparation

To successfully self-host Dubco, the following prerequisites are required:

  • Hardware: A VPS running Ubuntu 20.04 or 22.04 (recommended: NVMe Cloud VPS).
  • Technologies: Docker, Docker Compose, Nginx, PostgreSQL, Redis (optional), and a valid domain name.
  • Access: Root or sudo privileges on the VPS.
  • Software: curl, git, and standard command-line tools.

Ensure the VPS is fully updated and has a stable internet connection. Open necessary firewall ports (e.g., 80, 443, and 5432 if PostgreSQL is used).

Installation and Configuration of Dubco

Follow these steps to deploy Dubco:

  1. Create a working directory and clone the repository:
mkdir dubco && cd dubco
git clone https://github.com/dubco/dubco.git .
  1. Start the system using Docker Compose:
docker-compose up -d

Verify the status of containers with:

docker-compose ps

To integrate advanced analytics, connect Dubco with tools such as Umami or ClickHouse. This can be done via webhooks or API integrations. For example, to integrate with Umami, configure environment variables to send access data:

Integrating Advanced Analytics Systems

For deep analytics, integrate Dubco with tools like Umami, ClickHouse, or Prometheus. Detailed guidance on building a privacy-first static site analytics system with Umami and ClickHouse is available at Building a Privacy-First Static Site Analytics System from a VPS Host with Umami and ClickHouse.

Example configuration for Umami integration:

export UMAMI_URL=https://umami.example.com
export UMAMI_API_KEY=your-api-key
export DUBCO_ANALYTICS_ENABLED=true

Create a new Umami application and obtain the API key. Then configure Dubco to send access logs to Umami via webhook or API.

Verification and Troubleshooting

Verify the system by checking:

  • Container status: docker-compose ps
  • URL redirection: Access a shortened link (e.g., https://yourdomain.com/abc) and confirm proper redirection.
  • Analytics data: Check the Umami or ClickHouse dashboard for recorded access events.

If issues occur, inspect Docker logs:

docker-compose logs --tail=50 dubco

Common issues include PostgreSQL connection failures, incorrect DNS routing, or Nginx configuration errors. Resolve them by reviewing configuration files, opening required firewall ports, and ensuring the domain points correctly to the VPS IP.

References

DPTCloud Tier III Infrastructure

Recommended NVMe Cloud VPS Plans to Deploy This Setup

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02

VPS-2E

94.600 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Recommended

VPS-3E

170.500 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Recommended

VPS-05

457.600 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478