Robin Windey 85f293c3ee Update .devcontainer/Dockerfile | 7 місяців тому | |
---|---|---|
.. | ||
Dockerfile | 85f293c3ee Update .devcontainer/Dockerfile | 7 місяців тому |
README.md | e64fee828c docs: added codespace link | 9 місяців тому |
codespace.config.php | dfbd1fbe79 Dedicated DevContainer user + NVM | 1 рік тому |
devcontainer.json | 9dd158b70d Devcontainer: move git setup to postStartCommand | 1 рік тому |
docker-compose.yml | a32e8db703 Minor DevContainer adjustments | 1 рік тому |
entrypoint.sh | dfbd1fbe79 Dedicated DevContainer user + NVM | 1 рік тому |
launch.json | 849b7de681 Move launch.json to .devcontainer and copy on start | 1 рік тому |
postStart.sh | 9dd158b70d Devcontainer: move git setup to postStartCommand | 1 рік тому |
setup.sh | 9dd158b70d Devcontainer: move git setup to postStartCommand | 1 рік тому |
Make sure you have the VSCode DevContainer 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 F1→Dev Containers: Open Folder in Container.
Alternatively open the project directly in GitHub Codespaces.
That's already it. Everything else will be configured automatically by the Containers startup routine.
On first start the Container installs and configures Nextcloud with the following credentials:
Nextcloud Admin Login
Username: admin
Password: admin
Postgres credentials
Username: postgres
Password: postgres
Database: postgres
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 to get access to the NC database |
The container runs with the user devcontainer
who is also running the Apache2 process. All mounted source files have
proper permissions so that this user can access everything which is inside the current workspace. If you need to
get root permissions for whatever reason, use sudo su
or sudo <command>
(for example sudo service apache2 restart
).
Everything else (like building the application, adjusting files, ...) should be done as devcontainer
user.
The container comes with nvm
and Node 16 installed. This should be sufficient to
build Nextcloud Core sources via make
. If you need a different Node Version (for example for
app development), you can easily switch between different versions by running:
# Install and use Node 14
nvm install 14
nvm use 14
# Check version
node -v
# Switch back to Node 16
nvm use 16
# Check version
node -v
Note that nvm
is only installed for the user devcontainer
and won't work out of the box for
any other user.
The Apache webserver is already configured to automatically try to connect to a debugger process
listening on port 9003
. To start the VSCode debugger process, use the delivered debug profile Listen for XDebug
.
After you started the VSCode debugger, just navigate to the appropriate Nextcloud URL to get your
debug hits.