Skip to content

Add note about non-LTS Ubuntu versions requiring manual installation #344

@Cinzya

Description

@Cinzya

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

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    ⚠️ High PriorityCritical documentation tasks requiring immediate attention.✨ EnhancementSuggestions to improve or add detail to existing docs.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions