PQC-Nextcloud-Docker

This repository initializes development instance of PQC-ed Nextcloud server using Docker.

Installation steps

1. Install Docker and Docker Compose
2. Clone this repository
3. Run git submodule update --init --remote --recursive to download sub-repositories
4. WATCH OUT, key.pem and cert.pem are pre-generated RSA2048 keys to enable https on localhost - DO NOT USE THEM IN PRODUCTION
   • to generate your own, run openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout key.pem -out cert.pem
5. Run docker-compose up -d to start the server
6. Access the server at https://localhost:8443

Development

• changes in nextcloud_apps/twofactor_webeid are automatically reflected in the running Nextcloud instance

XDebug installation (for step-by-step PHP debugging)

1. In Dockerfile, make sure the DEBUG commands are enabled
2. in VSCode, attach to the container using Remote Explorer or Docker extension
3. in the attached container, install PHP XDebug extension
4. add PHP debug configuration (XDebug should install 3 configurations automatically)
5. run the configuration Listen for XDebug to start listening for XDebug connections (might require container restart to work)
6. set some breakpoints in the code and the debugger should stop at them when the webpage is accessed at https://localhost:8443

References

• allowing HTTPS: https://help.nextcloud.com/t/howto-running-nextcloud-over-self-signed-https-ssl-tls-in-docker/101973