Development/Testing Environment:
We strongly recommend using Docker Compose for development and testing environments. This provides a quick and easy setup with all dependencies included.Production Environment:
For production deployments, we do not recommend using Docker Compose with Redis and PostgreSQL included. Instead:
  • Deploy Redis and PostgreSQL using cloud services (AWS, Google Cloud, etc.) or build your own infrastructure with high availability
  • Deploy only the Usertour application using the published Docker Hub image and configure Redis and PostgreSQL through environment variables

​
Coolify Deployment Guide

​
What is Coolify?

Coolify is an open-source, self-hostable platform-as-a-service (PaaS) that simplifies the deployment of applications. It provides a user-friendly interface for managing Docker containers, databases, and other services.

​
Prerequisites

Before deploying Usertour with Coolify, ensure you have a Coolify instance running (see Coolify installation guide).

​
Deployment Steps

  1. Create a New Resource in Coolify Navigate to your Coolify dashboard, open your project, and click the Add New Resource button.
  2. Select Deployment Method Choose Public Repository as your deployment option.
    If you’re using your own repository, please select Public Repository or Private Repository based on your repository’s visibility settings.
  3. Configure Repository URL Enter the following repository URL (this is an example, we recommend using your own configuration): 
    https://github.com/usertour/examples
    Then click Check repository to validate the connection.
    Recommendation: We suggest cloning the code to your own repository and maintaining the configuration yourself for better control and customization.
  4. Select Build Pack Choose Docker Compose as your build pack and click the Continue button.
    You can also choose Dockerfile to deploy only Usertour (without Redis and PostgreSQL).
  5. Configure Docker Compose Location Update the Docker Compose location to: 
    /docker/docker-compose.coolify.yml
    If you’re using your own repository, please configure this path according to your repository’s directory structure.
  6. Initiate Deployment Click the Deploy button to start the deployment process.
  7. Verify Deployment Status Once deployment completes successfully, you should see:
    • Green Running status
    • Deployments showing success

​
Accessing Usertour

  1. Initial Access
    • Navigate to http://<your-server-ip>:8011 or your configured domain and port
    • Note: Usertour runs on HTTP by default. For HTTPS, you’ll need to set up a reverse proxy
  2. Default Login Credentials
    • Email: lisa@simpson.com
    • Password: secret42
    • Important: Change the password immediately after your first login

​
Next Steps

To enable content delivery and user tracking, install Usertour.js in your application. See the Usertour.js installation guide for detailed instructions.