Deploy Nextcloud on TurboStack
Deploy Nextcloud on TurboStack - PHP, MySQL or PostgreSQL and required Redis - with an annotated example host YAML.
Nextcloud is a self-hosted platform for file sync, sharing, and collaboration. TurboStack provisions the runtime and services, can auto-install Nextcloud, and handles large upload limits without extra configuration.
Requirements
Note
Redis is required, not optional. Nextcloud uses it for transactional file locking, so concurrent edits stay consistent.
Configure it
- Open your host and go to the Applications tab.
- Select Add app or database and set App Type to
nextcloud. - Choose PHP 8.4 as the runtime and set the server name for your cloud.
- Enable a database (MySQL or PostgreSQL) and enable Redis.
- Publish the host to apply the configuration.
Example configuration
webserver: nginx
mysql_version: "8.4" # or: postgresql_version: "17"
redis_enabled: true # REQUIRED: transactional file locking + cache
system_users:
- username: prod
vhosts:
- server_name: cloud.example.com
app_type: nextcloud
php_version: "8.4"
cert_type: letsencrypt
Tip
Prefer PostgreSQL? Replace mysql_version with postgresql_version: "17" to provision PostgreSQL as the Nextcloud database instead.
Why these choices
app_type: nextcloudapplies the Nextcloud runtime profile and can auto-install the application.- Redis is mandatory for transactional file locking and caching under concurrent use.
- MySQL 8.4 is a solid default;
postgresql_versionis a fully supported alternative. - Nginx (or apache2) plus PHP 8.4 matches Nextcloud's recommended stack and large upload handling.
- Let's Encrypt provides automatic Transport Layer Security (TLS) for the cloud hostname.
Related
-
Best practices - performance & stability.
-
Troubleshooting - logs & common fixes.