Appsmith 日本語導入・運用キット（初回起動の破損からの復旧つき）
社内の管理画面・業務ツールを画面組み立てだけで作れるOSS「Appsmith」を、日本の会社で運用するための手順書＋テンプレート一式。最大の内容は、公式イメージが初回起動の最初の20秒を中断すると恒久的に壊れる問題の診断と復旧。壊れると全APIが502になりログインできないのに、画面のHTMLは200を返しコンテナだけ永久にunhealthyという極めて気づきにくい状態になります。原因（同梱MongoDBのレプリカセット未初期化、初期化済み判定がデータファイルの有無だけ）を突き止め、公式が案内する「データを消して作り直す」ではなく、データを残したまま直す手順を実機で確認。Appsmithには翻訳の仕組み自体が無い（文言1,397件が直書き・言語ファイル0本）ため英語画面の読み替え表、Excelで文字化けしないCSV書き出し、日本語テーブル名の扱い、復旧を自動判定するスクリプトを同梱。
入手方法は3つあります
同じゴールに、あなたに合う入口からどうぞ。
| ①完成品を購入 | すぐ使いたい方向け。このページで購入し、即ダウンロード（ソースコード付き・5,500円税込）。AIで自社向けに改変できます。 |
|---|---|
| ②この商品を自社仕様に | 「うちの業種・業務に合わせてほしい」方向け。バイブカスタマイズ（110,000円税込）で、この商品を土台に当社が変更します。動くデモを確認してからのお支払いです。 バイブカスタマイズを見る |
| ③ゼロから作る | 近い商品が無い、または業務そのものが特殊な方向け。設計書から作るバイブプロトタイプ制作（330,000円税込）です。 バイブプロトタイプ制作を見る |
初回起動の破損からの復旧つきとは
初回起動の破損からの復旧つきとは、社内の管理画面・業務ツールを画面組み立てだけで作れるOSS「Appsmith」を、日本の会社で運用するための手順書＋テンプレート一式。
何のためのものか
社内の管理画面・業務ツールを、画面を組み立てる感覚で作れるオープンソース Appsmith（Apache-2.0・GitHubスター約40,800）を、日本の会社で運用するための導入キットです。
既にあるデータベースにつなぎ、一覧・検索・登録の画面を数時間で作れます。kintone のようなツールを外部サービスに頼らず、自社サーバーで持てます。
このキットの中身の半分は、導入で必ず遭遇する重大な不具合の診断と復旧です。
最初にお伝えすること
Appsmith に日本語表示はありません。
設定で切り替えられないだけでなく、翻訳の仕組み自体が存在しません。実際に調べた結果です。
| 調べたこと | 結果 |
|---|---|
| 画面のHTMLの言語指定 | lang="en" に固定 |
| 言語ファイル（ja.json など） | 0本 |
| 文言の置き場所 | プログラムファイル1本に直接記述 |
| そこに書かれている英語の文言 | 1,397件 |
したがって本キットは翻訳キットではありません。英語のまま使いこなすための、読み替え表と運用ノウハウのキットです。
一方で、扱うデータが日本語であることには何の支障もありません。ここは実測で確認しています。
当社が実際に踏んだ不具合
公式のとおりに起動したのに、ログインできませんでした。
症状（三つが同時に成り立ちます）
| 確認内容 | 結果 |
|---|---|
GET / |
200（画面は開く） |
GET /api/v1/users/me |
502（APIは全滅） |
| コンテナの状態 | 永久に unhealthy |
外形監視をトップページに向けていると、この障害は永久に検知できません。200が返り続けるためです。
原因
同梱のMongoDBがレプリカセットとして起動しているのに、その初期化が一度も行われていない状態でした。初期化されていないノードは主系でも副系でもないため、どのドライバも接続先を選べず30秒で諦めます。
```
com.mongodb.MongoQueryException: Command failed with error 13436
(NotPrimaryOrSecondary): 'node is not in primary or recovering state'
```
なぜそうなったか
起動スクリプトの「初期化済みか」の判定が、データファイルが存在するかどうかだけでした。
そのデータファイルはMongoDBが起動した瞬間に作られます。仕上げの初期化まで20秒以上あります。この間にコンテナが止まると、次回以降は「データファイルがある＝初期化済み」と判断され、仕上げが二度と実行されません。
中断は簡単に起きます。
- 設定を直そうとして起動直後に止めた
- ポートが衝突したので止めて直した
- サーバーが再起動した
- メモリ不足でコンテナが落ちた（小さなVPSでは十分あり得ます）
小さなサーバーに初めて入れる人ほど踏みやすい罠です。
復旧
公式の案内は「データを消して作り直す」です。本キットにはデータを消さずに直す手順を載せています。未完了だった初期化を手で実行し、サーバー側を起動し直すだけです。
実機で確認した結果です。
| 項目 | 復旧前 | 復旧後 |
|---|---|---|
| API | 502 | 200 |
| コンテナ | unhealthy | healthy |
| 再起動を繰り返すプロセス | 30秒ごとに再起動 | 安定 |
| 作ったアプリと接続情報 | — | 保持 |
効かなかった対処も記載しています
再起動を繰り返すプロセスを止める変数を見つけましたが、効きませんでした。プロセスの環境変数には渡っているのに、起動する側が見ていません。同じ回り道をしないよう、経緯ごと書いています。
日本語での利用について測ったこと
| 項目 | 結果 |
|---|---|
| 日本語のデータ | 問題なく扱える。保存・表示・並べ替え・部分一致検索とも正常 |
| 日本語のテーブル名・列名 | 引用符なしでそのまま使える |
| 英字で大文字混じりの名前 | 引用符が必要（日本語のほうが楽です） |
| 日本語の入力・変換 | 正常 |
| CSVの書き出し | Excelで文字化けします（回避策を同梱） |
CSVについては、配信されている画面用プログラム216本をすべて調べましたが、Excel向けの目印を付けている箇所はありませんでした。設定で変えることもできません。貼るだけで使える書き出しコードを同梱しています。
同梱物
| 場所 | 内容 |
|---|---|
docs/ |
手順書8章 |
docker-compose.yml |
日本向けに調整した構成（日本時間・利用状況の外部送信を停止） |
scripts/start.sh |
起動して healthy まで待ちきる。初回はこれを使えば壊れません |
scripts/healthcheck.sh |
APIまで見る健全性確認。画面200だけで安心しない作り |
scripts/repair.sh |
壊れた環境の復旧。症状を判定し、対象外なら何もしません |
scripts/backup.sh |
バックアップと、暗号化の鍵の控え |
scripts/collect_diag.sh |
相談用の情報収集（鍵は伏せます） |
templates/jpdemo-compose.yml |
日本語のテーブル名を持つ検証用データベース |
templates/jpdemo-init.sql |
検証用データ。改行やカンマを含む値も入っています |
templates/csv_export.js |
Excelで化けないCSV書き出し。貼るだけ |
スクリプトはすべて実機で動作を確認しています。
手順書の内容
| 章 | 内容 |
|---|---|
| 01 | 導入。初回起動の罠と、公開時の注意 |
| 02 | 壊れた環境を、データを消さずに直す |
| 03 | 日本語のデータ・CSV・日付・金額・全角半角 |
| 04 | データベースのつなぎ方。読み取り専用から始める設計 |
| 05 | 業務ツールの作り方。作りすぎないための線引き |
| 06 | 利用者・権限・バックアップ・更新・資源の目安 |
| 07 | 英語画面の読み替え表とつまずき集 |
こんな会社に向いています
- kintone などの外部サービスの利用料（10ユーザーで年20万円超）を自社サーバーに置き換えたい
- 既にあるデータベースに、社内向けの画面だけ足したい
- 情シスや開発担当が少人数で、管理画面を作る時間を短くしたい
- すでに Appsmith を入れてみて、ログインできず困っている
動作条件
- Docker Engine と Docker Compose v2 が動くサーバー
- AVX命令に対応したCPU（非対応だと同梱MongoDBが起動しません。確認方法を記載）
- メモリ4GB以上。20人規模なら8GB
- Appsmith の画面は英語です。日本語化はできません
ライセンス
Appsmith 本体は Apache-2.0 です。本キットの文書とスクリプトは、購入者の組織内での利用・改変を許諾します。再配布・再販売はご遠慮ください。
販売情報
| 開発元 |
株式会社エクスブリッジ https://exbridge.jp/ |
|---|---|
| 𝕏 アカウント | @xb_bittensor |
| デモサイト | https://katsushi2441.github.io/vwork/articles/2026-09-05-appsmith-first-boot-brick.html |
| 配布ファイル | appsmith-kit.zip （36 KB） |
| 公開日 | 2026年9月5日 |
ご購入前に必ずお読みください
- これはプロトタイプです。動作を保証していません。お客様の環境 （サーバー・PHPのバージョン・通信の制限など）によっては、そのままでは動かない可能性があります。
- AIエージェント（Claude Code / Codex など）を使えることが前提です。 設置も、つまずいたときの解決も、AIに相談しながらご自身で進めていただく前提の商品です。 手順書・設計書・AI向け指示書を同梱しています。
- お問い合わせに必ずお応えできるとは限りません。 購入代金に個別サポートは含まれていません（有償のサポートは別途承ります）。
- ノークレーム・ノーリターンでお願いいたします。 ダウンロード商品の性質上、ご購入後の返品・返金はお受けできません。 必ずデモを触って、ご自身の目で確かめてからご判断ください。
そのほかの条件
- 設置には、PHPが動作するレンタルサーバー等のご用意が必要です。詳細は各アプリの説明をご確認ください。
- ソースコードは改変・再配布が可能です。ライセンスは同梱の LICENSE をご確認ください。
よくある質問
ライセンスは？
MITライセンスです。ソースコードを同梱し、商用利用・改変・再配布が自由に行えます。
購入前に試せますか？
はい。デモで実際に触って、気に入ってから購入できます（https://katsushi2441.github.io/vwork/articles/2026-09-05-appsmith-first-boot-brick.html）。
AIエージェントで改造・拡張できますか？
できます。Claude Code等のAIエージェント向けの設計マニュアルが付属し、触れてよい範囲を宣言したうえで安全に変更を頼めます。
買い切りですか？月額はありますか？
買い切りです。月額料金はありません。
