1
Step 1Open the server Apps tab
Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.
Back to all templates
Filestash
Infrastructure256MB+ RAM
Web-based file manager with S3, SFTP, FTP support
filesmanagers3sftp
Deploy Filestash in 3 Steps
1
Connect Your VPS
Add your server credentials to Server Compass
2
Select Filestash
Choose from our template library
3
Deploy & Configure
Fill in settings and click Deploy
No Docker knowledge required
Step-by-step deployment guide
Deploy Filestash on a VPS with Server Compass
Use the Filestash template in Server Compass to deploy a web-based file manager on your VPS, then verify the web UI in a browser.
About 10 minutesBrowser verified
2
Step 2Choose an app template
Click New App and choose the template deployment path so Server Compass can load the built-in catalog.
3
Step 3Search for Filestash
Use the template picker search to find Filestash in the Server Compass template catalog.
4
Step 4Select the Filestash template
Choose the Filestash template. Server Compass fills the web service, persistent state volume, and public port.
5
Step 5Review the Filestash settings
Confirm the app name and compose service. In this run, the app was named filestash-demo and used host port 8334.
6
Step 6Deploy Filestash
Review the generated compose settings, confirm the Filestash web port is available, and click Deploy.
7
Step 7Watch the deployment progress
Keep the deployment modal open while Server Compass uploads the compose file, pulls the Filestash image, starts the container, and verifies the stack.
8
Step 8Confirm Filestash is running
After deployment finishes, return to the Apps tab and confirm the Filestash app is marked Running with its application URL available.
9
Step 9Open Filestash in the browser
Open the application URL in a browser. The Filestash web UI confirms the file manager service is reachable.
After Filestash Opens
- Configure Filestash authentication and storage backends before exposing the service beyond trusted networks.
- Use a VPN, IP allowlist, firewall rule, or authenticated reverse proxy for production access.
- Connect only the storage backends you need, such as S3, SFTP, FTP, or local volumes.
- Use least-privilege credentials for each storage backend.
- Back up the Filestash state volume before moving or replacing the VPS.
- Keep the Filestash image updated for dependency and security fixes.
Verified Result
The Filestash web interface loaded successfully and displayed the file manager setup or login UI.
Filestash deployment questions
What does the Filestash template deploy?
It deploys the Filestash container with a persistent state volume and a public web port.
Which port did the tutorial use?
The tutorial used host port 8334, which maps to the Filestash web UI on container port 8334.
Which storage backends can Filestash use?
Filestash can connect to backends such as S3, SFTP, FTP, WebDAV, Git, and local storage, depending on how you configure it after deployment.
Should this become a blog post?
No. The deployment guide should live on the Filestash template detail page and be linked from the reusable template deployment docs page.
CLI Deployment
Deploy Filestash Yourself
Want full control? Here's how to deploy Filestash yourself using Docker Compose.
1
Establish SSH Connection
Connect to your remote server using SSH. Make sure you have your server credentials ready.
terminal
# Log into your server
ssh root@<your-server-ip>
# If using key-based auth
ssh -i ~/.ssh/my-key root@<your-server-ip>First time? Docker not installed? Run: curl -fsSL https://get.docker.com | sh
2
Create Project Directory
Set up a directory to store your Docker configuration.
terminal
# Create and navigate to project directory
mkdir -p ~/apps/filestash
cd ~/apps/filestash3
Configure Docker Compose
Add this configuration to your docker-compose.yml file:
docker-compose.yml
services:
filestash:
image: machines/filestash:latest
ports:
- "8334:8334"
volumes:
- filestash_data:/app/data/state
restart: unless-stopped
volumes:
filestash_data:
Required Settings
PORTHost port(default: 8334)4
Start the Services
Execute the deployment and check the container status.
terminal
# Deploy the application
docker compose up -d
# Check container health
docker compose ps
# Monitor logs
docker compose logs -f --tail=1005
Allow Incoming Connections
Enable network access by updating your firewall rules.
terminal
# Allow the application port through firewall
sudo ufw allow 8334/tcp
sudo ufw reload
# Access your app at:
# http://your-server-ip:8334Skip the Terminal
Too complicated? Let Server Compass handle it.
Skip the terminal and deploy Filestash with a visual interface. Configure everything with clicks, not commands.
- Intuitive dashboard
- Deploy in 3 minutes
- Free SSL included
- Blue-green deploys
- Real-time logs
- Version history
Download Server Compass$29 one-time • Lifetime license
After Deployment
After deploying Filestash with Server Compass, complete these steps to finish setup
1
Access admin interface
2
Configure backends (S3, SFTP, etc.)
3
Set up authentication
Need help? Check out our documentation for detailed guides.
Filestash FAQ
Common questions about self-hosting Filestash
How do I deploy Filestash with Server Compass?
Simply download Server Compass, connect to your VPS, and select Filestash from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.
What are the system requirements for Filestash?
Filestash requires a minimum of 256MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.
Can I migrate my existing Filestash data?
Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Filestash backup and restore procedures.
How do I update Filestash to the latest version?
Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Filestash image will be pulled and deployed with zero downtime.
Is Filestash free to self-host?
Filestash is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.
Ready to Self-Host Filestash?
Download Server Compass and deploy Filestash to your VPS in under 3 minutes. No Docker expertise required.
Download Server Compass