ocis-deployment/README.md

37 lines
1.5 KiB
Markdown
Raw Normal View History

2023-09-02 07:33:19 -04:00
# OwnCloud "Infinite Scale"
OCIS is an alternative to OwnCloud/NextCloud which comes with a much more limited
feature-set, but eliminates the performance and (🤞) stability issues inherent to
those legacy codebases due to their having been written in PHP. OCIS is written
in Go and provides a singles static binary, which creates that strict barrier
between application code and persistent data which has bitten me so many times.
## First run
If you've just cloned this to a new machine, you have to bootstrap the service:
```console
$ mkdir -p mounts/{config,data}
$ docker compose run init
2023-09-16 14:52:56 -04:00
$ sh gen-secrets.sh
$ sh dns.sh # requires `doctl auth init` be run on the machine once before
2023-09-02 07:33:19 -04:00
```
## Subsequent runs
2023-09-02 10:06:35 -04:00
The application requires nothing special, just a `docker compose up`.
## Documentation and some useful links
- OCIS homepage: https://owncloud.com/infinite-scale-4-0
- Docker deployment instructions:
https://doc.owncloud.com/ocis/next/deployment/container/container-setup.html
- Rather complete example docker-compose file with Traefik+WOPI/CODE+search
https://github.com/owncloud/ocis/blob/master/deployments/examples/ocis_traefik/docker-compose.yml
2023-09-02 10:52:38 -04:00
## Backups
The service is running on retastokado, a 6TB ZFS mirrored pair at Scott's home.
It has limited upload speed. Sanoid is configured, via NixOS config, to keep 48
hourly, 14 daily, 3 monthly, and 1 yearly snapshot of the config (`/etc/ocis`)
and data (`/var/lib/ocis`) volumes. Adding another zpool at another location and
configuring Syncoid would provide a sound backup strategy.