4.6 KiB
Contributing
"First, thanks for considering contributing to my project. It really means a lot!" - @andrasbacsai
You can ask for guidance anytime on our Discord server in the #contribute
channel.
Code Contribution
1. Setup your development environment
Follow the steps below for your operating system:
Windows
-
Install Docker Desktop (or similar):
- Download and install Docker Desktop for Windows
- Follow the installation instructions provided on the Docker website
-
Install Spin:
- Follow the instructions to install Spin on Windows from the Spin documentation
MacOS
-
Install Orbstack or Docker Desktop (or similar):
- Orbstack (faster, lighter, better alternative to Docker Desktop)
- Download and install Orbstack
- Docker Desktop:
- Download and install Docker Desktop for Mac
- Orbstack (faster, lighter, better alternative to Docker Desktop)
-
Install Spin:
- Follow the instructions to install Spin on MacOS from the Spin documentation
Linux
-
Install Docker Engine or Docker Desktop (or similar):
- Docker Engine (recommended):
- Follow the official Docker Engine installation guide for your Linux distribution
- Docker Desktop:
- If you want a GUI, you can use Docker Desktop for Linux
- Docker Engine (recommended):
-
Install Spin: Follow the instructions to install Spin on Linux from the Spin documentation
2. Verify Installation
After installing Docker (or Orbstack) and Spin, verify the installation:
- Open a terminal or command prompt
- Run the following commands:
You should see version information for both Docker and Spin.docker --version spin --version
3. Fork/Clone the Coolify Repository and Setup your Development Environment
-
Fork/clone the Coolify repository to your GitHub account.
-
Install a code editor on your machine (choose one):
-
Visual Studio Code:
- Windows/macOS/Linux: Download and install from https://code.visualstudio.com/
-
Cursor (recommended):
- Windows/macOS/Linux: Download and install from https://cursor.sh/
-
Zed (very fast code editor):
- macOS/Linux: Download and install from https://zed.dev/
- Windows: Not available yet
-
-
Clone the Coolify Repository to your local machine
- Use
git clone
in the command line - Use GitHub Desktop (recommended):
- Download and install from https://desktop.github.com/
- Use
-
Open the cloned Coolify Repository in your chosen code editor.
4. Set up Environment Variables
-
Copy the
.env.development.example
file to your.env
file. -
Set the database connection:
- For macOS users with Orbstack, update the
DB_HOST
variable topostgres.coolify.orb.local
:DB_HOST=postgres.coolify.orb.local
- For other systems, you may need to use the appropriate IP address or hostname of your PostgreSQL database.
- For macOS users with Orbstack, update the
-
Review and adjust other environment variables as needed for your development setup.
5. Start & Setup Coolify
-
Open a terminal in the Coolify directory.
-
Run the following command:
spin up
Note: You may see some errors, but don't worry; this is expected.
-
If you encounter permission errors, especially on macOS, use:
sudo spin up
6. Start Development
-
Access your Coolify instance:
- URL:
http://localhost:8000
- Login:
test@example.com
- Password:
password
- URL:
-
Additional development tools:
- Laravel Horizon (scheduler):
http://localhost:8000/horizon
Note: Only accessible when logged in as root user - Mailpit (email catcher):
http://localhost:8025
- Telescope (debugging tool):
http://localhost:8000/telescope
Note: Disabled by default, enable by adding the following environment variable to your.env
file:TELESCOPE_ENABLED=true
- Laravel Horizon (scheduler):
7. Contributing a New Service
To add a new service to Coolify, please refer to our documentation: Adding a New Service