Skip to content

Commit 8429527

Browse files
Merge pull request #200 from alnutile/patch-2
Adding some feedback from a chat here to help with docs
2 parents d1d2fa4 + ad75334 commit 8429527

File tree

1 file changed

+22
-39
lines changed

1 file changed

+22
-39
lines changed

docs/knowledge-base/server/introduction.md

Lines changed: 22 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -2,97 +2,80 @@
22
title: "Introduction"
33
description: "A guide to help you understand what kind of servers you can connect to Coolify."
44
---
5-
65
# Introduction
7-
86
No matter what type of server you have (localhost or remote), you need the following requirements.
9-
107
- Connectivity
11-
128
- SSH connectivity between Coolify and the server with SSH key authentication.
139
::: success Tip
1410
Your public key should be added to **root** user's `~/.ssh/authorized_keys`.
15-
If you do not have an SSH Key, you can generate on through Coolify with a simple button or you can generate one manually.
11+
If you do not have an SSH Key, you can generate one through Coolify with a simple button or you can generate one manually.
1612
:::
17-
18-
1913
- Docker Engine (24+)
20-
2114
## Types
22-
2315
- **Localhost**: the server where Coolify is installed.
2416
- **Remote Server**: could be any remote linux server.
25-
2617
## Localhost
27-
2818
To be able to manage the server where Coolify is running on, the docker container of Coolify should reach the host server through SSH.
29-
3019
You can use localhost as a server where all your resources are running, but it is not recommended as high server usage could prevent to use Coolify.
31-
3220
::: success Tip
3321
You can use our [Cloud](https://app.coolify.io) version, so you only need a server for your resources.
3422

3523
You will get a few other things included with the cloud version, like free email notifications, s3 storage, etc based on your subscription plan.
3624
:::
37-
3825
## Remote Server
39-
4026
You can connect any type of servers to Coolify. It could be a VPS, a Raspberry PI or a laptop running Linux.
41-
4227
::: success Tip
4328
If you don't have a server or server provider yet, we prefer to use Hetzner.
44-
4529
You can use our [referral link](https://coolify.io/hetzner). It will help us to keep the project alive.
46-
4730
:::
48-
4931
### Cloudflare Tunnels
50-
5132
You can also set to use Cloudflare Tunnels for your servers.
52-
5333
::: success Tip
5434
Coolify does not install cloudflared on your server, it needs to be done prior.
55-
5635
All it does is to add the right ProxyCommand (`ProxyCommand <ip / hostname> access ssh --hostname %h`) to all ssh connections.
57-
5836
:::
5937

60-
## Features
38+
## Multiple Server Configuration
39+
When setting up multiple servers in Coolify, it's important to understand how traffic routing works:
6140

62-
### Disk Cleanup threshold
41+
- **Independent Proxy Handling**: Each server runs its own proxy that handles incoming requests for applications deployed on that server.
42+
- **Direct Traffic Flow**: Traffic for applications deployed on secondary servers goes directly to those servers, not through the main Coolify server.
43+
- **DNS Configuration**: You must point your domain DNS to the IP address of the server where the application is deployed, not to the main Coolify server.
6344

64-
You can read more about Automated Cleanup and the disk cleanup threshold in the [Automated Cleanup](/knowledge-base/server/automated-cleanup) section.
45+
### Role of the Main Server
46+
The main Coolify server:
47+
- Provides the management UI to control applications on all connected servers
48+
- Performs SSH connections to secondary servers for deployment and management
49+
- Conducts health checks and monitoring
50+
- Does NOT route or proxy traffic to applications on secondary servers
6551

66-
### Wildcard Domain
52+
This architecture reduces latency and improves application performance by eliminating additional network hops.
6753

54+
## Features
55+
### Disk Cleanup threshold
56+
You can read more about Automated Cleanup and the disk cleanup threshold in the [Automated Cleanup](/knowledge-base/server/automated-cleanup) section.
57+
### Wildcard Domain
6858
You can set a wildcard domain (`example: http://example.com`) to your server, so you can easily assign generated domains to all the resources connected to this server.
69-
7059
Example: Your application UUID is `vgsco4o`.
71-
7260
If you have the example set, you will get the following FQDN: `http://vgsco4o.example.com`
73-
7461
If you do not have any wildcard domain set, Coolify will generate a [sslip.io](https://sslip.io) domain, which is free & magical domain that you can use anywhere.
75-
7662
In this case, it will be: `http://vgsco4o.127.0.0.1.sslip.io`, where `127.0.0.1` is your server's IP.
7763

78-
## Proxy
64+
::: success Tip
65+
When using multiple servers, remember that each application's domain must point to the specific server where that application is deployed.
66+
:::
7967

68+
## Proxy
8069
- **Traefik**: Automatically configure Traefik(v2) based on your deployed resources.
8170
- **Custom/None**: You will configure a proxy manually (only for advanced users).
82-
8371
::: success Tip
8472
Soon we will support Nginx & Caddy with fully automated configuration.
8573
:::
86-
8774
### Traefik
88-
8975
Coolify uses Traefik proxy by default to create a reverse proxy for your resources.
90-
9176
::: success Tip
9277
Traefik only starts when you did not select any proxy for your server and you
9378
have a domain configured for a resource or your Coolify instance itself.
9479
:::
95-
9680
#### Dynamic Configuration
97-
98-
You can always add your own configuration to the proxy settings from Coolify's UI (`/server/<server_uuid>/proxy`).
81+
You can always add your own configuration to the proxy settings from Coolify's UI (`/server/<server_uuid>/proxy`).

0 commit comments

Comments
 (0)