Skip to main content

​
Prerequisites

  • A Coolify account with access to a server
  • Docker support enabled on your Coolify instance

​
Deployment Steps

1

Create or access your project

If you don’t have a project yet, create a new one in Coolify. Navigate to your project dashboard once created.
2

Create a new resource

In your project, create a new resource. In the “New Resource” page, select Docker Image from the Docker Based section.Enter the following Docker image name:
openinary/openinary
3

Configure exposed ports

In the General configuration section:
  1. Locate the Ports Exposes field
  2. Enter the port 3000
  3. Click Save
4

Configure environment variables

Navigate to Environment Variables in the sidebar and add the following variables:
BETTER_AUTH_SECRET=your-sha256-hash-or-long-secret
BETTER_AUTH_URL=your-coolify-generated-url
NODE_ENV=production
PORT=3000
For BETTER_AUTH_URL, use the URL generated by Coolify in the General tab under Domains.
If you’re using local file storage, no additional environment variables are needed for storage.
5

Configure persistent storage

Navigate to Persistent Storage and add the following volume mounts:

​
Required volume

​
db-data
Volume Mount
required
Destination Path: /app/dataStores the internal Openinary database (admin accounts, API keys, metadata).

​
Storage volumes (if not using S3)

If you’re not using S3-compatible cloud storage, you must also add these two volumes to persist your files and cache.
​
public-files
Volume Mount
Destination Path: /app/apps/api/publicStores original uploaded assets and media files.
​
cache-data
Volume Mount
Destination Path: /app/apps/api/cacheStores optimized and transformed assets in cache for faster delivery.
These volume mounts are essential for data persistence across deployments. Without them, your data will be lost during container restarts or updates.
6

Deploy your application

Once all configurations are set, click the Deploy button to start your Openinary instance.
Your Openinary instance should now be deploying. Monitor the deployment logs to ensure everything starts correctly.
7

Initial setup

Once deployed, visit your Coolify-generated URL or custom domain. You should land on the initial setup page where you can create your administrator account.
Important: Create your admin account immediately after deployment, as the setup route is publicly accessible until completed.
After signing in, you should see the sample assets or your bucket content in the Dashboard.

​
Troubleshooting

If you encounter any issues during deployment:
  1. Check the deployment logs in Coolify for error messages
  2. Verify all environment variables are correctly set
  3. Ensure your domain DNS is properly configured (if using a custom domain)
If problems persist, please create an issue on GitHub with your deployment logs.

​
Next Steps

Now that your Openinary instance is running, learn how to use it:

Transform Images

Learn how to transform and optimize images

Transform Videos

Learn how to transform and process videos