Skip to content

Commit afc6bb8

Browse files
committed
Merge branch 'next' into v4.x
2 parents f08f35c + 7bff973 commit afc6bb8

File tree

5 files changed

+676
-5
lines changed

5 files changed

+676
-5
lines changed

docs/.vitepress/config.mts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -468,6 +468,7 @@ export default defineConfig({
468468
text: 'Installation',
469469
collapsed: true,
470470
items: [
471+
{ text: 'Coolify Installation Failed', link: '/troubleshoot/installation/install-script-failed' },
471472
{ text: 'Docker Installation Failed', link: '/troubleshoot/installation/docker-install-failed' },
472473
]
473474
},

docs/get-started/installation.md

Lines changed: 68 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -162,14 +162,78 @@ If you're not logged in as the root user, run the script with sudo:
162162
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | sudo bash
163163
```
164164

165-
You can also set up the first admin account directly during the installation. For details, see: [Create Root User with Environment Variables](/knowledge-base/create-root-user-with-env)
166165
:::
167166

168-
There are several environment variables that you can set to customize your Coolify installation.
167+
#### Advanced: Customizing Installation with Environment Variables
169168

170-
For example, you can setup a default root user or define the default docker network pool.
169+
The installation script supports several environment variables to customize your Coolify installation. These are completely optional.
171170

172-
See the [Define Custom Docker Network with ENV](/knowledge-base/define-custom-docker-network-with-env) or the [Create Root User with ENV](/knowledge-base/create-root-user-with-env) for more details.
171+
:::details Click to view all available environment variables
172+
173+
You can set these environment variables before running the installation script to customize your Coolify setup:
174+
175+
| Environment Variable | Description | Default Value | Example |
176+
| ---------------------------- | ----------------------------------------------------- | ------------- | -------------------- |
177+
| `ROOT_USERNAME` | Predefined root username for first admin account | - | `admin` |
178+
| `ROOT_USER_EMAIL` | Predefined root user email for first admin account | - | `admin@example.com` |
179+
| `ROOT_USER_PASSWORD` | Predefined root user password for first admin account | - | `SecurePassword123!` |
180+
| `DOCKER_ADDRESS_POOL_BASE` | Custom Docker address pool base (CIDR notation) | `10.0.0.0/8` | `172.16.0.0/12` |
181+
| `DOCKER_ADDRESS_POOL_SIZE` | Custom Docker address pool size (must be 16-28) | `24` | `20` |
182+
| `DOCKER_POOL_FORCE_OVERRIDE` | Force override existing Docker pool configuration | `false` | `true` |
183+
| `AUTOUPDATE` | Enable/disable automatic Coolify updates | `true` | `false` |
184+
| `REGISTRY_URL` | Custom Docker registry URL for Coolify images | `ghcr.io` | `your-registry.com` |
185+
186+
**Usage Examples:**
187+
188+
**1. Create Admin Account During Installation:**
189+
190+
```bash
191+
env ROOT_USERNAME=admin \
192+
ROOT_USER_EMAIL=admin@example.com \
193+
ROOT_USER_PASSWORD=SecurePassword123 \
194+
bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
195+
```
196+
197+
See the [Create Root User with Environment Variables](/knowledge-base/create-root-user-with-env) guide for more details.
198+
199+
**2. Custom Docker Network Pool:**
200+
201+
```bash
202+
env DOCKER_ADDRESS_POOL_BASE=172.16.0.0/12 \
203+
DOCKER_ADDRESS_POOL_SIZE=20 \
204+
bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
205+
```
206+
207+
See the [Define Custom Docker Network with ENV](/knowledge-base/define-custom-docker-network-with-env) guide for more details.
208+
209+
**3. Disable Auto-Updates:**
210+
211+
```bash
212+
env AUTOUPDATE=false \
213+
bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
214+
```
215+
216+
**4. Use Custom Docker Registry:**
217+
218+
```bash
219+
env REGISTRY_URL=your-registry.com \
220+
bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
221+
```
222+
223+
When using a custom registry, make sure all required Coolify images are available in your registry.
224+
225+
**5. Combine Multiple Variables:**
226+
227+
```bash
228+
env ROOT_USERNAME=admin \
229+
ROOT_USER_EMAIL=admin@example.com \
230+
ROOT_USER_PASSWORD=SecurePassword123 \
231+
AUTOUPDATE=false \
232+
DOCKER_ADDRESS_POOL_BASE=172.16.0.0/12 \
233+
bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
234+
```
235+
236+
:::
173237

174238
#### 3. Access Coolify
175239

docs/services/calcom.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,30 @@ description: "Host Cal.com scheduling platform on Coolify with calendar integrat
1111

1212
Scheduling infrastructure for everyone.
1313

14+
## Deploying on x86 (amd64)
15+
16+
You need to change default docker compose to the following to make cal.com work on x86 (amd64):
17+
18+
```yaml
19+
services:
20+
calcom:
21+
image: 'calcom/cal.com:<VERSON compatible with amd64>
22+
platform: linux/amd64
23+
(... same ...)
24+
```
25+
26+
You can check the latest amd64 compatible version [here](https://hub.docker.com/r/calcom/cal.com/tags).
27+
28+
Example:
29+
30+
```yaml
31+
services:
32+
calcom:
33+
image: 'calcom/cal.com:v5.9.0
34+
platform: linux/amd64
35+
(... same ...)
36+
```
37+
1438
## Links
1539

1640
- [Official Documentation](https://cal.com/docs/developing/introduction?utm_source=coolify.io)

docs/troubleshoot/dns-and-domains/lets-encrypt-not-working.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Sometimes, Let's Encrypt might be having issues on their end. Check the Let's En
3737

3838
## 5. Note on Certificate Validity
3939

40-
Let's Encrypt certificates are valid for 90 days. If your certificate is still valid, your domain mayo work fine even if requied port 80 is closed or your domain is being proxied. This is because Coolify will continue using the existing valid certificate until it expires.
40+
Let's Encrypt certificates are valid for 90 days. If your certificate is still valid, your domain may work fine even if requied port 80 is closed or your domain is being proxied. This is because Coolify will continue using the existing valid certificate until it expires.
4141

4242
However, if your domain has been working fine over HTTPS for several months and suddenly fails to generate a new SSL certificate, it’s likely that the existing certificate has expired. At this point, Coolify won’t be able to generate a new certificate due to the issues mentioned earlier (like port 80 being closed or proxy interference).
4343

0 commit comments

Comments
 (0)