Deploy and Host

About Hosting

PocketBase Railway Template v0.29

Open-source backend solution for your next SaaS or mobile app, all bundled into a single file.

Features

Common Use

Common Use Cases

All-in-one Solution: Manage your entire backend with a single, self-contained file
Easy to Use: Simple setup for both beginners and experienced developers
Railway Optimized: Configured for seamless deployment on Railway with persistent volumes

Why Deploy

Testing persistant volume storage

Tested volume attached has persistent storage after restarting/redeploying of service or container

Deploy

Fork this repository and deploy on your Railway account following the manual steps below.

Deployment Dependencies

Dependencies for

Prerequisites

Railway account (free tier works)
GitHub repository

Manual Deployment

Steps

Clone & Connect:

git clone https://github.com/arkarn2020/pocketbase.git
railway login
railway link

Create Volume:
```
railway volume add
```
- Mount Path: /pb_data
- Size: 500MB
- Name: pocketbase-volume
Deploy:
```
railway up
railway logs
```

Configuration

Dockerfile ✅

Alpine Linux (lightweight)
PocketBase v0.29.2
Non-root user for security
Automatic volume permission fixing

railway.json ✅

{
  "$schema": "https://railway.com/railway.json",
  "build": { "builder": "DOCKERFILE" },
  "deploy": {
    "restartPolicyType": "ON_FAILURE",
    "restartPolicyMaxRetries": 10
  },
  "volumes": [
    {
      "mountPath": "/pb_data",
      "size": "500MB"
    }
  ]
}

Troubleshooting

Common Issues

Volume Permission Errors

Fixed automatically by Dockerfile

Out of Memory Errors

Usually volume mounting issue, not actual memory
Restart: railway service update

Volume Size Limits

Free plan: 500MB max
Upgrade plan for larger volumes

Debugging

railway volume list    # Check volume status
railway logs --follow  # View logs
railway service update # Restart service

Railway Plans

Free Plan

✅ 500MB max volume
✅ 512MB RAM limit
✅ $5 monthly credit
✅ Perfect for development

Recommended Upgrades

When scaling:

1GB+ volumes for larger databases
More RAM for better performance
Higher CPU limits for concurrent users

Production Optimizations

When Upgrading Railway Plan

Add resource limits to railway.json:

{
  "resources": {
    "memory": "512MB",
    "cpu": "500m"
  },
  "volumes": [
    {
      "mountPath": "/pb_data",
      "size": "1GB"
    }
  ]
}

Environment Variables (Optional)

Set in Railway dashboard or add to railway.json:

{
  "environment": {
    "PB_ADMIN_EMAIL": "[email protected]",
    "PB_DEBUG": "false"
  }
}

Accessing Your PocketBase

Get your Railway URL:
```
railway status
```
Access Admin Panel:
- Visit: https://your-app.railway.app/_/
- Create admin account on first visit
- Login with your credentials
API Endpoints:
- Base URL: https://your-app.railway.app/
- API Docs: https://your-app.railway.app/_/
- Health Check: https://your-app.railway.app/_/

File Structure

pocketbase/
├── Dockerfile              # Container configuration
├── railway.json            # Railway deployment config
├── README.md              # This file
├── LICENSE                # MIT License

Documentation

For detailed PocketBase documentation:

Contributing

We welcome contributions! Please:

Fork the repository
Create a feature branch
Make your changes
Test thoroughly
Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

License

This project is licensed under the MIT License. See the LICENSE file for more details.