About

🐳 Nextcloud Docker image based on Alpine Linux and Nginx with advanced features.
If you are interested, check out my other 🐳 Docker images!

💡 Want to be notified of new releases? Check out 🔔 Diun (Docker Image Update Notifier) project!

Features

• Run as non-root user
• Tarball authenticity checked during building process
• Data, config, user apps and themes persistence in the same folder
• Automatic installation
• Cron task for Nextcloud background jobs as a sidecar cron container
• Handle Nextcloud News Updater for News plugin through a sidecar news updater container
• OPCache enabled to store precompiled script bytecode in shared memory
• APCu installed and configured
• Memcached and Redis also enabled to enhance server performance
• Database connectors MySQL/MariaDB, PostgreSQL and SQLite3 enabled
• Exif, IMAP, LDAP, FTP, GMP, SMB enabled (required for specific apps)
• FFmpeg, iconv, Imagick installed for preview generation
• s6-overlay as process supervisor
• Traefik as reverse proxy and creation/renewal of Let's Encrypt certificates (see this template)
• Redis for caching
• Collabora as an online Office Suite (see this template)
• MariaDB as database instance
• Nextcloud cron job as a "sidecar" container

Docker

Environment variables

General

• TZ: The timezone assigned to the container (default UTC)
• PUID: Nextcloud user id (default 1000)
• PGID: Nextcloud group id (default 1000)
• MEMORY_LIMIT: PHP memory limit (default 512M)
• UPLOAD_MAX_SIZE: Upload max size (default 512M)
• OPCACHE_MEM_SIZE: PHP OpCache memory consumption (default 128)
• APC_SHM_SIZE: APCu memory size (default 128M)
• REAL_IP_FROM: Trusted addresses that are known to send correct replacement addresses (default 0.0.0.0/32)
• REAL_IP_HEADER: Request header field whose value will be used to replace the client address (default X-Forwarded-For)
• LOG_IP_VAR: Use another variable to retrieve the remote IP address for access log_format on Nginx. (default remote_addr)

Nextcloud

• HSTS_HEADER: HTTP Strict Transport Security header value (default max-age=15768000; includeSubDomains)
• XFRAME_OPTS_HEADER: X-Frame-Options header value (default SAMEORIGIN)
• RP_HEADER: Referrer Policy header value (default strict-origin)
• SUBDIR: Subdir to use. Read this section for more info.
• DB_TYPE: Database type (mysql, pgsql or sqlite) (default sqlite)
• DB_NAME: Database name (default nextcloud)
• DB_USER: Username for database (default nextcloud)
• DB_PASSWORD: Password for database user (default asupersecretpassword)
• DB_HOST: Database host (default db)

Cron

⚠️ Only used if you enabled and run a sidecar cron container

• SIDECAR_CRON: Set to 1 to enable sidecar cron mode (default 0)
• CRON_PERIOD: Periodically execute Nextcloud cron (eg. */15 * * * *)

News Updater

⚠️ Only used if you enabled and run a sidecar news updater container

• SIDECAR_NEWSUPDATER: Set to 1 to enable sidecar news updater mode (default 0)
• NC_NEWSUPDATER_THREADS: How many feeds should be fetched in parallel (default 10)
• NC_NEWSUPDATER_TIMEOUT: Maximum number of seconds for updating a feed (default 300)
• NC_NEWSUPDATER_INTERVAL: Update interval between fetching the next round of updates in seconds (default 900)
• NC_NEWSUPDATER_LOGLEVEL: Log granularity, info will log all urls and received data, error will only log errors (default error)

Volumes

• /data: Contains config, data folders, installed user apps (not core ones), session, themes, tmp folders

⚠️ Note that the volume should be owned by the user/group with the specified PUID and PGID. If you don't give the volume correct permissions, the container may not start.

Ports

• 8000: HTTP port

Use this image

Docker Compose

Docker compose is the recommended way to run this image. Copy the content of folder examples/compose in /var/nextcloud/ on your host for example. Edit the compose and env files with your preferences and run the following commands:

docker-compose up -d
docker-compose logs -f

Command line

You can also use the following minimal command:

docker run -d -p 8000:8000 --name nextcloud \
  -v $(pwd)/data:/data \
  crazymax/nextcloud:latest

Upgrade

To upgrade to the latest version of Nextcloud, pull the newer image and launch the container. Nextcloud will upgrade automatically:

docker-compose pull
docker-compose up -d

Notes

First installation

If you run the container for the first time, the installation will be automatic using the DB_* environment variables.
Then open your browser to configure your admin account.

OCC command

If you want to use the occ command to perform common server operations like manage users, encryption, passwords, LDAP setting, and more, type:

docker-compose exec nextcloud occ

Cronjob

If you want to enable the cronjob, you have to run a "sidecar" container (see cron service in docker-compose.yml example) or run a simple container like this:

docker run -d --name nextcloud_cron \
  --env-file $(pwd)/nextcloud.env \
  -e SIDECAR_CRON=1 \
  -e CRON_PERIOD=*/15 * * * * \
  -v $(pwd)/data:/data \
  crazymax/nextcloud:latest

And do not forget to choose Cron as background jobs:

Nextcloud News Updater

If you want to enable the Nextcloud News Updater, you have to run a "sidecar" container (see news_updater service in docker-compose.yml example) or run a simple container like this:

docker run -d --name nextcloud_news_updater \
  --env-file $(pwd)/nextcloud.env \
  -e SIDECAR_NEWSUPDATER=1 \
  -e NC_NEWSUPDATER_THREADS=10 \
  -e NC_NEWSUPDATER_TIMEOUT=300 \
  -e NC_NEWSUPDATER_INTERVAL=900 \
  -e NC_NEWSUPDATER_LOGLEVEL=error \
  -v $(pwd)/data:/data \
  crazymax/nextcloud:latest

And do not forget to disable Use system cron for updates in news settings:

Email

Configure your Email server settings with your preferences:

Redis cache

Redis is recommended, alongside APCu to make Nextcloud more faster. If you want to enable Redis, deploy a redis container (see docker-compose file) and add this to your config.php:

    'memcache.local' => '\OC\Memcache\APCu',
    'memcache.distributed' => '\OC\Memcache\Redis',
    'memcache.locking' => '\OC\Memcache\Redis',
    'redis' => array(
        'host' => 'redis',
        'port' => 6379,
    ),

Running in a subdir

If you want to access your Nextcloud installation in a subdir (like /nextcloud), you have to set the SUBDIR environment variable and also add PathPrefixStrip:/nextcloud to your frontend rule if you use Traefik. Do not forget to remove includeSubDomains option in HSTS_HEADER if used.

How can I help ?

All kinds of contributions are welcome 🙌! The most basic way to show your support is to star 🌟 the project, or to raise issues 💬 You can also support this project by becoming a sponsor on GitHub 👏 or by making a Paypal donation to ensure this journey continues indefinitely! 🚀

Thanks again for your support, it is much appreciated! 🙏

License

MIT. See LICENSE for more details.