coolify.md

title	Coolify Self-Hosting Guide
description	Deploy Instagram Saved Posts Tracker on Coolify PaaS with 1-click Docker Compose.

🔷 Coolify Self-Hosting Guide

Coolify is an all-in-one self-hostable PaaS with support for multiple servers, push-to-deploy, and automatic SSL certificates.

---

🚀 Deployment Steps in Coolify

Step 1: Add New Resource

1. Open your Coolify Dashboard.
2. Navigate to your Project and click + New Resource.
3. Select Docker Compose.

Step 2: Paste Configuration

Paste the contents of coolify-compose.yml:

version: "3.8"

services:
  app:
    image: ghcr.io/gitnasr/instagram-saved-posts:latest
    pull_policy: always
    restart: unless-stopped
    expose:
      - "3000"
    ports:
      - "${PORT:-5050}:3000"
    environment:
      - DATABASE_URL=mongodb://mongo:27017/instagram?replicaSet=rs0&directConnection=true
      - NODE_ENV=production
      - PORT=3000
      - HOSTNAME=0.0.0.0
      # AI Vector Search is an optional beta add-on, off by default.
      # To enable it, see ../features/ai-vector-search.md
      - CLOUDINARY_CLOUD_NAME=${CLOUDINARY_CLOUD_NAME:-}
      - CLOUDINARY_API_KEY=${CLOUDINARY_API_KEY:-}
      - CLOUDINARY_API_SECRET=${CLOUDINARY_API_SECRET:-}
    depends_on:
      mongo:
        condition: service_healthy

  mongo:
    image: mongo:7.0
    restart: unless-stopped
    command: ["--replSet", "rs0", "--bind_ip_all", "--port", "27017"]
    volumes:
      - mongo_data:/data/db
    healthcheck:
      test: >
        mongosh --port 27017 --eval "
          try {
            rs.status().ok
          } catch (e) {
            rs.initiate({
              _id: 'rs0',
              members: [{ _id: 0, host: 'mongo:27017' }]
            }).ok
          }
        " || exit 1
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 2s

volumes:
  mongo_data:

Step 3: Domain & Routing

1. In the Coolify resource view, configure your FQDN / Domain (e.g. https://instagram.example.com).
2. Set the destination port to 3000.

Step 4: Deploy

Want semantic image and face search? It is an optional beta add-on that is off by default — see AI Vector Search for the extra service and environment variable to add here.

Click Deploy. Coolify will orchestrate the containers, provision Traefik routing, issue Let's Encrypt certificates, and make your app accessible securely over HTTPS!