# Nextjs Better Auth Postgres Docker

> Next.js + Better Auth + PostgreSQL を Docker で構築し、Cloud Run へデプロイするスキル。ローカル開発環境のセットアップから Docker Compose、Dockerfile 作成、Cloud Run + Cloud SQL + Secret Manager を使った本番デプロイまでをカバーする。「Next.js と Better Auth でアプリを作りたい」「Docker で PostgreSQL を使いたい」「Docker で構築したい」「Docker Compose を使いたい」「アプリを Docker 化したい」「Dockerfile を書きたい」「Cloud Run にデプロイしたい」「Cloud SQL や Secret Manager を使いたい」ときに使う。

- Skill: `hukusuke1007/nextjs-better-auth-postgres-docker` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add hukusuke1007/nextjs-better-auth-postgres-docker`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hukusuke1007/nextjs-better-auth-postgres-docker/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: hukusuke1007 (https://skillmd.com/u/hukusuke1007)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hukusuke1007/nextjs-better-auth-postgres-docker

---


# Next.js + Better Auth + PostgreSQL + Docker

Next.js App Router + Better Auth + PostgreSQL を Docker で構築し、Cloud Run へデプロイするためのスキルです。

## 対象スタック

- **フレームワーク**: Next.js (App Router, TypeScript)
- **認証**: Better Auth
- **DB**: PostgreSQL 16
- **パッケージマネージャ**: pnpm
- **インフラ**: Docker / Docker Compose、Google Cloud Run、Cloud SQL、Secret Manager

## 参照ドキュメント

詳細な手順は以下の reference ファイルに分けています。

| ファイル                         | 内容                                                            |
| -------------------------------- | --------------------------------------------------------------- |
| `references/local-setup.md`      | ローカル開発環境の構築（Docker Compose + アプリ Docker 化まで） |
| `references/cloud-run-deploy.md` | Cloud Run へのデプロイ（Cloud SQL + Secret Manager 使用）       |

## どちらを参照するか

- **ローカル環境を構築したい** → `references/local-setup.md` を読む
- **Cloud Run にデプロイしたい** → `references/cloud-run-deploy.md` を読む
- **両方やりたい** → `local-setup.md` を完了してから `cloud-run-deploy.md` に進む

## 環境変数の切り替えまとめ

実行環境によって値が変わる変数を把握しておく。

| 変数名                  | ローカル直実行          | Docker Compose (app コンテナ) | Cloud Run              |
| ----------------------- | ----------------------- | ----------------------------- | ---------------------- |
| `DATABASE_URL` のホスト | `localhost`             | `db`                          | Cloud SQL Unix socket  |
| `BETTER_AUTH_URL`       | `http://localhost:3000` | `http://localhost:3000`       | Cloud Run サービス URL |
| `INTERNAL_API_BASE_URL` | `http://localhost:3000` | `http://app:3000`             | Cloud Run サービス URL |