-
-
Notifications
You must be signed in to change notification settings - Fork 173
Description
Summary
Add a clear note in the installation documentation that non-LTS Ubuntu versions (e.g., 24.10) require manual installation as the automatic installation script only supports LTS versions.
Context
Users on non-LTS Ubuntu versions frequently encounter issues with the automatic installation script. While Coolify fully supports these versions, they need to use the manual installation method instead of the automated script.
Required Documentation Updates
1. Update Automatic Installation Section
In /docs/get-started/installation.md
, add a note in or near the "Quick Installation" section:
Location: After line 25 (after the quick installation command box)
Suggested addition:
::: info Ubuntu Users
The automatic installation script only works with Ubuntu LTS versions (20.04, 22.04, 24.04).
If you're using a non-LTS version (e.g., 24.10), please use the [Manual Installation](#manual-installation) method below.
:::
2. Update Supported Operating Systems Section
In the "Supported Operating Systems" section (around line 47-60), clarify Ubuntu version support:
Current text:
- Debian-based (e.g., Debian, Ubuntu)
Suggested update:
- Debian-based (e.g., Debian, Ubuntu - all versions supported, but non-LTS Ubuntu requires manual installation)
3. Consider Adding to Manual Installation Section
Add a note at the beginning of the Manual Installation section (line 178) mentioning this is the required method for non-LTS Ubuntu users:
Suggested addition:
::: tip
This manual installation method is required for:
- Non-LTS Ubuntu versions (e.g., 24.10)
- Users who prefer more control over the installation process
- Systems where the automatic script encounters issues
:::
Benefits
- Reduces confusion for users on non-LTS Ubuntu versions
- Prevents repeated support questions in Discord
- Clearly communicates that non-LTS versions ARE supported, just through a different installation method
- Directs users to the appropriate installation method based on their OS version
References
- Discord discussion: https://discord.com/channels/459365938081431553/1379465883784843264
- Manual installation already documented at:
/docs/get-started/installation.md#manual-installation
🤖 Generated with Claude Code