Spoo.me offers multiple deployment methods to suit different technical expertise levels and infrastructure preferences. Each method provides varying degrees of control, customization, and complexity.

Our support is tailored to individual needs. Should you have any inquiries, we invite you to pose them on our Discord server.

​
Server Architecture

Understanding how Spoo.me works will help you choose the right deployment method and configuration for your needs.

​
Prerequisites

Before deploying Spoo.me, you’ll need to set up the following components:

1

Set up MongoDB Database

MongoDB is required to store URLs, analytics, and user data. We recommend using MongoDB Atlas for its free tier and ease of setup.

MongoDB Setup Guide

Complete guide to setting up MongoDB Atlas or self-hosted MongoDB

2

Create Discord Webhooks

Webhooks are needed for the contact form and URL reporting functionality.

Webhook Creation Guide

Step-by-step instructions for creating Discord webhooks

​
Deployment Methods

Choose the deployment method that best fits your technical expertise and requirements:

Cloud Deployment

Recommended for beginners

Deploy with one-click using platforms like Vercel, Railway, or Render. Perfect for getting started quickly with minimal configuration.

  • ✅ Easy setup
  • ✅ Free hosting options
  • ✅ Automatic scaling
  • ❌ Limited customization

Docker Deployment

For intermediate users

Use Docker containers for consistent deployment across different environments. Ideal for users familiar with containerization.

  • ✅ Consistent environment
  • ✅ Easy scaling
  • ✅ Good customization
  • ⚠️ Requires Docker knowledge

Local Development

For advanced users

Manual setup with full control over the environment. Best for development, testing, and maximum customization.

  • ✅ Full control
  • ✅ Maximum customization
  • ✅ Best for development
  • ❌ Requires technical expertise

Redis Setup (Optional)

Performance Enhancement

Optional Redis configuration for improved caching and performance in high-traffic deployments.

  • ✅ Better performance
  • ✅ Caching support
  • ⚠️ Additional complexity

​
What You’ll Get

After successful deployment, your self-hosted Spoo.me instance will include:

  • 🔗 URL Shortening: Core functionality to create short URLs
  • 📊 Analytics Dashboard: Track clicks, referrers, and geographic data
  • 📱 Responsive Design: Works perfectly on all devices
  • 🛡️ Security Features: Built-in protection against abuse
  • 📧 Contact Forms: Direct communication with webhook integration
  • 🚨 URL Reporting: Allow users to report problematic URLs

For the best experience, ensure you have completed the prerequisite steps (MongoDB and webhooks) before proceeding with any deployment method.