Skip to content

VPS - fix Nextcloud connectivity, pull errors, and persistence#9343

Open
afiand wants to merge 2 commits into
ovh:developfrom
afiand:patch-1
Open

VPS - fix Nextcloud connectivity, pull errors, and persistence#9343
afiand wants to merge 2 commits into
ovh:developfrom
afiand:patch-1

Conversation

@afiand
Copy link
Copy Markdown

@afiand afiand commented Apr 29, 2026

What type of Pull Request is this?

  • Update of existing guide

Description

1. Networking & DNS Resolution

  • Fix: Introduced a dedicated internal network for the db, redis, and app services.
  • Reasons: Resolved the error: php_network_getaddresses: getaddrinfo for db failed. Relying solely on the external proxy network caused Docker's internal service discovery to fail. A private bridge network ensures reliable communication between the application and its dependencies.

2. Image Pull & Registry Compliance

  • Fix: Standardized the Redis image name to lowercase (redis:7-alpine).
  • Reasons: Corrected the error: invalid reference format: repository name must be lowercase. Docker registry protocols require lowercase repository names; the previous uppercase "Redis" caused pull failures on standard Docker engines.

3. Data Persistence & Integrity

  • Fix: Corrected the MariaDB volume path to /var/lib/mysql and added a persistent volume for the Nextcloud /config directory.
  • Reasons:
    • MariaDB: Linux filesystems are case-sensitive.
    • Config: Without a volume for /var/www/html/config, users lose their config.php (and thus their entire setup) whenever the container is updated or recreated.

4. Traefik Routing Optimization

  • Fix: Added the traefik.docker.network=proxy label to the app service.
  • Reasons: Since the app container is now attached to two networks (internal and proxy), this label is required to explicitly tell Traefik which network to use for routing public web traffic, preventing potential 502 Gateway Errors.

Mandatory information

The translations in this Pull Request have been done using:

  • This Pull Request didn't require any translation.

  • This Pull Request can be merged as soon as possible.

…rsistence

- Fix "getaddrinfo for db failed" by adding an internal network.
- Fix Redis pull failure by correcting image name to lowercase.
- Correcting volume path case for MariaDB.
- Add 'config' volume to persist settings across restarts.
- Add 'traefik.docker.network' label for multi-network routing.
@Y0Coss Y0Coss added the Offer: Bare Metal The PR documents Bare Metal products: Dedicated Servers, VPS label Apr 30, 2026
@Y0Coss Y0Coss changed the title Update guide.en-gb.md: docs: fix Nextcloud connectivity, pull errors, and persistence VPS - fix Nextcloud connectivity, pull errors, and persistence Apr 30, 2026
@Y0Coss Y0Coss added Pending Peer Review A peer review has been requested on the guide Test required The OVHcloud team will have to test this new content before considering a merge. and removed Pending Peer Review A peer review has been requested on the guide labels May 4, 2026
Copy link
Copy Markdown
Contributor

@Stephane-Bautista Stephane-Bautista left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree with that review

Apply the same networking, persistence and Traefik routing fixes from
the EN guide to the French version: add internal network for db/redis/app,
add persistent config volume, declare traefik.docker.network label.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Offer: Bare Metal The PR documents Bare Metal products: Dedicated Servers, VPS Test required The OVHcloud team will have to test this new content before considering a merge.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants