---
title: "Deploy OxiCloud"
description: "Fast Rust file cloud: WebDAV, CalDAV, CardDAV; admin seeded."
category: "Storage"
url: https://railway.com/deploy/oxicloud
---

# Deploy OxiCloud

Fast Rust file cloud: WebDAV, CalDAV, CardDAV; admin seeded.

**[Deploy OxiCloud on Railway](https://railway.com/template/oxicloud)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/oxicloud/manifest.json

- **Creator:** Youssef Siam
- **Category:** Storage

## Template content

### db

- **Image:** postgres:18.2-alpine3.23

### oxicloud

- **Image:** ghcr.io/youssefsiam38/oxicloud-railway:1.0.0
- **Health check:** /ready
- **Public domain:** Yes

## Documentation

# Deploy and Host OxiCloud on Railway

OxiCloud is a fast, self-hosted file cloud written in Rust: a web file manager with sharing, plus WebDAV, CalDAV
and CardDAV — a lightweight alternative to heavier file-sync suites. This is a community-maintained template; it
is not affiliated with the OxiCloud project.

## About Hosting OxiCloud

OxiCloud is a single Rust server backed by PostgreSQL, storing file contents on disk. On a fresh, publicly
reachable instance its one-time setup page makes whoever opens it first the administrator, and self-registration
starts enabled — so a naive deploy can be claimed or joined by strangers.

This template runs OxiCloud on Railway with PostgreSQL, seeds your administrator account at start-up (so the
setup page cannot be claimed by someone else), keeps public self-registration disabled, and wires the database,
the public base URL and the file-storage volume. WebDAV, CalDAV and CardDAV work with your OxiCloud account
credentials.

## Common Use Cases

- A private personal or team file cloud with a web UI and WebDAV access.
- A self-hosted CalDAV/CardDAV server for calendars and contacts.
- A lightweight, resource-friendly alternative to larger file-sync platforms.

## Dependencies for OxiCloud Hosting

- Nothing external — PostgreSQL is bundled and file contents live on a volume.

### Deployment Dependencies

- OxiCloud: https://github.com/AtalayaLabs/OxiCloud (MIT)
- PostgreSQL: https://www.postgresql.org (official Docker image)
- Template repository, image and tests: https://github.com/youssefsiam38/oxicloud-railway

### Implementation Details

OxiCloud runs upstream's official image, pinned by digest, with a start-up wrapper that creates the first admin
through the one-time `/api/setup` endpoint (closing the race where a stranger could claim it) using a password
sent via a temp file, never the command line. Self-registration is disabled, the database connection and public
base URL are set, and both the metadata (PostgreSQL) and file-content (storage) volumes are attached.

Tested in CI and on a live deployment of this template: the admin is seeded, `/api/setup` is then closed, login
works and registration is refused, an authenticated folder operation succeeds, and a redeploy keeps the admin
and data.

The deploy form asks for `OWNER_EMAIL` and generates `OWNER_PASSWORD` (username `admin`). Copy the password from
the oxicloud service's variables and sign in on the app's domain.

## Why Deploy OxiCloud 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 OxiCloud 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.


## Similar templates

- [Garage S3 Storage](https://railway.com/deploy/garage-s3-storage) — Ultra-light S3 server: fast, open-source, plug-and-play.
- [Redis](https://railway.com/deploy/redis-1) — Self Host Latest Redis with Railway
- [EasyImg](https://railway.com/deploy/easyimg) — Simple self-hostable Nuxt.js personal image hosting system.

Open this page in a browser: https://railway.com/deploy/oxicloud