🚀 How to Deploy Phanpy on AlmaLinux VPS

This article provides a guide demonstrating how to deploy Phanpy on AlmaLinux VPS.

What is Phanpy?

Phanpy is a modern alternative web frontend for Mastodon and compatible Fediverse platforms. It is designed as a minimalistic, ultra-fast, privacy-conscious social client that lets users browse, post, reply, boost, and manage Mastodon accounts through a cleaner interface than the default Mastodon web app.

In simple terms:

Think of Phanpy as a better-looking, faster, more responsive Mastodon dashboard that runs entirely in the browser.

🔍 What Does Phanpy Actually Do?

Phanpy connects to your existing Mastodon/Fediverse account and gives you:

• streamlined timeline browsing
• grouped notifications
• nested conversation threads
• multiple account switching
• pop-out composer window
• dark/light themes
• multi-column social dashboard mode
• hashtag timeline views
• unsent draft recovery

All while using Mastodon’s API behind the scenes.

SEE ALSO: How to Host Your Own Mastodon Server on a VPS

⚡ Why People Use Phanpy Instead of Default Mastodon UI

The official Mastodon frontend can feel:

• cluttered
• slower on heavy timelines
• less efficient for power users
• awkward on desktop workflows

Phanpy was built specifically to solve that.

Its developer describes it as an “opinionated” client—meaning it intentionally redesigns the social experience to be:

Cleaner

Less visual noise.

Faster

Built as a static SPA (single-page application) with aggressive frontend optimization.

More Productive

Ideal for people who manage multiple timelines or accounts.

Easier to Self Host

No backend daemon required—just static files served through NGINX/Apache/CDN.

🏗 Technical Architecture of Phanpy

This is important:

Phanpy is NOT a Mastodon server.

It does not federate, does not store posts, and does not run ActivityPub services.

Instead:

It is a frontend client layer.

Meaning:

User Browser → Phanpy UI → Mastodon API → Mastodon/Fediverse Instance

So it simply acts as the visual/social interface between your users and whatever Mastodon-compatible server they already use.

Because of this architecture:

• no database required
• no PostgreSQL required
• no Redis required
• no Sidekiq workers
• no Ruby stack
• no mail server

Just:

• Node.js to build
• NGINX to serve static output

This is why deployment is extremely lightweight.

🌐 Is Phanpy a Social Network?

No.

Phanpy is a client for a social network.

Just like:

• TweetDeck was a client for Twitter
• Ivory is a client for Mastodon
• Elk is another Fediverse frontend

Phanpy is simply one of the most polished browser-based clients available.

🎯 Best Use Cases for Phanpy

Phanpy is excellent for:

✔ Personal Mastodon power users

People wanting a better daily interface.

✔ Organizations running Mastodon communities

Custom branded frontend under:

social.yourdomain.com

✔ Hosting providers / SaaS companies

Offer white-labeled Fediverse portals.

✔ Privacy-first communities

No need to expose users to third-party frontends.

🔥 Why It’s Becoming Popular

Phanpy has gained traction because it offers something many Fediverse users want:

Mastodon functionality without Mastodon frontend frustration.

Users particularly like:

• instant feel
• smooth thread reading
• grouped boosts
• distraction-free design

It has become one of the most recommended alternative Mastodon web clients in the Fediverse community.

🖥 Can You Self-Host Phanpy?

Yes — very easily.

The official project specifically supports self-hosting as a pure static web app, meaning you can host it on:

• AlmaLinux VPS
• Ubuntu VPS
• Debian VPS
• NGINX web servers
• Apache
• Docker containers
• CDN object storage

with almost zero server resource usage.

💡 In One Sentence

Phanpy is a lightweight self-hostable premium frontend interface for Mastodon that dramatically improves usability, speed, and aesthetics without requiring you to run a full Mastodon server.

Running your own modern Mastodon client is easier than ever with Phanpy—a fast, lightweight, and privacy-friendly web interface designed for the Fediverse. In this guide, you’ll learn how to deploy Phanpy on an AlmaLinux VPS with production-grade performance, HTTPS, and optimization best practices.

🌐 Why Deploy Phanpy on AlmaLinux VPS?

Phanpy offers:

• ⚡ Blazing-fast performance (static build, no backend required)
• 🔒 Privacy-first Mastodon browsing
• 🎨 Clean, customizable UI
• 🌍 Works with any Mastodon instance

Deploying it on your own VPS ensures:

• Full control over performance and caching
• Custom domain branding (e.g., social.yourdomain.com)
• Better uptime and SEO benefits

🧰 Prerequisites

• AlmaLinux 8/AlmaLinux 9 VPS
• Root or sudo access
• Domain or subdomain (recommended: social.yourdomain.com)
• Basic familiarity with Linux CLI

---

Compare AlmaLinux VPS Plans

---

🚀 How to Deploy Phanpy on AlmaLinux VPS (Production-Ready Guide)

To deploy Phanpy on AlmaLinux VPS, follow the steps below:

1. ⚙️ Install Required Packages

   dnf update -y
   dnf install -y git nginx nodejs npm
   

   Ensure Node.js 18+:

   node -v
   

   If needed:

   dnf module reset nodejs -y
   dnf module enable nodejs:18 -y
   dnf install nodejs -y
   

2. 📦 Download Phanpy

   cd /opt
   git clone https://github.com/cheeaun/phanpy.git
   cd phanpy
   

3. 🔧 Install Dependencies

   npm install
   

4. 🛠 Configure Environment

   cp .env.example .env
   nano .env
   

   Set your default Mastodon instance:

   VITE_DEFAULT_INSTANCE=https://mastodon.social
   

5. 🏗 Build for Production

   npm run build
   

   Output directory:

   /opt/phanpy/dist
   

6. 🌍 Configure NGINX (Production Optimized)

   Create config:

   nano /etc/nginx/conf.d/phanpy.conf
   

   ✅ Optimized NGINX Config (Gzip + Brotli + SPA Routing)

   server {
       listen 80;
       server_name social.yourdomain.com;
   
       root /opt/phanpy/dist;
       index index.html;
   
       # Enable Gzip
       gzip on;
       gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
       gzip_min_length 256;
   
       # Enable Brotli (if module installed)
       brotli on;
       brotli_types text/plain text/css application/javascript application/json image/svg+xml;
       brotli_comp_level 5;
   
       location / {
           try_files $uri /index.html;
       }
   
       location ~* \.(js|css|png|jpg|jpeg|gif|svg|ico)$ {
           expires 30d;
           access_log off;
       }
   }
   

   Reload:

   nginx -t
   systemctl enable nginx
   systemctl restart nginx
   

7. 🔥 Configure Firewall

   firewall-cmd --permanent --add-service=http
   firewall-cmd --permanent --add-service=https
   firewall-cmd --reload
   

8. 🔒 Enable HTTPS (Let’s Encrypt)

   dnf install -y certbot python3-certbot-nginx
   certbot --nginx -d social.yourdomain.com
   systemctl enable certbot-renew.timer
   

⚡ Production Best Practices

✅ Use a Subdomain

Host Phanpy on:

social.yourdomain.com

✅ Enable CDN (Optional)

Use Cloudflare for:

• Global caching
• DDoS protection
• TLS optimization

✅ Auto-Update Script

nano /opt/phanpy/update.sh

#!/bin/bash
cd /opt/phanpy
git pull
npm install
npm run build
systemctl reload nginx

chmod +x /opt/phanpy/update.sh

🎯 Final Result

You now have:

• ⚡ High-performance Phanpy deployment
• 🔒 HTTPS-secured instance
• 🌍 Custom branded subdomain
• 🚀 Optimized delivery via NGINX

💡 Use Case Ideas

• Branded Mastodon client for your business
• Internal social feed dashboard
• Privacy-focused alternative frontend for users

📣 Ready to Deploy Faster?

If you’d rather skip the manual setup, Rad Web Hosting offers:

🚀 AlmaLinux VPS Hosting

• Instant deployment
• Full root access
• Optimized for Node.js + NGINX
• DDoS-protected infrastructure

👉 Get Started Today: https://radwebhosting.com/almalinux-vps

Conclusion

You now know how to deploy Phanpy on AlmaLinux VPS.