⚡

Supabaseのlocal開発環境構築とSupabase CLI について

に公開
2026/09/26
DaaS
DB
Supabase
tech

こんにちは、Webエンジニアのまさぴょんです！
今回は、Supabaseのlocal開発・環境構築とSupabase CLI について解説していきます🐱

Supabaseとは？

Supabaseは、Firebase代替として注目を集めているオープンソースのBaaS(BackEnd as a Service)です。
PostgreSQLを基盤としており、データベース管理、認証、ストレージ、Vector Store、リアルタイムのデータ更新、サーバーレス関数などの機能が提供されています。

開発者はSupabaseを使用することで、自動生成されるRESTful APIを介してデータベースとやり取りして、リアルタイムのデータ同期やユーザー認証を簡単に実装できます。

また、オープンソースであるため、コードを自由にカスタマイズすることも可能です。

Supabase DocsのTopを見れば、多機能であることや、さまざまなフレームワークに対応していることがすぐにわかります👀🌟

https://supabase.com/docs

https://supabase.com/docs

Supabaseのlocal開発環境構築のための前提条件

Supabaseのlocal開発・環境構築を始めるにあたり、次の2つが必須になります👀

  1. Dockerのインストール
    • SupabaseはDockerコンテナ上で動作するため、Docker のインストールが必須です。
  2. Supabase CLIのインストール
    • Supabase CLIはローカル開発を容易にするためのツールです。

https://supabase.com/docs/guides/local-development/cli/getting-started

https://supabase.com/docs/guides/local-development/cli/getting-started

npmを使用する場合

bash
npm install -g supabase

Homebrewを使用する場合（macOS）

bash
brew install supabase/tap/supabase

Supabase local環境構築の手順

ここからは、順を追って、Supabaseのlocal環境を構築していきます💪🥺🔥

1. 新しいプロジェクトの作成

bash
mkdir my-supabase-project && cd my-supabase-project

# Local Supabase 環境を作成する 
supabase init

supabase initコマンドを実行することで、supabaseディレクトリと設定ファイルが生成されます。

bash
my-supabase-project % tree
.
└── supabase
    └── config.toml

2 directories, 1 file

2. Supabase スタックを起動

次のコマンドで、Supabase スタックを起動することができます。

bash
supabase start

すべての Supabase サービスが実行されると Local Supabase の認証情報を含む、次のような情報が出力されます👀✨

API, DB, Studio, Inbucketなどの Local Supabase Stackが起動していることがわかります🌟

bash
Started supabase local development setup.

         API URL: http://localhost:54321
          DB URL: postgresql://postgres:postgres@127.0.0.1:54322/postgres
      Studio URL: http://localhost:54323
    Inbucket URL: http://localhost:54324
      JWT secret: ・・・ 省略 ・・・
        anon key: eyJh......
service_role key: eyJh......
service_role key: eyJh......
   S3 Access Key: ・・・ 省略 ・・・
   S3 Secret Key: ・・・ 省略 ・・・
       S3 Region: local

3. Supabase Studioへのアクセス

ローカル開発環境には、データベースを操作するためのグラフィカル インターフェイスである Supabase Studio (http://localhost:54323) が含まれています。

Supabase Studio では、データベースや認証設定などを確認することができます。

4. アプリケーションからの接続について

アプリケーションとの接続の際は、.envに接続情報を記載して、接続します。

.env
SUPABASE_URL=http://localhost:54321
SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...

その他のSupabase CLIでの操作について

ここでは、上記の環境構築では触れなかった Supabase CLI について記載します🌟

Supabase Stackの停止

supabase startコマンドで起動したSupabase Stack をまとめて停止したい場合は、次のコマンドを使用します。

bash
supabase stop

Supabaseのローカル環境変数の状態を表示する

supabase statusは、Supabaseのローカル環境変数の状態を表示するコマンドです。

bash
supabase status

Supabase CLI help確認

bash
supabase -h

追加設定

ポートの変更

デフォルトのポートを変更する場合は、supabase/config.tomlを編集します。

まとめ

Supabase の local 環境構築は手軽にできることがわかりました🙌
Supabaseを活用して、さらに記事を書いていきたいと思います💪🥺🔥

参考・引用

https://supabase.com/docs

https://supabase.com/docs

https://supabase.com/docs/guides/local-development/cli/getting-started

https://supabase.com/docs/guides/local-development/cli/getting-started

https://supabase.com/docs/guides/local-development/overview

https://supabase.com/docs/guides/local-development/overview

https://zenn.dev/manase/scraps/fc3dcbe00876fb

https://zenn.dev/manase/scraps/fc3dcbe00876fb

https://dev.classmethod.jp/articles/supabase-graphql/

https://dev.classmethod.jp/articles/supabase-graphql/

https://zenn.dev/masatotezuka/articles/supabase_prisma_20230826

https://zenn.dev/masatotezuka/articles/supabase_prisma_20230826

https://qiita.com/NagaJun/items/9c7516274566362b0c95

https://qiita.com/NagaJun/items/9c7516274566362b0c95

https://zenn.dev/razokulover/articles/db984ebfcf4bf6

https://zenn.dev/razokulover/articles/db984ebfcf4bf6

🐱 メンターサービス：未経験から AI 駆動開発ができるまで伴走します

最後までお読みいただきありがとうございました！

私は本業で Web アプリ / AI プロダクト開発をしている現役エンジニアです。LLM・AI エンジニア兼 Web エンジニアとして、AI エージェントアプリ開発などを得意としています。

最近は Claude Code と Cursor を毎日使い倒しながら、個人開発でも AI と一緒にアプリ・Bot を作ってきました。「AI とどう会話すれば、思った通りのコードが出てくるのか」を試行錯誤の中で掴んだ感覚を、これから始める方にもお届けしたくてメンターサービスを始めました。

🚀 こんなことをサポートしています

  • AI / LLM の基礎、Cursor / Claude Code の使い方、環境構築
  • 自分のアイデアを「要件 → 仕様 → 実装」まで進める仕様駆動開発
  • Web アプリを 1 つ最後まで作って公開する卒業制作の伴走
  • AI 副業で稼ぐための戦略立案、転職・独立相談

💡 3 つのコースから選べます

コース 内容 向いている方
🚀 しっかり 月 4 回・60 分の 1on1 2 ヶ月で本気でコミットしたい方
🌱 じっくり 月 2 回・60 分の 1on1 本業と両立して無理なく学びたい方
💬 お試し 単発のビデオ通話相談 まずは話を聞いてみたい方

※ Discord でのチャット質問は 無制限、専用カリキュラムも作成します。

🔗 各種リンク

契約前のご相談は無料です。 「自分にできるかな？」「どのくらい時間が必要？」などお気軽にメッセージください☘️

【お知らせ】実践型AI研修「StudyQuest」を開発しました🎓

私が代表社員&COOを務める M16合同会社では、非エンジニアのための実践型AI研修 StudyQuest を開発・運営しています。
経理・営業・法務・人事など、職種ごとの実務課題を、ChatGPT・Copilot・Claude など普段使っている AI でそのまま実行して身につけるオンライン研修です。

  • 5 つのトラック で、職種を問わない AI 活用の基本から職種別の実務、基礎技能、DeepTech まで扱います
  • エンジニア向けには、Claude Code の環境構築からループエンジニアリングまで をカバーしています
  • 無料アカウントで無料講座 3 本と初級認定テストまで受講でき、初級バッジを取得できます
  • 法人向けには、メンバーの受講状況を一覧できる管理ダッシュボード をご用意しています

「社内に AI 活用を広げたい」「自分の職種で AI を使いこなしたい」という方は、ぜひ一度のぞいてみてください🐱

https://study-quest.jp/

Discussion