Skip to content

Template · Dev tools

Hoppscotch

Open-source API client (Postman alternative) with PostgreSQL.

Deploy on Skiffly

Opens the dashboard with this template pre-selected. Sign in with GitHub if you are new; the free tier needs no card.

  • Postgrespostgres:17
  • Hoppscotchhoppscotch/hoppscotch:latest
Upstream documentation

What gets deployed

2 services in the environment you pick, on the private network of the project.

About this template

hoppscotch/hoppscotch:latest all-in-one image + PostgreSQL 17. Configure an auth provider (e.g. GitHub or email) via the env variables after deploy.

Postgres

Image: postgres:17

  • Port 5432/tcp
  • 10 GB volume at /var/lib/postgresql/data
  • 1 vCPU · 1 GB

Hoppscotch

Image: hoppscotch/hoppscotch:latest

  • Port 3000/http
  • Public domain with TLS
  • 1 vCPU · 1 GB

Variables

Generated secrets never leave the platform; references are resolved on the private network. Anything marked required is asked for at deploy time.

Postgres

NameValue
POSTGRES_USERpostgresSuperuser name
POSTGRES_PASSWORDgenerated (password)Generated at deploy
POSTGRES_DBhoppscotchDatabase created on first start
PGDATA/var/lib/postgresql/data/pgdata
DATABASE_URLpostgresql://${{self.POSTGRES_USER}}:${{self.POSTGRES_PASSWORD}}@${{self.SKIFFLY_PRIVATE_DOMAIN}}:5432/${{self.POSTGRES_DB}}Connection string on the private network

Hoppscotch

NameValue
DATABASE_URL${{Postgres.DATABASE_URL}}
JWT_SECRETgenerated (secret)
SESSION_SECRETgenerated (secret)
DATA_ENCRYPTION_KEYgenerated (hex32)
REDIRECT_URLhttps://${{self.SKIFFLY_PUBLIC_DOMAIN}}
WHITELISTED_ORIGINShttps://${{self.SKIFFLY_PUBLIC_DOMAIN}}
VITE_BASE_URLhttps://${{self.SKIFFLY_PUBLIC_DOMAIN}}
VITE_SHORTCODE_BASE_URLhttps://${{self.SKIFFLY_PUBLIC_DOMAIN}}
VITE_ADMIN_URLhttps://${{self.SKIFFLY_PUBLIC_DOMAIN}}/admin
VITE_BACKEND_GQL_URLhttps://${{self.SKIFFLY_PUBLIC_DOMAIN}}/backend/graphql
VITE_BACKEND_WS_URLwss://${{self.SKIFFLY_PUBLIC_DOMAIN}}/backend/graphql
VITE_BACKEND_API_URLhttps://${{self.SKIFFLY_PUBLIC_DOMAIN}}/backend/v1
ENABLE_SUBPATH_BASED_ACCESStrue
VITE_ALLOWED_AUTH_PROVIDERSEMAIL
MAILER_SMTP_URLrequired at deploySMTP URL for magic-link sign-in, e.g. smtps://user:pass@smtp.example.com
MAILER_ADDRESS_FROMHoppscotch <noreply@example.com>

Deploy button for your README

Add a one-click deploy link to your repository or docs. Two variants: for light and dark backgrounds.

Deploy on SkifflyDeploy on Skiffly
Markdown · Light background
[![Deploy on Skiffly](https://skiffly.dev/button.svg)](https://skiffly.dev/templates/hoppscotch)
Markdown · Dark background
[![Deploy on Skiffly](https://skiffly.dev/button-dark.svg)](https://skiffly.dev/templates/hoppscotch)
HTML
<a href="https://skiffly.dev/templates/hoppscotch"><img src="https://skiffly.dev/button.svg" alt="Deploy on Skiffly" height="32"></a>

Related templates

All templates

Deploy Hoppscotch in one click

Volumes, secrets and domain pre-wired. Runs on EU nodes, paid per minute from a prepaid balance.

Deploy on Skiffly All templates