How do I deploy rotki on Railway?

You can deploy rotki on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: rotki-ff215a8e, or join our Discord community for more assistance.

Deploy and Host rotki on Railway

rotki is an open-source, privacy-first portfolio tracking, accounting, and analytics tool for cryptocurrency and DeFi assets. Unlike cloud-based SaaS competitors, rotki stores your financial data encrypted locally on your computer while providing comprehensive multi-chain portfolio management, profit/loss reporting, tax documentation, and transaction history across 300+ exchanges, wallets, and DeFi protocols.

About Hosting rotki

Hosting rotki requires deploying a Docker container that runs both the Python backend and Node.js frontend. The application uses persistent storage for encrypted user databases and logs, with typical storage requirements of 5-8GB. rotki operates as a self-contained web application accessible via browser on port 80 (mapped to your preferred host port). The deployment is stateful, requiring volumes for /data and /logs directories to persist user accounts, transaction history, and application logs. rotki supports environment variable configuration for logging levels, timezone settings, and performance tuning. The application is designed for single-user or small team deployments prioritizing data privacy and sovereignty over traditional multi-tenant SaaS architectures.

Common Use Cases

Cryptocurrency Tax Reporting: Generate comprehensive profit/loss reports across all blockchain transactions, DeFi interactions, and exchange trades for tax compliance in multiple jurisdictions
Multi-Chain Portfolio Management: Track and analyze cryptocurrency holdings across Ethereum, Bitcoin, and EVM-compatible chains (Polygon, Arbitrum, BSC) along with 300+ centralized exchanges
DeFi Analytics: Monitor lending/borrowing positions, liquidity pool participation, yield farming returns, and historical DeFi protocol interactions with automated profit/loss calculations
Privacy-Conscious Financial Tracking: Self-host financial data to maintain complete control over sensitive portfolio information without trusting third-party SaaS providers

Dependencies for rotki Hosting

Persistent Storage Volumes: Two separate volumes required - one for encrypted user data (minimum 5GB recommended) and one for application logs (minimum 3GB recommended)
Port Exposure: Single HTTP port (container port 80) must be exposed for web interface access

Deployment Dependencies

Implementation Details

Environment Variables for Production:

# Logging Configuration
LOGLEVEL=info                      # Options: debug, info, warning, error, critical
LOGFROMOTHERMODULES=true           # Enable logging from external modules
MAX_SIZE_IN_MB_ALL_LOGS=550       # Maximum combined log file size
MAX_LOGFILES_NUM=3                 # Number of log files to retain
SQLITE_INSTRUCTIONS=0              # SQLite optimization setting

# Timezone (use IANA timezone database)
TZ=UTC                            # e.g., America/New_York, Europe/London

# Security (optional)
ROTKI_ACCEPT_DOCKER_RISK=1        # Acknowledge Docker deployment risks

Volume Mount Paths:

/data - User databases, encrypted wallets, and account information
/logs - Application logs and debug information

Important Security Note: rotki was designed as a local-first application. When deploying to Railway, ensure you:

Use Railway's private networking when possible
Implement authentication via reverse proxy (Railway provides HTTPS by default)
Do not expose rotki directly to the public internet without additional security layers
Regularly backup the /data volume as it contains encrypted financial data

Why Deploy rotki 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 rotki 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.