OxiCloud
diocrafts/oxicloud:latest
https://hub.docker.com/r/diocrafts/oxicloud
bridge
false
sh
--restart=unless-stopped
https://github.com/paulmeier/oxicloud-unraid/issues
https://github.com/AtalayaLabs/OxiCloud
Cloud: Network:Web Productivity:
https://raw.githubusercontent.com/paulmeier/oxicloud-unraid/main/icons/oxicloud.png
https://raw.githubusercontent.com/paulmeier/oxicloud-unraid/main/templates/oxicloud.xml
http://[IP]:[PORT:8086]
/app/storage/.tailscale_state
OxiCloud is an ultra-fast, lightweight self-hosted cloud built in Rust. It gives you files, sharing, previews, trash, search, photos, plus calendars and contacts over WebDAV, CalDAV, and CardDAV, with OIDC SSO, per-user quotas, and shared links. OxiCloud needs an EXTERNAL PostgreSQL database (it has no built-in DB) so install a PostgreSQL container first. The schema is created automatically on first start. There is no default login: open the WebUI after the first start and create your admin account.
An external PostgreSQL database is required. Install a PostgreSQL container (for example the official postgres image from Community Applications), create a database and a user, then fill in the Database Connection String field before starting OxiCloud. On first start, open the WebUI and create your admin account.
cloud storage files nextcloud alternative owncloud webdav caldav carddav rust self-hosted oidc sso photos calendar contacts office
8086
postgres://oxicloud:oxicloud@HOST-IP:5432/oxicloud
/mnt/user/appdata/oxicloud
0.0.0.0
8086
false
OxiCloud is an ultra-fast, secure, and lightweight self-hosted cloud built in Rust. It targets self-hosters, home labs, and small teams who want the useful parts of a cloud suite without the operational drag of a heavy PHP stack: files, previews, sharing, trash, search, favorites, and recent items, plus calendars and contacts over standard WebDAV, CalDAV, and CardDAV, with OIDC SSO, per-user quotas, roles, and shared links.
REQUIRED: EXTERNAL POSTGRESQL
OxiCloud stores its metadata in PostgreSQL and has no embedded database. Before starting OxiCloud you must run a PostgreSQL container and point the Database Connection String at it.
1. Install a PostgreSQL container from Community Applications (the official postgres image works well).
2. Give it a database and a role. The simplest setup is a database named oxicloud owned by a role named oxicloud with a password you choose.
3. In this template set the Database Connection String to postgres://oxicloud:yourpassword@HOST-IP:5432/oxicloud where HOST-IP is the PostgreSQL container address or the Unraid host IP.
4. The database schema and all migrations are applied automatically by OxiCloud the first time it starts. No manual import is needed.
FIRST-RUN SETUP
There is no default username or password. After the container starts, open the WebUI and create the first admin account through the sign-up screen. Once your accounts exist you can set Disable Open Registration to true to lock down sign-ups.
PERSISTENCE
Everything OxiCloud needs to keep lives under the Storage volume: the blob store with your files, the auto-generated .jwt_secret (so sessions survive restarts), the search index, and the Tailscale state directory. Keep this volume backed up. For a large library you can map it to an array share rather than the cache-backed appdata path.
TAILSCALE
This template supports Unraid's built-in Tailscale integration so the container can join your tailnet as its own device. To enable it, edit the container, switch to Advanced View, toggle Use Tailscale on, set a hostname, and Apply. The template already declares the Tailscale State directory inside the Storage volume, so the machine identity persists across updates and you will not hit the Couldn't detect persistent Docker directory error. After applying, open the container log and click the authentication link to approve it on your tailnet. When reaching OxiCloud over a Tailscale hostname, also set the Public Base URL field so share links and redirects use the right address.
REVERSE PROXY AND SSO
Set Public Base URL to your external address when serving OxiCloud through a reverse proxy or a domain. OIDC SSO and office editing (WOPI) are configured through additional OXICLOUD_ environment variables. See the project documentation for the full list.
Project: https://github.com/AtalayaLabs/OxiCloud