Set Up Swush on a Linux Server – Build Your Own Private Media and File Safe

Learn how to install and run Swush on your Linux VPS to create a self-hosted platform for media, files, and content management → Discover more now

10 November 20263 min read2 Views0 helpful

Introduction

Swush is a self-hosted digital safe and content management system that helps you organize files, media, and personal data in a centralized dashboard. The application combines file storage, sharing tools, media streaming, and knowledge management into a single web interface.

With Swush, you can upload and manage files, organize content with folders and tags, generate shareable links, and even stream media directly from the server. Because it is fully self-hosted, you retain complete control over your data and infrastructure — a great alternative to cloud storage platforms.

The app is built on modern technologies like Next.js, TypeScript, and TailwindCSS, ensuring a fast and responsive interface while enabling easy installation on a VPS or dedicated server. This guide walks you through the steps to install and launch Swush on a Linux server.

Set Up Swush on a Linux Server – Build Your Own Private Media and File Safe

Use Cases for Swush

Swush is designed as a central hub for your digital content and workflows. It suits many different scenarios:

Managing and organizing files, images, and documents
Building a personal media server to stream uploaded content
Creating secure share links for files and media
Organizing knowledge such as notes, bookmarks, or snippets
Hosting a private dashboard for personal workflows
Automating uploads and integrations via the Swush API

The platform combines multiple tools in one environment, helping you reduce reliance on scattered cloud services.

Requirements

Before installing Swush, ensure your server meets the following requirements.

Hardware	Minimum	Recommended
CPU	1 core	4 cores
RAM	2 GB	4 GB
Disk Space	20 GB	50 GB

Required software:

Bun Runtime
PostgreSQL database
Git

Make sure your system is up to date before installation.

Preparation

First, create a directory for the Swush installation.

Code

mkdir swush
cd swush

Then clone the Swush repository.

Code

git clone https://github.com/imthatdev/swush.git .

Install the project dependencies with Bun.

Code

bun install

Configuration

Before starting the application, create the environment configuration file.

Code

cp example.env .env

Open the .env file and adjust the required values:

Code

APP_NAME=Swush
APP_URL=http://your-server-ip:3000
SUPPORT_NAME=Support
SUPPORT_EMAIL=support@example.com
DATABASE_URL=postgresql://username:password@localhost:5432/swush

You can also configure additional settings such as:

Storage backend (local or S3)
Upload directory
SMTP settings for email notifications
Authentication secrets

Swush supports both local storage and S3-compatible storage systems, allowing flexible file storage tailored to your environment.

Installation

After configuring the environment variables, initialize the database schema.

Code

bun run push:db

Then build the application.

Code

bun run build

Start the Swush server.

Code

bun start

The application will now start and listen on port 3000.

Accessing Swush

Once the server is running, open your web browser and go to:

Code

http://YOUR_SERVER_IP:3000

Replace YOUR_SERVER_IP with the IP address of your VPS or dedicated server. On first access, you will be guided through the setup wizard to create your first account and configure storage settings.

After completing setup, you can upload files, organize media, and manage your digital content directly in the Swush dashboard.

Conclusion

Congratulations! You have successfully installed Swush on your Linux server. Your self-hosted digital safe is now ready to manage files, share media, and centrally organize personal content.

With Swush, you have full control over your data and benefit from a modern, privacy-focused content management platform.

If you have any questions or issues, our support team is available daily — don’t hesitate to contact us! 🙂

FAQ

Frequently asked questions

Swush is a self-hosted digital safe and content management system that helps you organize files, media, and personal data in a central dashboard. It combines file storage, sharing tools, media streaming, and knowledge management.

You can upload and manage files, organize content with folders and tags, generate shareable links, and stream media directly from the server.

Swush is built on modern technologies like Next.js, TypeScript, and TailwindCSS, providing a fast and responsive interface.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.

Which 🍪 cookies would you like to allow?

Set Up Swush on a Linux Server – Build Your Own Private Media and File Safe

Introduction

Use Cases for Swush

Requirements

Preparation

Configuration

Installation

Accessing Swush

Conclusion

Frequently asked questions

Software

Use Cases for Swush

Preparation

Configuration

Installation

Accessing Swush

Conclusion

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting