Free SSL certificates<\/h3>\n\n\n\n
Coolify also automates the setup of SSL certificates for custom domains to simplify operations and prevent manual certificate setup.<\/p>\n\n\n\n
Setting up a Developer Cloud Server<\/h2>\n\n\n\n
To run Coolify on UpCloud, you must first set up a Cloud Server. We have an in-depth, step-by-step guide on how to deploy Cloud Servers,<\/a> but here\u2019s a quick summary.<\/p>\n\n\n\n When you have finished configuring your Developer Cloud Server, click the Deploy button to launch the new server instance.<\/p>\n\n\n\n Before installing Coolify, you will need to prepare your Cloud Server. Coolify doesn\u2019t have many prerequisites but automatically installs the necessary tools and software when using their quick installation method. However, before starting, follow the steps below to ensure your server is ready.<\/p>\n\n\n\n Once your Developer Cloud Server is up and running, log in using SSH or our VLC connection<\/a>.<\/p>\n\n\n\n You must also allow TCP port 80 or 443 if you wish to use GitHub webhooks.<\/p>\n\n\n\n With these checks done, you can now move to installing Coolify.<\/p>\n\n\n\n The next step is installing and configuring Coolify.<\/p>\n\n\n\n Using the install script:<\/strong> <\/em><\/strong>Install Coolify automatically using their installation script is quick and easy. Simply run the following command on your Cloud Server\u2019s terminal.<\/p>\n\n\n\n When the installation finishes successfully, you should see an output like below.<\/p>\n\n\n\n If the script finishes without showing you the above output, run it again to continue the installation from where it might have left off.<\/p>\n\n\n\n Coolify recommends using the automated script for easier installation. However, if you wish to install Coolify manually, follow the steps below.<\/p>\n\n\n\n Once installed, Coolify starts a web server that will provide you with a dashboard. Here is how you can deploy your first app using Coolify:<\/p>\n\n\n\n 1. Access your Coolify dashboard<\/strong>: Open the Coolify dashboard in your web browser by going to the address at the end of the installation output, http:\/\/{your-server-ip-address}:8000<\/strong> port on your Cloud Server.<\/p>\n\n\n\n The first time opening the Coolify dashboard, you will be presented with an account creation page. Register to your Coolify dashboard to secure your installation.<\/p>\n\n\n\n Once registered, you will be guided through the initial setup process. Press the Get Started button to begin.<\/p>\n\n\n\n You will then get a short introduction to Coolify. Simply click the Next button to proceed.<\/p>\n\n\n\n 2. Set up your Coolify installation<\/strong>: To set up your project on Coolify, you must first tell Coolify how and where to install your projects. In this example, we are using the same Cloud Server to run our test applications as Coolify itself by choosing the Localhost option.<\/p>\n\n\n\n Next, create your first project.<\/p>\n\n\n\n Then choose the resources by clicking the Let\u2019s do it button.<\/p>\n\n\n\n 3. Deploying your first Project<\/strong>: The Projects menu contains a long list of applications, databases, and services you can deploy.<\/p>\n\n\n\n For this example, we will choose the empty Docker Compose container. Click on the icon to open the configuration view.<\/p>\n\n\n\n Next, input the Docker Compose configuration you want to deploy. In this example, we\u2019ve picked a simple Docker test image.<\/p>\n\n\n\n Copy the following Docker compose configurations into your Coolify project.<\/p>\n\n\n\n Then click the Save button and return to the project configuration view.<\/p>\n\n\n\n Next, click the Deploy button.<\/p>\n\n\n\n Then sit back and watch the magic happen!<\/p>\n\n\n\n Once your Docker containers’ status shows “Started,” you can verify it by opening your Coolify server IP address at the port selected in the compose file.<\/p>\n\n\n\n Congratulations! If everything goes correctly, you should see the celebration screen.<\/p>\n\n\n\n Setting up Coolify and deploying your first application is an important part of this tutorial. However, you should also know how to manage and maintain your UpCloud server to ensure optimal performance.<\/p>\n\n\n\n Routine maintenance should include the following:<\/p>\n\n\n\n The security of your server is also important to ensure it performs per your expectations.<\/p>\n\n\n\n Coolify installation offers a simple but powerful solution for deploying and managing applications. This makes it easy for developers and small teams to collaborate and get their work done efficiently and quickly. <\/p>\n\n\n\n Coolify lets users deploy their apps with just a few clicks by seamlessly integrating with GitHub, GitLab, and Docker. Coolify, paired with the UpCloud Developer plan Cloud Servers, provides a great developer environment for building, scaling, and managing applications.<\/p>\n\n\n\n\n
<\/li>\n\n\n\n
<\/li>\n\n\n\n
<\/li>\n\n\n\n
<\/li>\n\n\n\n
<\/li>\n\n\n\n
<\/li>\n\n\n\nPreparing your Cloud Server<\/h2>\n\n\n\n
\n
sudo apt updatesudo apt upgrade -y<\/pre>\n\n\n\n
\n
sudo apt install curl<\/pre>\n\n\n\n
\n
\n
Recommended: Installing Coolify automatically<\/h2>\n\n\n\n
curl -fsSL https:\/\/cdn.coollabs.io\/coolify\/install.sh | sudo bash<\/pre>\n\n\n\n
- Coolify installed successfully.
- Waiting for 20 seconds for Coolify (database migrations) to be ready.
- Until then, here's a joke for you:
There are only 10 kinds of people in this world: those who know binary and those who don't.
____ _ _ _ _ _
\/ ___|___ _ __ __ _ _ __ __ _| |_ _ _| | __ _| |_(_) ___ _ __ ___| |
| | \/ _ \\| '_ \\ \/ _` | '__\/ _` | __| | | | |\/ _` | __| |\/ _ \\| '_ \\\/ __| |
| |__| (_) | | | | (_| | | | (_| | |_| |_| | | (_| | |_| | (_) | | | \\__ \\_|
\\____\\___\/|_| |_|\\__, |_| \\__,_|\\__|\\__,_|_|\\__,_|\\__|_|\\___\/|_| |_|___(_)
|___\/
Your instance is ready to use.
Please visit http:\/\/{your-server-ip-address}:8000 to get started.<\/pre>\n\n\n\nAlternative: Manually installing Coolify<\/h2>\n\n\n\n
\n
mkdir -p \/data\/coolify\/{source,ssh,applications,databases,backups,services,proxy,webhooks-during-maintenance}
mkdir -p \/data\/coolify\/ssh\/{keys,mux}
mkdir -p \/data\/coolify\/proxy\/dynamic<\/pre>\n\n\n\n\n
ssh-keygen -f \/data\/coolify\/ssh\/keys\/id.root@host.docker.internal -t ed25519 -N '' -C root@coolify<\/pre>\n\n\n\n
\n
cat \/data\/coolify\/ssh\/keys\/id.root@host.docker.internal.pub >>~\/.ssh\/authorized_keys
chmod 600 ~\/.ssh\/authorized_keys<\/pre>\n\n\n\n\n
curl -fsSL https:\/\/cdn.coollabs.io\/coolify\/docker-compose.yml -o \/data\/coolify\/source\/docker-compose.yml
curl -fsSL https:\/\/cdn.coollabs.io\/coolify\/docker-compose.prod.yml -o \/data\/coolify\/source\/docker-compose.prod.yml
curl -fsSL https:\/\/cdn.coollabs.io\/coolify\/.env.production -o \/data\/coolify\/source\/.env
curl -fsSL https:\/\/cdn.coollabs.io\/coolify\/upgrade.sh -o \/data\/coolify\/source\/upgrade.sh<\/pre>\n\n\n\n\n
chown -R 9999:root \/data\/coolify
chmod -R 700 \/data\/coolify<\/pre>\n\n\n\n\n
sed -i \"s|APP_ID=.*|APP_ID=$(openssl rand -hex 16)|g\" \/data\/coolify\/source\/.env
sed -i \"s|APP_KEY=.*|APP_KEY=base64:$(openssl rand -base64 32)|g\" \/data\/coolify\/source\/.env
sed -i \"s|DB_PASSWORD=.*|DB_PASSWORD=$(openssl rand -base64 32)|g\" \/data\/coolify\/source\/.env
sed -i \"s|REDIS_PASSWORD=.*|REDIS_PASSWORD=$(openssl rand -base64 32)|g\" \/data\/coolify\/source\/.env
sed -i \"s|PUSHER_APP_ID=.*|PUSHER_APP_ID=$(openssl rand -hex 32)|g\" \/data\/coolify\/source\/.env
sed -i \"s|PUSHER_APP_KEY=.*|PUSHER_APP_KEY=$(openssl rand -hex 32)|g\" \/data\/coolify\/source\/.env
sed -i \"s|PUSHER_APP_SECRET=.*|PUSHER_APP_SECRET=$(openssl rand -hex 32)|g\" \/data\/coolify\/source\/.env<\/pre>\n\n\n\n\n
# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d \/etc\/apt\/keyrings
sudo curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg -o \/etc\/apt\/keyrings\/docker.asc
sudo chmod a+r \/etc\/apt\/keyrings\/docker.asc
# Add the repository to Apt sources:
echo \\
\"deb [arch=$(dpkg --print-architecture) signed-by=\/etc\/apt\/keyrings\/docker.asc] https:\/\/download.docker.com\/linux\/ubuntu \\
$(. \/etc\/os-release && echo \"$VERSION_CODENAME\") stable\" | \\
sudo tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null
sudo apt-get update<\/pre>\n\n\n\nsudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin<\/pre>\n\n\n\n
\n
docker network create --attachable coolify<\/pre>\n\n\n\n
\n
docker compose --env-file \/data\/coolify\/source\/.env -f \/data\/coolify\/source\/docker-compose.yml -f \/data\/coolify\/source\/docker-compose.prod.yml up -d --pull always --remove-orphans --force-recreate<\/pre>\n\n\n\n
Deploying your first app using Coolify<\/h2>\n\n\n\n
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXdJrkLB4bbQp-fgDH4J0yKOGrxIBP5doF94bEm5VKXDzD2rD8UuZVfUSJZgtxefCqg23eFmDUeAZm-JAGi3xotxhBMxmAwn01JHZvixHw_ERku0Qb8D-xUikve_yBjzkG96rni5?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXcyX5kar2oK9TRevqFVroVC4gMdsP4N-JMPbqKsGD_4JMwBp6z-iKMKUrIHUv6WpxoWXjlugqLZKoVuyfLi6IuXqpHuNCbHTg4ZusqQboomweQGA9TJ4tLgwx8yztlljrPLzu-tjg?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXfjWwOL9zTIH8fVZn3bWENU_1PnAUMRJL6t9o53zalFn0Xqycm8M7DrBaap5VQLSyKVlDMqlXF3H2pLCdE9NkLk4adFQjUEC9YqM9WtHa7kgmN_1UR0h15cc_Psbfb1rlXjezPlzg?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXdGu7ZgM8wf-WiIs6C1u573WNr6AxVl3Iqo1gabjQQ9LWfXNHBGKyOzeG2uQkGVVCN6AhlytHquQ2TuMmys0XYZRoe6LXmcfBaG9BUayc2g21x5kmTV1JIcjtlDiCg9gK-k5wlK?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXcBAd5F2RCIXS7cspCXX_IpJJoo3cF3Larhmj0KXzamZOMiKw7ZfGx2XaIPY13WZG1ljV30aHMJhNd8EeIrMtb7cl77LbwkGj2VuYTMjDKhcBL80DrgWAEYvlkc8U-_EZ2rep2jGw?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXegZTmxCQnK4t1vsL3npZ95HWP3pwaYA9N5bZOrZgrnlDQlBAWpLW8teVYkjlQSOi2GC_QNKFmml0Abwq5bZ05YDqj9okarHY2ve9oFqRnVBq_wCbbH7UrFZHXzPDB7wTykt5C4oQ?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXdCz2Zly8j8JMwPtF5sQ_Ew72TPv-0MTP9mVAp7oR_i1rxAyubw7NkiEgL5kGTC3jElMhX4ebr9IylKQ50Aqf_2gTF9EkicWP8hQz-cPz4m_BGpBDyS958R_p_vcfm8aRY17y9yMw?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXfMN7-TobjLetJ0gFBHjibhcaKQKV1qh3VdJurPoQBP0NN1sQ_hcLkRjpMcEkzeoXXUHa6mn0BRW-KKL5auZuM037CSn9GouGQ2lVtnTFwdp5Cl3-3tPeS-enunUzbYlZVAuWSlJg?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
services:
app:
image: docker\/welcome-to-docker
ports:
- 8090:80<\/pre>\n\n\n\n![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXcbZPML57s1Zs26BocKlp77GRzecC8q-iRR9YzIKMiZD0f1wIM3nRtG9xFRR2HG4e4Hj1tjDCYOF5IYKUfU6QpMWVRHV3wBex6XMsPuO88EqT-vrly-90Zu_y1w_ytK8odnAj-wWw?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXcI8MEQDHTMyf0_Lw6752EqGKbrE3Wn15DsEtamgfjh3_J_tastbVAlJVd1AOLe1N3xrhYLopDJmhjqmYkuDJo71gLaoPHUssogNYlum2je4YMj_-dBEktB9PhFY7UVNkAaBgeNxQ?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
http:\/\/{your-server-ip-address}:8090<\/pre>\n\n\n\n![\"-\"](\"https:\/\/lh7-qw.googleusercontent.com\/docsz\/AD_4nXfZYfPcpw4R0BQYC1PnxcdGmPbvs2ifDMoYYRfL_QO_d5Hx1k57CluJNaiCQfLHbWHcDwTt_qdiNKDcNPPhHjkPtne5PuksdIFbsvMgagakL8qlCtf1b8vdLYZz_Lq9te4kl3o4Ig?key=EhUnISKAtZnW-Ws7n1Peyx1E\")
Managing your Coolify server on UpCloud<\/h2>\n\n\n\n
Routine Maintenance<\/h3>\n\n\n\n
\n
Security<\/h3>\n\n\n\n
\n
Conclusion<\/h2>\n\n\n\n