AltFreeStack
Practical guide

How to deploy any tool with Docker

The same 6-step process works for any of the 100+ tools in the catalog: only the docker-compose.yml you copy in step 3 changes.

  1. 1. Create your server (VPS)

    ~5 min

    Choose a provider from the Hosting & Deals page and create an Ubuntu 22.04+ server. 1 vCPU and 1-2GB RAM is enough for most tools in the catalog; check your tool's technical profile if you need more (for example, generative AI tools usually need more RAM or a GPU).

    Save the public IP the provider gives you — you'll need it in the next step.

  2. 2. Connect via SSH and install Docker

    ~5 min

    From your terminal, connect to the server:

    ssh root@YOUR_SERVER_IP

    Install Docker and the Compose plugin with the official script:

    curl -fsSL https://get.docker.com | sh
  3. 3. Copy your tool's docker-compose.yml

    ~2 min

    Go to the profile of the tool you want to deploy, click Copy on the code block, and create the file on your server:

    mkdir my-app && cd my-app
    nano docker-compose.yml
    # paste the content, save with Ctrl+O and exit with Ctrl+X

    Before continuing, change the example passwords (change-me, change-me-super-secret) to your own secure values.

  4. 4. Start the containers

    ~3 min

    From the same folder, run:

    docker compose up -d

    Docker will pull the images and start all services in the background. Check everything is running with:

    docker compose ps
  5. 5. Point your domain and enable HTTPS

    ~10 min

    Create an A DNS record pointing your domain (or subdomain) to the server's IP. For free HTTPS, the simplest approach is putting Caddy in front as a reverse proxy — it generates and renews Let's Encrypt certificates automatically with a 3-line Caddyfile:

    yourdomain.com {
      reverse_proxy localhost:YOUR_APP_PORT
    }
  6. 6. Maintenance: updates and backups

    recurring

    To safely update your tool to the latest version:

    docker compose pull
    docker compose up -d

    Back up your data volumes periodically (the ones under volumes: in each docker-compose.yml) — they hold your database and files.

Ready to deploy your first tool?

Choose a provider with free credit and get started in minutes.

See recommended hosting