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 \
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 ^
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.
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
ISSUTEMPLATE_BRANCH
IMPERSONATE_BRANCH
LOGREADER_BRANCH
MAIL_BRANCH
MAPS_BRANCH
NEWS_BRANCH
NOTES_BRANCH
NOTIFICATIONS_BRANCH
PDFVIEWER_BRANCH
PHOTOS_BRANCH
POLLS_BRANCH
RECOMMENDATIONS_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 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 PDFVIEWER_BRANCH=master \
-e PHOTOS_BRANCH=master \
-e POLLS_BRANCH=master \
-e RECOMMENDATIONS_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.
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.