Skip to main content
Hosted users on hizz.io can skip this page. If you want to run your own copy of Hizz, you will need:
  • A web deployment target
  • A Postgres database
  • A Blockfrost project key
  • Your app environment variables

​
Suggested setup order

1

Create a Postgres database

A managed Postgres service is the simplest place to start.
2

Add your environment variables

At minimum, set your database connection string, Blockfrost key, auth secrets, and the public app URL.
3

Apply the database schema

Run the schema push once your database credentials are available.
4

Deploy the app

After the environment and database are ready, deploy the same way you would any other Next.js application.

​
Apply the schema

Once DATABASE_URL is configured: 
npm run db:push
If you prefer migration files for production workflows: 
npm run db:generate   # produces a timestamped SQL file under drizzle/

​
Inspecting data locally

npm run db:studio
This opens Drizzle Studio locally so you can inspect tables and confirm your data is flowing as expected.

​
Environment reference

VariablePurpose
DATABASE_URLPostgres connection string
BLOCKFROST_PROJECT_IDMainnet project key
CRON_SECRETBackground refresh authentication
AUTH_SECRETSession encryption
AUTH_URLCanonical public URL for Auth.js, for example https://www.hizz.io
GOOGLE_CLIENT_IDGoogle OAuth web client ID
GOOGLE_CLIENT_SECRETGoogle OAuth web client secret
For Google sign-in, register the canonical callback URL in Google Cloud: https://www.hizz.io/api/auth/callback/google. If you serve another stable domain, replace https://www.hizz.io with that domain and keep AUTH_URL in sync.
If you only want to use Hizz, the hosted product at hizz.io already includes the required infrastructure.