feat(knowledge-base): add documentation for custom docker registry

Author: andrasbacsai

docs/.vitepress/config.mts

@@ -318,8 +318,9 @@ export default defineConfig({
                   { text: 'Commands', link: '/knowledge-base/commands' },
                   { text: 'Delete User', link: '/knowledge-base/delete-user' },
                   { text: 'OAuth', link: '/knowledge-base/oauth' },
-                  { text: 'Create Root User using ENV', link: '/knowledge-base/create-root-user-with-env' },
-                  { text: 'Define Custom Docker Network with ENV', link: '/knowledge-base/define-custom-docker-network-with-env' },
+                  { text: 'Default Root User', link: '/knowledge-base/create-root-user-with-env' },
+                  { text: 'Custom Docker Network', link: '/knowledge-base/define-custom-docker-network-with-env' },
+                  { text: 'Custom Docker Registry', link: '/knowledge-base/custom-docker-registry' },
                   { text: 'Change Localhost Key', link: '/knowledge-base/change-localhost-key' },
                 ]
               },

docs/knowledge-base/custom-docker-registry.md

@@ -0,0 +1,60 @@
+---
+title: "Custom Docker Registry"
+description: "How to define a custom docker registry"
+---
+
+# Custom Docker Registry
+
+If you would like to get Coolify's images from `dockerhub` instead of the default `ghcr.io`, you can do it by setting the `REGISTRY_URL` environment variable to `docker.io`.
+
+## Registry URL (`REGISTRY_URL`)
+- Valid values: `docker.io` & `ghcr.io`.
+
+## Automated Installation Method
+
+1. **Run Installation Command**
+
+   Execute the automated installation script with your prepared credentials:
+
+   ```bash
+   env REGISTRY_URL=docker.io bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
+   ```
+    > View the [Scripts Source Code](https://github.com/coollabsio/coolify/blob/main/scripts/install.sh)
+
+::: info
+  The installation script must be run as `root`. If you're not logged in as `root`, the script will use `sudo` to elevate privileges.
+  ```bash
+  sudo -E env REGISTRY_URL=docker.io bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
+  ```
+:::
+
+
+## Manual Installation Method
+
+
+1. **Configure Environment Variables**
+
+   Edit the environment variables file:
+
+   ```bash
+   nano /data/coolify/source/.env
+   ```
+
+   Add the following variables with your prepared credentials:
+   ```bash
+   REGISTRY_URL=docker.io
+   ```
+
+## Switch after installation
+
+If you want to switch the registry after installation, you can do it by running the following command:
+
+```bash
+env REGISTRY_URL=docker.io bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
+```
+
+::: info
+  The installation script must be run as `root`. If you're not logged in as `root`, the script will use `sudo` to elevate privileges.
+  ```bash
+  sudo -E env REGISTRY_URL=docker.io bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
+  ```