Deploy and Host Toolkit on Railway

SnapOtter is an open-source, self-hosted image processing toolkit that combines over 100+ image editing tools with local AI-powered features in a single web application. It includes a visual workflow builder, REST API, user management, and batch processing capabilities, allowing teams to process images privately without relying on third-party cloud services.

About Hosting Toolkit

Hosting SnapOtter on Railway provides a fully managed environment for running a private image processing platform without managing servers or additional infrastructure. This template deploys SnapOtter as a single service with a Railway Volume for persistent storage of images, user accounts, API keys, and processing pipelines. Railway automatically provisions HTTPS, public networking, and deployment management while keeping all image processing within your own infrastructure. Since SnapOtter runs entirely inside one container, no external databases, Redis instances, or third-party APIs are required for standard deployments, making it simple to operate while maintaining complete ownership of your data.

Common Use Cases

• Process, optimize, and convert images through a self-hosted web interface and REST API.
• Build automated image processing pipelines for resizing, watermarking, compression, and format conversion.
• Run AI-powered image enhancement, background removal, OCR, and restoration entirely within your own infrastructure.

Dependencies for Toolkit Hosting

SnapOtter does not require an external database, Redis, or third-party services.

Deployment Dependencies

Implementation Details

Docker

This template deploys the official container image:

snapotter/snapotter:latest

Railway automatically deploys the container without requiring custom build or start commands.

Public Networking

Generate a Railway domain from Settings → Networking → Generate Domain to access both the web interface and REST API.

Environment Variables

Note: Railway automatically injects the application port. Do not manually configure the PORT environment variable.

Example:

ANALYTICS_ENABLED=false
AUTH_DISABLED=false
MAX_UPLOAD_SIZE_MB=100
GPU_ENABLED=false

Persistent Storage

SnapOtter requires persistent storage for processed images, workflow definitions, user accounts, API keys, and application data.

Add a Railway Volume:

1. Open the SnapOtter service.
2. Navigate to Settings → Volumes.
3. Select Add Volume.
4. Mount the volume at:

/data

This ensures all application data remains available across deployments and restarts.

Database

No external database is required.

SnapOtter is a single-service application that manages its own data without PostgreSQL, MySQL, Redis, or other infrastructure services.

Build & Start

The application runs directly from the official SnapOtter container image.

No custom build or start commands are required.

Accessing the Application

After deployment:

1. Generate a Railway public domain.
2. Open the generated URL.
3. Create the administrator account.
4. Begin processing images through the web interface or automate workflows using the REST API.
5. Access the interactive API documentation at /api/docs on your deployed instance.

Why Deploy Toolkit on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Toolkit on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.