Diocrafts
f08cffc0e8
- Add docs/ with VitePress site (19 pages): guide, config, architecture, FAQ - Add GitHub Actions workflow for auto-deploy to GitHub Pages - Replace music 'Add Tracks' upload picker with in-app audio file browser modal - Add music picker CSS styles with dark theme support - Add missing i18n keys (search_audio, no_audio_files, etc.) to all 14 locales - Optimize Dockerfile: shared base stage, COPY --chmod, consolidated RUN, HEALTHCHECK - Improve README: docs links, updated stats (222+ tests, 14 languages), feature status
95 lines
2.1 KiB
Markdown
95 lines
2.1 KiB
Markdown
# Quick Start
|
|
|
|
## Docker (recommended)
|
|
|
|
```bash
|
|
git clone https://github.com/DioCrafts/oxicloud.git
|
|
cd oxicloud
|
|
cp example.env .env
|
|
docker compose up -d
|
|
```
|
|
|
|
Open **http://localhost:8086**. That's it.
|
|
|
|
### Docker Compose
|
|
|
|
```yaml
|
|
services:
|
|
postgres:
|
|
image: postgres:17.4-alpine
|
|
environment:
|
|
POSTGRES_DB: oxicloud
|
|
POSTGRES_USER: postgres
|
|
POSTGRES_PASSWORD: postgres
|
|
volumes:
|
|
- pg_data:/var/lib/postgresql/data
|
|
- ./db/schema.sql:/docker-entrypoint-initdb.d/schema.sql
|
|
healthcheck:
|
|
test: ["CMD-SHELL", "pg_isready -U postgres"]
|
|
interval: 5s
|
|
timeout: 5s
|
|
retries: 5
|
|
|
|
oxicloud:
|
|
image: oxicloud:latest
|
|
ports:
|
|
- "8086:8086"
|
|
env_file:
|
|
- .env
|
|
volumes:
|
|
- storage_data:/app/storage
|
|
depends_on:
|
|
postgres:
|
|
condition: service_healthy
|
|
|
|
volumes:
|
|
pg_data:
|
|
storage_data:
|
|
```
|
|
|
|
## From Source
|
|
|
|
Requires **Rust 1.93+** and **PostgreSQL 13+**.
|
|
|
|
```bash
|
|
git clone https://github.com/DioCrafts/oxicloud.git
|
|
cd oxicloud
|
|
echo "DATABASE_URL=postgres://user:pass@localhost/oxicloud" > .env
|
|
cargo build --release
|
|
cargo run --release
|
|
```
|
|
|
|
## Kubernetes (Helm)
|
|
|
|
```bash
|
|
helm upgrade --install oxicloud charts/oxicloud \
|
|
-f charts/oxicloud/values.yaml
|
|
```
|
|
|
|
Verify:
|
|
|
|
```bash
|
|
kubectl get pods -n oxicloud
|
|
kubectl logs statefulset/oxicloud -n oxicloud
|
|
```
|
|
|
|
## Client Setup
|
|
|
|
| Client | Protocol | URL |
|
|
|--------|----------|-----|
|
|
| Windows Explorer | WebDAV | `http://host:8086/webdav/` |
|
|
| macOS Finder | WebDAV | `http://host:8086/webdav/` |
|
|
| Nautilus / Dolphin | WebDAV | `dav://host:8086/webdav/` |
|
|
| Thunderbird (calendar) | CalDAV | `http://host:8086/caldav/` |
|
|
| Thunderbird (contacts) | CardDAV | `http://host:8086/carddav/` |
|
|
| DAVx⁵ (Android) | CalDAV + CardDAV | `http://host:8086/` |
|
|
| GNOME Calendar | CalDAV | `http://host:8086/caldav/` |
|
|
| GNOME Contacts | CardDAV | `http://host:8086/carddav/` |
|
|
| Collabora / OnlyOffice | WOPI | See [WOPI configuration](/config/wopi) |
|
|
|
|
## What's Next?
|
|
|
|
- [Environment Variables →](/config/env)
|
|
- [OIDC / SSO Setup →](/config/oidc)
|
|
- [WebDAV Guide →](/guide/webdav)
|