This is a one-command Nextcloud instance that makes it possible to test different branches and apps with just one command.
Install Docker on your OS:
- On Linux via:
curl -fsSL get.docker.com | sudo sh - On macOS and Windows via Docker Desktop: https://www.docker.com/products/docker-desktop
Run the container:
(You can change the branch by changing master in SERVER_BRANCH=master to the branch that you want to test during the initial container creation.)
On Linux and macOS:
docker run -it \
-e SERVER_BRANCH=master \
--name nextcloud-easy-test \
-p 127.0.0.1:8443:443 \
--volume="nextcloud_easy_test_npm_cache_volume:/var/www/.npm" \
ghcr.io/szaimen/nextcloud-easy-test:latest
On Windows
docker run -it ^
-e SERVER_BRANCH=master ^
--name nextcloud-easy-test ^
-p 127.0.0.1:8443:443 ^
--volume="nextcloud_easy_test_npm_cache_volume:/var/www/.npm" ^
ghcr.io/szaimen/nextcloud-easy-test:latest
Explanation of the command
docker run -it
This command creates a new docker container.
-e SERVER_BRANCH=master
This inserts the environment variable SERVER_BRANCH into the container and sets it to the value master.
--name nextcloud-easy-test
This gives the container a distinct name nextcloud-easy-test so that you are able to easily run other docker commands on the container.
-p 127.0.0.1:8443:443
This makes the container listen on localhost and maps the host port 8443 to the container port 443 so that you are able to access the container by opening https://localhost:8443.
--volume="nextcloud_easy_test_npm_cache_volume:/var/www/.npm"
This stores the npm cache in a docker volume so that compiling apps takes less time from the second time. You can clean it with sudo docker volume rm nextcloud_easy_test_npm_cache_volume.
ghcr.io/szaimen/nextcloud-easy-test:latest
This is the image name that you will use as base for the container. latest is the tag that will be used.
After the initial startup you will be able to access the instance via https://localhost:8443 and using admin as username and nextcloud as password.
After you are done testing, you can simply stop the container by pressing [CTRL] + [c] and delete the container by running:
docker stop nextcloud-easy-test
docker rm nextcloud-easy-test
If you want to run this in a VM, you need to change the port in the initial command from -p 127.0.0.1:8443:443 to -p 8443:443 and add the following flag: -e TRUSTED_DOMAIN=ip.of.the.VM in order to automatically make it work.
Additionally, the container currently reacts on the following apps variables and installs and compiles those automatically if provided:
ACTIVITY_BRANCH
APPROVAL_BRANCH
BOOKMARKS_BRANCH
CALENDAR_BRANCH
CIRCLES_BRANCH
CONTACTS_BRANCH
DECK_BRANCH
DOWNLOADLIMIT_BRANCH
E2EE_BRANCH
FIRSTRUNWIZARD_BRANCH
FORMS_BRANCH
GROUPFOLDERS_BRANCH
GUESTS_BRANCH
IMPERSONATE_BRANCH
INTEGRATIONGITHUB_BRANCH
ISSUTEMPLATE_BRANCH
LOGREADER_BRANCH
MAIL_BRANCH
MAPS_BRANCH
NEWS_BRANCH
NOTES_BRANCH
NOTIFICATIONS_BRANCH
PASSWORDPOLICY_BRANCH
PDFVIEWER_BRANCH
PHOTOS_BRANCH
POLLS_BRANCH
PRIVACY_BRANCH
RECOMMENDATIONS_BRANCH
RIGHTCLICK_BRANCH
SERVERINFO_BRANCH
TALK_BRANCH
TASKS_BRANCH
TEXT_BRANCH
VIEWER_BRANCH
ZIPPER_BRANCH
For easy copy and paste
-e ACTIVITY_BRANCH=master \
-e APPROVAL_BRANCH=master \
-e BOOKMARKS_BRANCH=master \
-e CALENDAR_BRANCH=main \
-e CIRCLES_BRANCH=master \
-e CONTACTS_BRANCH=main \
-e DECK_BRANCH=master \
-e DOWNLOADLIMIT_BRANCH=master \
-e E2EE_BRANCH=master \
-e FIRSTRUNWIZARD_BRANCH=master \
-e FORMS_BRANCH=master \
-e GROUPFOLDERS_BRANCH=master \
-e GUESTS_BRANCH=master \
-e IMPERSONATE_BRANCH=master \
-e INTEGRATIONGITHUB_BRANCH=main \
-e ISSUTEMPLATE_BRANCH=master \
-e LOGREADER_BRANCH=master \
-e MAIL_BRANCH=main \
-e MAPS_BRANCH=master \
-e NEWS_BRANCH=master \
-e NOTES_BRANCH=master \
-e NOTIFICATIONS_BRANCH=master \
-e PASSWORDPOLICY_BRANCH=master \
-e PDFVIEWER_BRANCH=master \
-e PHOTOS_BRANCH=master \
-e POLLS_BRANCH=master \
-e PRIVACY_BRANCH=master \
-e RECOMMENDATIONS_BRANCH=master \
-e RIGHTCLICK_BRANCH=master \
-e SERVERINFO_BRANCH=master \
-e TALK_BRANCH=master \
-e TASKS_BRANCH=master \
-e TEXT_BRANCH=master \
-e VIEWER_BRANCH=master \
-e ZIPPER_BRANCH=master \
If one of the above variables are set via e.g. -e CALENDAR_BRANCH=master during the initial container creation, then will the container automatically get the chosen branch from github and compile and enable the chosen apps on the instance during the startup.
MANUAL_INSTALL if the variable is set, it will skip all apps variables and only clone the given server branch and start Apache directly. You will then be able to provide your own credentials and install recommended apps.
SKELETON_ARCHIVE_URL if the variable is set it will try to download a tar.gz file from a remote server, will untar it and will try to use that as a skeletondir which will make them the default files for new users ony the test instance.
COMPILE_SERVER if the variable is set it will compile javascript files for the chosen server branch. This only works for branches starting from version 24.0.0.
NEXTCLOUDVUE_BRANCH if the variable is set it will compile javascript files for the chosen nextcloud vue branch and automatically link all chosen apps that use nextcloud vue and additionally the server if COMPILE_SERVER is set.
The docker image comes pre-bundled with all needed dependencies for a minimal instance of Nextcloud and allows to define a target branch via environmental variables that will automatically be cloned and compiled during the container startup. For a refresh, you need to recreate the container by first removing it and then running the same command again.