{"id":17561642,"url":"https://github.com/juliusknorr/nextcloud-docker-dev","last_synced_at":"2025-05-16T16:09:59.797Z","repository":{"id":27647055,"uuid":"106183092","full_name":"juliusknorr/nextcloud-docker-dev","owner":"juliusknorr","description":"Nextcloud development environment using docker-compose","archived":false,"fork":false,"pushed_at":"2025-05-12T06:48:45.000Z","size":31016,"stargazers_count":155,"open_issues_count":48,"forks_count":84,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-05-15T18:54:34.235Z","etag":null,"topics":["development-environment","docker-compose","nextcloud"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/juliusknorr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-08T14:34:50.000Z","updated_at":"2025-05-12T06:48:49.000Z","dependencies_parsed_at":"2024-09-15T14:15:06.436Z","dependency_job_id":"3bf7de66-e562-46a8-866e-4f33fa219fdf","html_url":"https://github.com/juliusknorr/nextcloud-docker-dev","commit_stats":{"total_commits":481,"total_committers":52,"mean_commits":9.25,"dds":0.4137214137214137,"last_synced_commit":"95735e4ae280c0ead26c24beaf64ef054dc0a0d7"},"previous_names":["juliusknorr/nextcloud-docker-dev","juliushaertl/nextcloud-docker-dev"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusknorr%2Fnextcloud-docker-dev","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusknorr%2Fnextcloud-docker-dev/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusknorr%2Fnextcloud-docker-dev/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliusknorr%2Fnextcloud-docker-dev/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juliusknorr","download_url":"https://codeload.github.com/juliusknorr/nextcloud-docker-dev/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254564127,"owners_count":22092122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["development-environment","docker-compose","nextcloud"],"created_at":"2024-10-21T12:06:48.242Z","updated_at":"2025-05-16T16:09:59.773Z","avatar_url":"https://github.com/juliusknorr.png","language":"PHP","readme":"# Nextcloud development environment on Docker Compose\n\n[Documentation](https://juliusknorr.github.io/nextcloud-docker-dev/) | [Nextcloud Developer Portal](https://nextcloud.com/developer/)\n\nNextcloud's development environment using Docker Compose providing a large variety of services for Nextcloud server and app development and testing.\n\n⚠ **DO NOT USE THIS IN PRODUCTION** Various settings in this setup are considered insecure and default passwords and secrets are used all over the place\n\n- ☁ Nextcloud containers for running multiple versions\n- 🐘 Multiple PHP versions\n- 🔒 Nginx proxy with optional SSL termination\n- 🛢️ MySQL/PostgreSQL/MariaDB/SQLite/MaxScale, Redis cache\n- 💾 Local or S3 primary storage\n- 👥 LDAP with example user data, Keycloak\n- ✉ Mailhog for testing mail sending\n- 🚀 Blackfire, Xdebug for profiling and debugging\n- 📄 Lots of integrating service containers: Collabora Online, Onlyoffice, Elasticsearch, ...\n\n## Tutorial\n\nYou can find a step-by-step tutorial on how to use this setup in the [Nextcloud Developer Portal](https://nextcloud.com/developer/). It will guide you through the setup and show you how to use it for app development: https://cloud.nextcloud.com/s/iyNGp8ryWxc7Efa?path=%2F1%20Setting%20up%20a%20development%20environment\n\nIn detail explanation of the setup and its features and configuration options can be found in the [nextcloud-docker-dev documentation](https://juliusknorr.github.io/nextcloud-docker-dev/).\n\n## Quickstart\n\n### Persistent development setup\n\n\u003e [!TIP]\n\u003e This is the recommended way to run the setup for development. You will have a local clone of all required source code.\n\nTo start the setup run the following commands to clone the repository and bootstrap the setup. This will prepare your setup and clone the Nextcloud server repository and required apps into the `workspace` folder.\n```bash\ngit clone https://github.com/juliusknorr/nextcloud-docker-dev\ncd nextcloud-docker-dev\n./bootstrap.sh\n```\n\nDepending on your docker version you will need to use `docker-compose` instead of `docker compose` in the following commands.\n\nThis may take some time depending on your internet connection speed.\n\nOnce done you can start the Nextcloud container using:\n```bash\ndocker compose up nextcloud\n```\n\nYou can also start it in the background using `docker compose up -d nextcloud`.\n\nYou can then access your Nextcloud instance at [http://nextcloud.local](http://nextcloud.local). The default username is `admin` and the password is `admin`. [Other users can be found in the documentation](https://juliusknorr.github.io/nextcloud-docker-dev/basics/overview/#default-users).\n\n\u003e [!WARN]\n\u003e Note that for performance reasons the server repository might have been cloned with `--depth=1` by default. To get the full history it is highly recommended to run:\n\u003e\n\u003e ```bash\n\u003e cd workspace/server\n\u003e git fetch --unshallow\n\u003e git config remote.origin.fetch \"+refs/heads/*:refs/remotes/origin/*\"\n\u003e git fetch origin\n\u003e ```\n\n\n### Standalone containers\n\n\u003e [!TIP]\n\u003e This is a very simple way but doesn't cover all features. If you are looking for a fully featured setup you may skip to the next section\n\nThere is a standalone version of the Nextcloud containers available that can be used to run Nextcloud without the other services. This is useful if you are just wanting to get started with app development against a specific server version, or to just have a quick way to develop, test or debug.\n\nThese containers support automatic fetching of the server source code and use SQLite as the database. The server source code is fetched from the official Nextcloud server repository and the version can be specified using the `NEXTCLOUD_VERSION` environment variable. The default version is `master`.\n\nRunning the containers does not need this repository to be cloned.\n\nExample for running a Nextcloud server from the master branch of server:\n\n```bash\ndocker run --rm -p 8080:80 ghcr.io/juliusknorr/nextcloud-dev-php81:latest\n```\n\nFor app development you can mount your app directly into the container:\n\n```bash\ndocker run --rm -p 8080:80 -v ~/path/to/appid:/var/www/html/apps-extra/appid ghcr.io/juliusknorr/nextcloud-dev-php81:latest\n```\n\nThe `SERVER_BRANCH` environment variable can be used to run different versions of Nextcloud by specifying either a server branch or git tag.\n\n```bash\ndocker run --rm -p 8080:80 -e SERVER_BRANCH=v24.0.1 ghcr.io/juliusknorr/nextcloud-dev-php81:latest\n```\n\nYou can also mount your local server source code into the container to run a local version of Nextcloud:\n\n```bash\ndocker run --rm -p 8080:80 -e SERVER_BRANCH=v24.0.1 -v /tmp/server:/var/www/html ghcr.io/juliusknorr/nextcloud-dev-php81:latest\n```\n## More features\n\nYou can find documentation for more advanced features in [nextcloud-docker-dev documentation](https://juliusknorr.github.io/nextcloud-docker-dev/) for example:\n\n- Running stable Nextcloud versions in parallel\n- Using different database backends\n- Using HTTPS\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliusknorr%2Fnextcloud-docker-dev","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuliusknorr%2Fnextcloud-docker-dev","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliusknorr%2Fnextcloud-docker-dev/lists"}