aboutsummaryrefslogtreecommitdiffstats
path: root/.devcontainer/README.md
diff options
context:
space:
mode:
authorRobin Windey <ro.windey@gmail.com>2023-03-27 07:05:27 +0000
committerGitHub <noreply@github.com>2023-03-31 13:53:04 +0000
commita32e8db7031bbb3e183afdf8cabc9b16910dec86 (patch)
treeb1c83168bd14c2ffc86035cc5d98b7b13c63fe45 /.devcontainer/README.md
parent79fb336d35953a1bad648e256c5f57eee2809041 (diff)
downloadnextcloud-server-a32e8db7031bbb3e183afdf8cabc9b16910dec86.tar.gz
nextcloud-server-a32e8db7031bbb3e183afdf8cabc9b16910dec86.zip
Minor DevContainer adjustments
* Add gnupg2 to be able to sign commits * Make sure /var/www/html always belongs to www-data * Add Git-History plugin * Introduce dedicated entrypoint script * Store Postgres database data in volume to be persistent * Cleaner check if NC is already installed in setup.sh * Add composer to DevContainer Signed-off-by: GitHub <noreply@github.com>
Diffstat (limited to '.devcontainer/README.md')
-rw-r--r--.devcontainer/README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/.devcontainer/README.md b/.devcontainer/README.md
new file mode 100644
index 00000000000..b1c8ed6d340
--- /dev/null
+++ b/.devcontainer/README.md
@@ -0,0 +1,35 @@
+# Nextcloud DevContainer
+
+## Usage
+
+Make sure you have the [VSCode DevContainer](https://code.visualstudio.com/docs/devcontainers/containers) extensions installed. If you open the project, VSCode will ask you if you want to open it inside of the DevContainer. If that's not the case, use <kbd>F1</kbd>&rarr;*Dev Containers: Open Folder in Container*.
+
+Alternatively open the project directly in [GitHub Codespaces](https://github.com/features/codespaces).
+
+That's already it. Everything else will be configured automatically by the Containers startup routine.
+
+## Credentials
+
+On first start the Container installs and configures Nextcloud with the following credentials:
+
+**Nextcloud Admin Login**
+
+Username: `admin` <br>
+Password: `admin`
+
+**Postgres credentials**
+
+Username: `postgres` <br>
+Password: `postgres` <br>
+Database: `postgres`
+
+## Services
+
+The following services will be started:
+
+| Service | Local port | Description |
+|---------|------------|-------------|
+| Nextcloud (served via Apache) | `80` | The main application |
+| Mailhog | `8025` | SMTP email delivery for testing |
+| Adminer | `8080` | Database viewer. Use credentials from above and connect to `localhost:5432` to get access to the NC database |
+