Skip to content

Latest commit

 

History

History
135 lines (108 loc) · 3.71 KB

installation.md

File metadata and controls

135 lines (108 loc) · 3.71 KB
Raw
head
meta
name content
description
Coolify Documentation
meta
name content
keywords
coolify self-hosting docker kubernetes vercel netlify heroku render digitalocean aws gcp azure
meta
name content
twitter:card
summary_large_image
meta
name content
twitter:site
@coolifyio
meta
name content
twitter:title
Coolify Documentation
meta
name content
twitter:description
Self-hosting with superpowers.
meta
property content
og:type
website
meta
property content
og:url
meta
property content
og:title
Coolify
meta
property content
og:description
Self-hosting with superpowers.
meta
property content
og:site_name
Coolify

Installation

Installation of Coolify is automated with a single script.

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

You can find the source code here.

The script will do the followings on your operating system:

  • Install basic commands: curl wget git jq jc
  • Docker Engine (24+)
  • Configures proper logging for Docker Engine.
  • Creates directory structure at /data/coolify for all the configuration files.
  • Creates an SSH key for Coolify to be able to manage this server from itself at /data/coolify/ssh/keys/[email protected].
  • Install dockerized Coolify.

Supported Operating Systems

  • Debian based Linux distributions (Debian, Ubuntu, etc.)
  • Redhat based Linux distributions (CentOS, Fedora, Redhat, AlmaLinux, Rocky etc.)
  • SUSE based Linux distributions (SLES, SUSE, openSUSE, etc.)
  • Raspberry Pi OS (Raspbian)

If you would like to have other, please consider open an issue on GitHub.

AMD64 and ARM architecture are supported.

:::tip We recommend Hetzner (referral link!). They have very cheap but super powerful servers, in EU and US. :::

Required CPU/Memory/Disk

Minimum required resources for Coolify:

  • 2 CPUs
  • 2 GBs memory
  • 30+ GB of storage for the images.

It could run on smaller servers as well, but not recommended.

Additional Resources

Based on what you would like to host additional resources (CPU, memory, disk) are needed.

Self-hosting could be heavy if you would like to run a lot of things.

But for example, I'm hosting most of my production stuffs on a server with:

- 8GB of memory (average usage 3.5GB)
- 4 CPUs (average usage ~20-30%)
- 150GB disk (usage 40GB)

Hosting the following things:

- 3 NodeJS apps
- 4 Static sites
- Plausible Analytics (for visitor analytics)
- Fider (feedback tool)
- UptimeKuma (uptime monitoring)
- Ghost (my newsletters)
- 3 Redis databases
- 2 PostgreSQL databases

Uninstall

You can easily uninstall Coolify by stopping the following containers, coolify,coolify-db, coolify-proxy, and coolify-redis or by executing the following script:

docker stop -t 0 coolify coolify-db coolify-proxy coolify-redis; docker rm coolify coolify-db coolify-proxy coolify-redis

You also need to cleanup all the docker volumes as well.

docker volume rm coolify-db coolify-redis

:::warning

The following command will delete EVERYTING related to your configurations, backups, etc.

:::

And delete all configurations in /data/coolify:

rm -fr /data/coolify