Owncloud

Stack

ownCloud is a self-hosted file sync and share server. It provides access to your data through a web interface, sync clients or WebDAV while providing a platform to view, sync and share across devices easily—all under your control. ownCloud’s open architecture is extensible via a simple but powerful API for applications and plugins and it works with any storage.

Configuration

Type

Compose

Platform

linux

Env vars

PUID=1000PGID=100TZ=''OWNCLOUD_DOMAIN=''DB_PASSWORD=''ADMIN_USERNAME=''ADMIN_PASSWORD=''PORT=''

Source

Repo

Template by Qballjos·Source

Notes

The database user is owncloud and the database is owncloud.

Services

nextcloud

Configuration

Image

owncloud/server:latest

Ports

${PORT}:8080

Volumes

/mnt/data : /portainer/Files/AppData/Config/Owncloud/data

Env vars

PUID=${PUID}PGID=${PGID}TZ=${TZ}OWNCLOUD_DOMAIN=${OWNCLOUD_DOMAIN}OWNCLOUD_DB_TYPE=mysqlOWNCLOUD_DB_NAME=owncloudOWNCLOUD_DB_USERNAME=owncloudOWNCLOUD_DB_PASSWORD=${DB_PASSWORD}OWNCLOUD_DB_HOST=owncloudmariadbOWNCLOUD_ADMIN_USERNAME=${ADMIN_USERNAME}OWNCLOUD_ADMIN_PASSWORD=${ADMIN_PASSWORD}OWNCLOUD_MYSQL_UTF8MB4=trueOWNCLOUD_REDIS_ENABLED=trueOWNCLOUD_REDIS_HOST=owncloudredis

Restart

unless-stopped

Image details

Pulls: 32.5M

User: owncloud

Created: Apr 24, 2018

Updated: 13 days ago

Status: active

owncloudmariadb

Configuration

Image

mariadb:10.5

Volumes

/var/lib/mysql : /portainer/Files/AppData/Config/Owncloud/DB

Env vars

PUID=${PUID}PGID=${PGID}TZ=${TZ}MYSQL_ROOT_PASSWORD=${DB_PASSWORD}MYSQL_USER=owncloudMYSQL_PASSWORD=${DB_PASSWORD}MYSQL_DATABASE=owncloud

Restart

unless-stopped

Image details

Pulls: 3.2B

User: stackbrew

Created: Nov 25, 2014

Updated: 2 days ago

Status: active

owncloudredis

Configuration

Image

redis:6

Volumes

/data : /portainer/Files/AppData/Config/Owncloud/redis

Restart

unless-stopped

Image details

Pulls: 11.1B

User: stackbrew

Created: Jun 05, 2014

Updated: 9 days ago

Status: active

Standalone Install

Select an install method, to see config/commands for deploying Owncloud

Installation method

Docker Run

Docker Compose

Install on Portainer

Import all app templates into your Portainer instance, for easy 1-click deploys

Ensure both Docker and Portainer are installed, and up-to-date
Log into your Portainer web UI
Under Settings → App Templates, paste the below URL
Head to Home → App Templates, and the list of apps will show up
Select Owncloud, fill in any config options, and hit Deploy

Template Import URL

https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json

Show Me

Original stackfile

The compose file this template deploys, straight from its repo:

---
version: "2"
services:
  nextcloud:
    image: owncloud/server:latest
    container_name: owncloud
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=${TZ}
      - OWNCLOUD_DOMAIN=${OWNCLOUD_DOMAIN}
      - OWNCLOUD_DB_TYPE=mysql
      - OWNCLOUD_DB_NAME=owncloud
      - OWNCLOUD_DB_USERNAME=owncloud
      - OWNCLOUD_DB_PASSWORD=${DB_PASSWORD}
      - OWNCLOUD_DB_HOST=owncloudmariadb
      - OWNCLOUD_ADMIN_USERNAME=${ADMIN_USERNAME}
      - OWNCLOUD_ADMIN_PASSWORD=${ADMIN_PASSWORD}
      - OWNCLOUD_MYSQL_UTF8MB4=true
      - OWNCLOUD_REDIS_ENABLED=true
      - OWNCLOUD_REDIS_HOST=owncloudredis
    volumes:
      - /portainer/Files/AppData/Config/Owncloud/data:/mnt/data
    ports:
      - ${PORT}:8080
    restart: unless-stopped
    depends_on:
      - owncloudmariadb
      - owncloudredis
  owncloudmariadb:
    image: mariadb:10.5
    container_name: owncloudmariadb
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=${TZ}
      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD}
      - MYSQL_USER=owncloud
      - MYSQL_PASSWORD=${DB_PASSWORD}
      - MYSQL_DATABASE=owncloud
    volumes:
      - /portainer/Files/AppData/Config/Owncloud/DB:/var/lib/mysql
    restart: unless-stopped
  owncloudredis:
    image: redis:6
    container_name: owncloudredis
    volumes:
      - /portainer/Files/AppData/Config/Owncloud/redis:/data
    restart: unless-stopped

Or deploy it directly from the source:

git clone https://github.com/Qballjos/portainer_templates
cd portainer_templates
docker compose -f Template/Stack/owncloud.yml up -d

More install options in our documentation.

Container Documentation

nextcloud Documentation

ownCloud - Secure Collaboration Platform

owncloudmariadb Documentation

MariaDB Server is a high performing open source relational database, forked from MySQL.

owncloudredis Documentation

Redis is the world’s fastest data platform for caching, vector search, and NoSQL databases.

Check the logs first

Nine times out of ten the logs tell you exactly what went wrong.

In Portainer, go to Containers, click the container, then Logs. Or run docker logs <container>
Exit codes help too: 137 means killed, usually out of memory. 126 or 127 means the command inside the image is broken.

Permission denied on volumes

If the logs show "permission denied", the app can't write to its data folder on the host.

Fix the ownership: sudo chown -R ${PUID}:${PGID} /portainer/Files/AppData/Config/Owncloud/data (and the same for the other mapped folders)
Or set the PUID and PGID variables (defaults ${PUID}:${PGID}) to match your own user, found with id $USER

Image won't pull

Test the pull directly on the host: docker pull owncloud/server:latest

"manifest unknown" means the tag no longer exists. This template uses latest, so try pinning a specific version instead.
"toomanyrequests" is the Docker Hub rate limit. Log in with docker login to raise it.
"no space left on device" means a full disk. Reclaim space with docker system prune

"exec format error"

This means the image was built for a different CPU architecture than your server.

Check yours with uname -m: x86_64 is amd64, aarch64 is arm64. Raspberry Pi and other ARM boards are the usual culprits.

Container keeps restarting

The unless-stopped restart policy relaunches the app after every crash, so the real error can scroll past.

Check the logs right after a restart, the last few lines before it died are the useful ones.
Get the exit code with docker inspect <container> --format '{{.State.ExitCode}}'
Still stuck? Redeploy once with the restart policy set to no so the failure stays visible.

Stack won't deploy

Compose stacks fail fast on small mistakes, and Portainer shows the reason just above the editor.

YAML only accepts spaces for indentation, a single tab breaks the whole file.

Raise an issue

Found something which isn't working as it should? Here's how to report it.

Bug within the app: Open an issue within Owncloud's repo
Template not working: Open an issue on Qballjos/portainer_templates
This website not working: Open an issue on lissy93/portainer-templates

A Compose stack

Owncloud is a Compose stack, a set of containers (3 of them) defined in one file and brought up together by Portainer, then started and stopped as a single app.

The services

This stack is built from 3 containers that run side by side. Here's each one, with the image it runs and anything it waits for first:

nextcloud runs owncloud/server:latest, starts after owncloudmariadb, owncloudredis
owncloudmariadb runs mariadb:10.5
owncloudredis runs redis:6

Volumes

A volume is where Owncloud keeps its files so they survive an update or a restart. Without one, anything it saves would sit inside the container and vanish the moment it's recreated. This template mounts:

/mnt/data from /portainer/Files/AppData/Config/Owncloud/data on the host
/var/lib/mysql from /portainer/Files/AppData/Config/Owncloud/DB on the host
/data from /portainer/Files/AppData/Config/Owncloud/redis on the host

Environment variables

Environment variables are the settings you hand over when you deploy, things like a password or a timezone. Owncloud takes 18 of them, all with defaults you can leave alone or tweak:

PUID, pulled from your own environment
PGID, pulled from your own environment
TZ, pulled from your own environment
OWNCLOUD_DOMAIN, pulled from your own environment
OWNCLOUD_DB_TYPE, defaults to mysql
OWNCLOUD_DB_NAME, defaults to owncloud
OWNCLOUD_DB_USERNAME, defaults to owncloud
OWNCLOUD_DB_PASSWORD, pulled from your own environment
OWNCLOUD_DB_HOST, defaults to owncloudmariadb
OWNCLOUD_ADMIN_USERNAME, pulled from your own environment
OWNCLOUD_ADMIN_PASSWORD, pulled from your own environment
OWNCLOUD_MYSQL_UTF8MB4, defaults to true
OWNCLOUD_REDIS_ENABLED, defaults to true
OWNCLOUD_REDIS_HOST, defaults to owncloudredis
MYSQL_ROOT_PASSWORD, pulled from your own environment
MYSQL_USER, defaults to owncloud
MYSQL_PASSWORD, pulled from your own environment
MYSQL_DATABASE, defaults to owncloud

Restart policy

The restart policy here is unless-stopped, so Docker restarts Owncloud after a crash or reboot, but leaves it off when you stop it on purpose. You can change this on the deploy screen. The choices are no (never restart), on-failure (only after a crash), unless-stopped (restart unless you stop it), and always (bring it back no matter what).

Users and permissions

The PUID and PGID settings tell it which user and group to act as on your host. Point them at your own account (find yours with id $USER) so the files it writes into your mounted folders come out owned by you rather than root.

Networking

Portainer puts these services on one shared private network, so they can find each other by name (like nextcloud) while only the ports above are open to you.

Platform

The platform is linux, the kind of system the container is built to run on. Docker and Portainer handle this on a normal Linux server.

Portainer app templates

Zooming out, this whole page comes from a Portainer app template: a short recipe telling Portainer how to set Owncloud up. Add the template list to Portainer once, then deploying Owncloud is a click rather than a wall of config.

Owncloud

Configuration

Notes

Services

nextcloud

Configuration

Image details

owncloudmariadb

Configuration

Image details

owncloudredis

Configuration

Image details

Standalone Install

Install on Portainer

Template Import URL

Container Documentation

nextcloud Documentation

owncloudmariadb Documentation

owncloudredis Documentation

Troubleshooting

Check the logs first

Permission denied on volumes

Image won't pull

"exec format error"

Container keeps restarting

Stack won't deploy

Raise an issue

Config glossary

A Compose stack

The services

Volumes

Environment variables

Restart policy

Users and permissions

Networking

Platform

Portainer app templates

Similar apps