Install Simple Hack on Coolify
Run events, teams, team sites, judging and results on your own server.
People use password accounts without email.
Its default ghcr.io/vineetu/simple-hack:0.8.20 image can be overridden with SIMPLE_HACK_IMAGE.
What you need
A server with Coolify, a domain and wildcard DNS. Use a Docker Compose Empty Service with the proxy settings below. The Simple Host guide describes a separate installation.
The service template
can generate the database credentials, ADMIN_API_KEY, PASSCODE_ENC_KEY and
ANALYTICS_SALT for you. Set SITE_DOMAIN. Email settings are optional.
Steps 1 and 2 below still apply.
Install
- Prepare the domain and certificate capacity in the
standalone guide. Point the apex and wildcard DNS
records at the Coolify server. Use Coolify’s Traefik v3 proxy with
httpandhttpsentrypoints and the externalcoolifyDocker network. In the proxy’s Compose configuration, add--entrypoints.https.allowACMEByPass=trueunder Traefik’scommand:and restart the proxy. This lets the application’s Caddy answer TLS-ALPN challenges through Traefik’s TLS passthrough. See Traefik entrypoints. - In your Coolify project and environment, create a Docker Compose Empty
Service and paste
compose.yamlinto Source Compose. Under Edit Compose File, turn off Escape special characters in labels so the domain regex and Compose variables reach Traefik correctly. Leave the component Domains fields empty: the supplied labels route the apex, event, and nested team names. Review the generated Deployable Compose before deploying. Coolify Service Compose. - Set
SITE_DOMAIN,DB_PASSWORD,ADMIN_API_KEY,PASSCODE_ENC_KEY, andANALYTICS_SALTunder the Service’s environment variables.PASSCODE_ENC_KEYis 32 random bytes in standard base64. The other secrets can be random hex. The standalone installer’s--prepare-onlyoption generates private values. SetSIMPLE_HACK_IMAGEto use another release. Keep these values across restarts and upgrades. Password accounts don’t need email. SetRESEND_API_KEYandMAIL_FROMonly if you want email-code sign-in or email notices. Company sign-in (OIDC_ISSUER,OIDC_CLIENT_ID,OIDC_CLIENT_SECRET,ALLOWED_EMAIL_DOMAINS,OIDC_LABEL,OIDC_INSECURE_ALLOWED,EMAIL_SIGNIN) and the TLS mode (TLS_MODE,ACME_CA) go in under the same Service environment variables. See the standalone guide for what each one does. Forinternal,acmeorcerts, placeca.pemandcerts/in atls/directory next to this Service’s compose file on the Coolify host, the same layout the standalone installer creates. - Deploy. Check that
dbis healthy,releaseexits with code 0, andappbecomes healthy. The one-shotreleasecontainer can make Coolify’s aggregate Service status show exited even whileappanddbare healthy. Checkhttps://<your-domain>/, an event address, and a published team address in a browser. Each should have a trusted certificate.
First sign-in
Open your domain and choose Create an account. Use an email or username plus a password.
Open https://<your-domain>/admin with the Service’s ADMIN_API_KEY.
Set PASSWORD_SELF_SIGNUP=off for admin-created accounts only.
Connect an AI app
In ChatGPT or Claude, add a custom connector called Simple Hack with
https://<your-domain>/mcp. Sign in with your account on this server and choose Allow.
Your server’s /get-started page has the same steps. Use your own server’s address.
Upgrade
Back up first, then change SIMPLE_HACK_IMAGE and restart the Service.
The release container runs migrations before the app starts. A failed migration
prevents the new app from starting. Fix the cause and deploy again.
Do not downgrade a migrated database. Restore a matching backup instead.
Back up
The db and data volumes hold Postgres, team site files and certificates.
Keep both. Use a logical Postgres dump plus a copy of the data volume, as described
in the standalone guide, using your Service’s
Compose project and environment file paths. If you used the service template, use its
generated Postgres user (SERVICE_USER_POSTGRES) in place of simplehack.
Troubleshooting
- Check the platform, event and nested team DNS records and certificate capacity.
- Leave the component Domains fields empty and check the Traefik passthrough settings above.
- Check
db,releaseandappseparately if Coolify shows exited for the Service.
TLS passes through Traefik to Caddy. PROXY protocol preserves visitor addresses for rate limits and analytics. Postgres has no host port.
A public one-click catalog listing is separate: see Coolify’s template eligibility.
Release notes: the changelog.