BookStack
セットアップ
使い方
カスタマイズ
トラブル対処
過去にはまったトラブルについて対処方法を記載します。
🛠 BookStackがHTTP 500を返して復旧しないときの対処法
⚠️ はじめに:500エラーの本当の原因を探る BookStackで突然すべてのページがHTTP 500を返すようになり、サーバーを再起動するまで回復しないという症状が発生しました。このとき ...
BookStackの.envファイルを作成する
🛠 .env ファイルの作成手順 BookStack のルートディレクトリ(通常 /var/www/BookStack/)にいる状態で、以下のコマンドを実行してください: s...
Laravelのキャッシュクリアに失敗した場合の対処法
はじめに 🛠 BookStackがHTTP 500を返してリブートしないと復旧しないときの対処法 でLaravelのキャッシュで失敗したので対処法を残します。 ⚠️ 現象 php arti...
MariaDB、PHPのクラッシュ防止のためのスワップ設定
概要 BookStackを試すためにAWS Lightsailのミニマムの構成(512 MB RAM, 2 vCPUs, 20 GB SSD)でスタートしたところ、ブラウザが内部エラーの500...
ディスク逼迫の対処について
🌱 はじめに 本記事では、BookStackを使っているUbuntuサーバーで、ディスク容量が急に逼迫した際の調査・原因究明・対処までの流れをまとめます。df と du の差異、lsof を用...
TIPS
バックアップの設定
🪣 BookStackバックアップをS3へ自動退避する手順書(cron・検証・通知つき)
🧭 はじめに 本手順書は、BookStack(Linux上)で作成したバックアップ(DB / uploads / .env)を 日次で生成し、S3へ自動転送し、成功/失敗を検証して通知するまでを...
Lightsail(BookStack)バックアップ用 S3 + IAM 設定手順
はじめに 本記事では、Lightsail 上の BookStack データを S3 にバックアップするための最小構成を、 AWS マネジメントコンソール(GUI)操作前提で整理する。 方針は以下...
S3バケットのバージョニング有効化手順(BookStackバックアップ向け)
🧭 はじめに 本記事は、BookStackバックアップを保存する S3バケットでバージョニングを有効化する具体手順と運用上の注意点をまとめたものです。 親マニュアルの 1-2「バージョニングを有...
BookStack データのバックアップ方法
🧭 はじめに 本記事では、BookStack を安全に運用するためのバックアップ方法を、 手動 → 自動(cron) という段階構成で整理する。 特に重視するポイントは以下の3点: どのコマン...
🔔 BookStackバックアップ失敗時にSlackへ通知する設定手順(Incoming Webhook)
📝 はじめに 本記事では、BookStackのバックアップ処理でエラーが発生した場合に、Slackへ自動通知を送る仕組みを構築する手順をまとめる。 cronで回るバックアップは「静かに失敗する」...