systemctl と systemd の使い方 - サービスの自動起動・ユニットファイル・ログ確認の基本

systemctl と systemd の使い方 - サービスの自動起動・ユニットファイル・ログ確認の基本

作成日:
読了:約52分
更新日:

当サイトは Amazon.co.jp を宣伝しリンクすることで紹介料を得る手段を提供する、Amazonアソシエイト・プログラムの参加者です。価格・在庫はリンク先の最新情報をご確認ください。

いまの多くのLinuxディストリビューションでは、サーバー起動時にWebサーバーやデータベースを立ち上げ、落ちたら再起動し、ログを集める役目をsystemdが担っています。自分で作ったNode.jsやPythonのアプリを常駐させるときも、systemdにサービスとして登録するのが定番です。

この記事では、systemctl でサービスを起動・停止・自動起動する方法、ユニットファイルの書き方、journalctl でのログの見方、そしてサービスが起動しない時に確かめる場所を順に整理します。

NOTE

仕様は2026年11月17日に、freedesktop.orgで公開されているsystemdのmanページ(systemctl(1)、systemd.unit(5)、systemd.service(5)、journalctl(1)など)の最新版で確認しました。ディストリビューションに入っているsystemdが古い場合、一部のオプションが無いことがあります。手元の版は man systemctl などで確かめてください。記事中のコマンドの出力は形を示すための例で、細部は版や環境によって変わります。

先に結論: よく使うコマンドの早見表

やりたいことコマンド
状態を見るsystemctl status sample-app
起動する/止める/再起動するsudo systemctl start sample-app / stop / restart
設定ファイルを読み直させる(アプリ側)sudo systemctl reload sample-app
自動起動を有効にして、今すぐ起動もするsudo systemctl enable --now sample-app
自動起動を無効にするsudo systemctl disable sample-app
ユニットファイルの変更をsystemdに読み込ませるsudo systemctl daemon-reload
設定の一部だけ上書きするsudo systemctl edit sample-app
失敗したユニットを一覧するsystemctl --failed
サービスのログを見るjournalctl -u sample-app
ログを流しながら見るjournalctl -u sample-app -f
起動に失敗した直後の詳しいログjournalctl -xeu sample-app

sample-app は説明用のダミーのサービス名です。サービスのユニット名は sample-app.service ですが、systemctl(1)によると、拡張子を省略すると既定で .service が補われるので、systemctl start sample-app と systemctl start sample-app.service は同じ意味になります。

systemdとは

PID 1として動くinit

systemdは、Linuxのシステムとサービスを管理するプログラムです。systemd(1)のmanページによると、起動時に最初のプロセス(PID 1)として動くと、ユーザー空間のサービスを立ち上げて維持するinitシステムとして働きます。ふだんは /sbin/init へのシンボリックリンクとして置かれ、ユーザーが直接起動することはほとんどありません。

PID 1が特別な役割を持つ理由や、親を失ったプロセスがどう扱われるかは、UNIXシグナルとプロセスのライフサイクルで詳しく書いています。

ログインしたユーザーごとにも別のsystemdが起動し、そのユーザー用のサービスを管理します。これが後半で触れる「ユーザーサービス」です。

ユニットの種類

systemdは、管理する対象を「ユニット」という単位で扱います。ユニットは設定ファイル(ユニットファイル)で定義し、ファイル名の拡張子で種類を表します。systemd(1)には11種類が載っています。

種類拡張子役割
サービス.serviceデーモンなどのプロセスを起動・管理する。この記事の主役
ソケット.socketソケットを用意し、接続が来たらサービスを起動する(ソケットアクティベーション)
ターゲット.target複数のユニットをまとめる。起動時の同期点にもなる(multi-user.target など)
タイマー.timer決まった時刻や間隔で、別のユニットを起動する
マウント.mountファイルシステムのマウントポイントを管理する
オートマウント.automountアクセスされた時にマウントする
デバイス.deviceカーネルのデバイスをsystemdから見えるようにする
スワップ.swapスワップ領域を管理する
パス.pathファイルやディレクトリの変化をきっかけにユニットを起動する
スライス.sliceプロセスを階層的にまとめ、資源(CPUやメモリ)を管理する
スコープ.scopesystemdが起動したのではない外部のプロセスをまとめて管理する

スライスやスコープの資源管理には、Linuxカーネルのcgroupが使われています。cgroupそのものの仕組みはLinuxコンテナの仕組み入門を参照してください。

systemctlとjournalctlの関係

systemdまわりでよく使うコマンドは2つです。

コマンド相手役割
systemctlsystemd(サービスマネージャー)ユニットの起動・停止・自動起動の設定、状態の確認
journalctlsystemd-journald(ログを集めるサービス)ジャーナル(systemdのログ)を検索して表示する

サービスが標準出力や標準エラー出力に書いた内容は、既定でジャーナルに送られます(systemd.exec(5)の StandardOutput= の既定値は、マネージャー設定の DefaultStandardOutput= で、その既定は journal)。そのため、アプリ側でログファイルを用意しなくても、console.log や print の出力を journalctl で読めます。systemctl status の末尾にも、このジャーナルから直近のログが表示されます。

systemctlの基本操作

statusの読み方

まずは状態の確認です。systemctl(1)に載っている出力例は次のような形です。

systemctl status の出力例(systemctl(1)の例より)
$ systemctl status bluetooth
● bluetooth.service - Bluetooth service
     Loaded: loaded (/usr/lib/systemd/system/bluetooth.service; enabled; preset: enabled)
     Active: active (running) since Wed 2017-01-04 13:54:04 EST; 1 weeks 0 days ago
       Docs: man:bluetoothd(8)
   Main PID: 930 (bluetoothd)
     Status: "Running"
      Tasks: 1
     Memory: 648.0K
        CPU: 435ms
     CGroup: /system.slice/bluetooth.service
             └─930 /usr/lib/bluetooth/bluetoothd
 
Jan 12 10:46:45 example.com bluetoothd[8900]: Not enough free handles to register service
Jan 12 10:46:45 example.com bluetoothd[8900]: Current Time Service could not be registered
Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output error (5)

見るべき行は次のとおりです。

行意味
先頭の記号状態を色と形で表す。緑の ● は active、白の ○ は inactive、赤の × は failed
Loaded:ユニットファイルを読み込めたか(loaded、not-found、bad-setting、masked など)、ファイルの場所、自動起動の設定(enabled など)
Active:今の状態(active、inactive、activating、failed など)と、その状態になった時刻
Main PID:サービスのメインプロセスのPID
CGroup:このサービスに属するプロセスの一覧
末尾のログジャーナルから取った直近のログ。既定で10行(-n で行数を変えられる)

行が画面幅で省略されて読めないときは、systemctl status -l sample-app(--full)で省略せずに表示できます。

起動・停止・再起動

コマンド動き
startユニットを起動する
stopユニットを停止する
restart停止してから起動する。動いていなければ起動だけする
try-restart動いている時だけ再起動する。止まっていれば何もしない
reloadサービス自身の設定ファイルを読み直させる(対応しているサービスのみ)
reload-or-restartreloadに対応していればreload、そうでなければrestartする
is-active動いていれば終了コード0を返す。スクリプトでの判定に使う
is-failedfailed状態なら終了コード0を返す

reload と daemon-reload は名前が似ていますが別物です。systemctl(1)はApacheを例に、reload はWebサーバーの httpd.conf を読み直させるもので、apache.service のユニットファイルを読み直すものではない、と説明しています。ユニットファイル自体を読み直させるのは daemon-reload です。

自動起動の設定: enableとdisable

サーバーの起動時にサービスも起動させるには enable を使います。

自動起動の設定
# 自動起動を有効にする(この時点では起動しない)
sudo systemctl enable sample-app
 
# 自動起動を有効にし、今すぐ起動もする
sudo systemctl enable --now sample-app
 
# 自動起動を無効にし、今すぐ停止もする
sudo systemctl disable --now sample-app
 
# 自動起動の設定を確認する
systemctl is-enabled sample-app

systemctl(1)によると、enable はユニットファイルの [Install] セクションに書かれた内容に従ってシンボリックリンクを作り、そのあとdaemon-reload相当の読み直しをします。ただし、enableしただけではユニットは起動しません。今すぐ動かしたいときは --now を付けるか、別に start を実行します。

is-enabled は主に次の値を返します。

値意味
enabled有効(.wants/ などへのシンボリックリンクがある)
disabled無効。ただし [Install] セクションがあるので、enableできる
static無効で、[Install] セクションも無い。他のユニットから依存として起動される前提のもの
maskedマスクされていて、どんな方法でも起動できない(後述)

一覧を見る

コマンド表示されるもの
systemctl list-unitssystemdがメモリに読み込んでいるユニット。既定では動いているもの、ジョブ待ちのもの、失敗したものだけ
systemctl list-units --all読み込まれているユニットをすべて
systemctl list-units --type=serviceサービスだけ
systemctl list-unit-filesインストールされているユニットファイルと、その自動起動の設定(is-enabledと同じ値)
systemctl --failedfailed状態のユニット(--state=failed と同じ)
systemctl list-timersタイマーと、次に動く時刻
systemctl cat sample-appユニットファイルと、上書き用のドロップインの中身

list-units は「今メモリにあるユニット」、list-unit-files は「ディスク上にあるユニットファイル」という違いがあります。一度も起動されていないユニットは list-units には出てこないことがあります。

maskで起動そのものを禁止する

disable は自動起動をやめるだけで、手動の start や、他のユニットからの依存による起動は止められません。完全に起動させたくないときは mask を使います。

mask と unmask
# 起動できないようにする(--now で今動いているものも止める)
sudo systemctl mask --now sample-app
 
# 元に戻す
sudo systemctl unmask sample-app

systemctl(1)によると、mask はユニットファイルを /dev/null へリンクし、enableや手動の起動を含め、あらゆる起動をできなくします。/etc/systemd/system/ にユニット名のシンボリックリンクを作る仕組みなので、同じ名前のユニットファイルがすでに /etc/systemd/system/ にあると失敗します。manページも、maskは主にパッケージが /usr/lib/systemd/system/ に入れたユニット向けで、自分で /etc/systemd/system/ に作ったユニットには通常使えない、と説明しています。自作のユニットを止めたいだけなら、disable --now で十分です。

ユニットファイルの置き場所と優先順位

ユニットファイルは決まったディレクトリから読み込まれます。systemd.unit(5)の表から、システムのサービスでよく関わるものを抜き出すと次のとおりです(実際にはこのほかに、systemd自身が生成する設定用のディレクトリもあります)。

ディレクトリ用途優先度
/etc/systemd/system管理者が作ったユニット高い
/run/systemd/system実行時のユニット(再起動で消える)中
/usr/local/lib/systemd/system管理者がインストールしたユニット中
/usr/lib/systemd/systemディストリビューションのパッケージが入れたユニット低い

systemd.unit(5)には、表の上にあるディレクトリのファイルが、下にあるディレクトリの同じ名前のファイルより優先される、と書かれています。パッケージで入れたサービスは /usr/lib/systemd/system にあり、それを丸ごと差し替えたいときは同じ名前のファイルを /etc/systemd/system に置く、という関係です。

ただし、/usr/lib/systemd/system のファイルを直接書き換えるのはやめましょう。パッケージを更新したときに上書きされます。自作のサービスは /etc/systemd/system に置き、パッケージのサービスの設定を変えたいときは後述の systemctl edit を使います。

自作サービスのユニットファイルを書く

ユニットファイルの例

Node.jsのアプリ /opt/sample-app/server.js を、専用ユーザー sample-app で常駐させる例です。ファイルは /etc/systemd/system/sample-app.service に置きます。

/etc/systemd/system/sample-app.service
[Unit]
Description=Sample App (Node.js API server)
Documentation=https://example.com/sample-app
Wants=network-online.target
After=network-online.target
 
[Service]
Type=exec
User=sample-app
Group=sample-app
WorkingDirectory=/opt/sample-app
Environment=NODE_ENV=production
Environment=PORT=3000
EnvironmentFile=/etc/sample-app/sample-app.env
ExecStart=/usr/bin/node /opt/sample-app/server.js
Restart=on-failure
RestartSec=5
 
[Install]
WantedBy=multi-user.target

ユニットファイルは、[Unit]、[Service]、[Install] の3つのセクションでできています。

[Unit]セクション: 説明と依存関係

項目意味
Description=ユニットの短い説明。systemctl status の1行目などに表示される。ユニット名の繰り返しではなく、何のユニットかが分かる名前にする
Documentation=ドキュメントのURL(任意)
Wants=一緒に起動してほしいユニット(弱い依存)。相手が失敗しても自分は起動する
Requires=必須のユニット(強い依存)
After=起動の順番。指定したユニットの起動が終わってから自分を起動する

ここで覚えておきたいのは、依存(Wants=、Requires=)と順番(After=、Before=)は別の設定だということです。systemd(1)にも、依存と順番は直交していると書かれています。Wants= だけを書くと、2つのユニットは同時に起動される可能性があります。「起動してほしい、しかも先に」という場合は、例のように両方を書きます。

network-online.target は、ネットワークの設定が終わるまで待つためのターゲットです。systemd.special(7)は、ネットワーク接続が本当に必要なユニットは、このターゲットを Wants= で引き込み、After= で後ろに並ぶように、と説明しています。起動時に外部のデータベースへ接続するアプリなどが該当します。どこまで待つかは、ネットワークを管理するサービスの実装によって決まります。

[Service]セクション: 何をどう動かすか

項目意味
Type=起動完了をどう判断するか(次の章で説明)
User= / Group=プロセスを動かすユーザーとグループ。システムのサービスでは、指定しなければroot
WorkingDirectory=作業ディレクトリ。指定しなければ /(システムのサービスの場合)
Environment=環境変数を1つずつ設定する。何行でも書ける
EnvironmentFile=環境変数をファイルから読み込む
ExecStart=起動するコマンド
Restart=プロセスが終了したときに再起動するかどうか
RestartSec=再起動までの待ち時間。既定は100ms

User= を指定しないとアプリがrootで動きます。Webアプリのように外部から入力を受け取るものは、専用のユーザーを作って権限を絞るのが基本です。ファイルの所有者や権限の考え方はLinuxパーミッションの仕組みにまとめています。

EnvironmentFile= で読むファイルは、1行に1つ KEY=VALUE を書きます。systemd.exec(5)によると、空行や #、; で始まる行は無視されます。同じ変数が Environment= とファイルの両方にあると、ファイルの方が優先されます。

/etc/sample-app/sample-app.env
# データベースの接続先などの秘密情報
DATABASE_URL=postgres://sample_user:change-me@127.0.0.1:5432/sample_db
API_KEY=dummy-api-key

パスワードやAPIキーを Environment= でユニットファイルに直接書くのは避けます。ユニットファイル自体は一般ユーザーでも読めることが多いうえ、systemd.exec(5)は、ユニットに設定した環境変数はD-Bus経由で権限の無いクライアントからも見えると注意しています。別ファイルにする場合も、所有者をroot、権限を600のように絞っておきます。なお、systemd.exec(5)は、環境変数は子プロセスへ引き継がれて漏れやすいため秘密情報の受け渡しには向かないとし、代わりに LoadCredential= を勧めています。LoadCredential= で渡したデータは、User= のユーザー(とroot)だけが読める読み取り専用のディレクトリに置かれ、その場所は環境変数 CREDENTIALS_DIRECTORY で渡されます。アプリ側をこの方式に合わせられるなら、そちらの方が安全です。

EnvironmentFile= のファイルが無いとサービスは起動に失敗しますが、パスの先頭に - を付ける(EnvironmentFile=-/etc/sample-app/sample-app.env)と、ファイルが無くてもエラーになりません。環境変数で設定や秘密情報を渡す考え方は環境変数と.envによる設定と秘密情報の管理で扱っています。

[Install]セクション: enableしたときの登録先

項目意味
WantedBy=systemctl enable したときに、どのターゲットから起動されるようにするか

WantedBy=multi-user.target と書いておくと、enable したときに multi-user.target.wants/ にシンボリックリンクが作られ、サーバーの通常の起動(multi-user.target)でこのサービスも起動されるようになります。systemd.special(7)も、通常のサービスは default.target ではなく multi-user.target などの普通のターゲットを WantedBy= に指定するよう勧めています。[Install] セクションが無いユニットはenableできず、is-enabled は static を返します。

登録して起動する手順

ユニットファイルを置いたら、次の順に実行します。

サービスの登録と起動
# 新しいユニットファイルをsystemdに読み込ませる
sudo systemctl daemon-reload
 
# 自動起動を有効にして、今すぐ起動する
sudo systemctl enable --now sample-app
 
# 状態とログを確認する
systemctl status sample-app
journalctl -u sample-app -f

enable は内部で読み直しもするので、新規作成の時は daemon-reload を省いても動きます。ただ、あとでユニットファイルを編集したときには daemon-reload が必要になるので、「ユニットファイルを触ったら daemon-reload」と覚えておくのが安全です。

ExecStart=はシェルではない

ExecStart= は、見た目はシェルのコマンドラインに似ていますが、シェルを通さずに実行されます。systemd.service(5)には次のことが書かれています。

  • 最初の要素(実行するプログラム)は、絶対パスか、スラッシュを含まないコマンド名のどちらかでなければならない
  • コマンド名だけを書いた場合は、コンパイル時に決まった固定の検索パス(/usr/local/bin/、/usr/bin/ など)から探される。それ以外の場所にあるプログラムは絶対パスで書く必要がある
  • > や >> によるリダイレクト、| によるパイプ、& によるバックグラウンド実行など、シェルの構文は使えない
  • 環境変数は ${FOO} の形で展開できるが、シェルの展開とは規則が違う
  • Type=oneshot 以外では、ExecStart= は1つだけ書ける

nvmなどで入れたNode.jsは /usr/bin 以外の場所にあることが多いので、command -v node で実際のパスを確かめて、絶対パスで書きます。パイプやリダイレクトを使いたいときは、シェルスクリプトにまとめてそれを ExecStart= で呼ぶか、ExecStart=/bin/sh -c '...' のようにシェルを明示して起動します。

停止のときに送られるシグナル

systemctl stop を実行すると、systemdはサービスのプロセスにシグナルを送って止めます。systemd.service(5)とsystemd.kill(5)によると、流れは次のとおりです。

  1. ExecStop= が書かれていれば、それを実行する
  2. KillSignal=(既定はSIGTERM)をプロセスに送る
  3. TimeoutStopSec= の時間が過ぎても終わらなければ、SIGKILLで強制終了する

KillMode= の既定は control-group で、メインのプロセスだけでなく、サービスのcgroupに残っているプロセスすべてが対象になります。アプリ側でSIGTERMを受け取って処理中のリクエストを片付けてから終了する(graceful shutdown)ようにしておくと、停止や再起動のたびにリクエストが途中で切られるのを防げます。シグナルの受け取り方はUNIXシグナルとプロセスのライフサイクルで解説しています。

Type=の違い

Type= は、systemdが「このサービスの起動が完了した」とみなすタイミングを決める設定です。後続のユニットをいつ起動するか、systemctl start がいつ戻ってくるかに影響します。systemd.service(5)をもとにまとめます。

値起動完了とみなすタイミング向いているもの
simpleメインプロセスをfork()した直後(プログラムを実行する前)ExecStart= を書いて Type= を省略したときの既定
execfork()に続いて、プログラムの実行(execve())が成功した時点フォアグラウンドで動き続ける一般的なアプリ。manページは多くの場合simpleよりこちらを勧めている
forking起動したプロセスがfork()して、親プロセスが終了した時点自分でデーモン化する昔ながらのサービス。PIDFile= の併用が勧められている。manページは使用を勧めていない
oneshotメインプロセスが終了した時点1回実行して終わる処理(初期化、バックアップなど)。Type= も ExecStart= も無いときの既定
notifyサービスが sd_notify() で READY=1 を送ってきた時点systemdへの通知に対応したサービス

simple と exec の違いは分かりにくいところです。simple はプログラムを実行する前に「起動した」とみなすので、User= に存在しないユーザーを書いた場合や、ExecStart= のプログラムが見つからない場合でも、systemctl start は成功を返してしまいます。exec ならこうした失敗を systemctl start の時点で報告します。manページも、長く動き続けるサービスには Type=exec を勧めています。ただし exec が分かるのは「プログラムの実行に成功した」ところまでで、アプリの初期化(ポートを開くなど)が終わったかどうかまでは分かりません。そこまで待ちたい場合は、アプリ側で notify に対応させます。

oneshot は、RemainAfterExit=yes を付けないと、処理が終わったあとは「起動中」ではなく停止した状態として表示されます。設定を1回だけ流し込むような処理で「済んだ」状態を残したいときは RemainAfterExit=yes を付けます。

このほか、D-Busの名前を取得したら起動完了とする dbus、notify に加えてreloadの時にSIGHUPを送る notify-reload などもあります。

Restart=で落ちたときに自動で再起動する

Restart= は、サービスのプロセスが終了したり、タイムアウトしたりしたときに再起動するかを決めます。既定は no(再起動しない)です。systemctl stop などsystemd自身の操作で止めた場合は、どの設定でも再起動されません。

値再起動する条件
no再起動しない(既定)
on-success正常に終了したときだけ
on-failure0以外の終了コード、シグナルによる異常終了、タイムアウト、ウォッチドッグのタイムアウト
on-abnormalシグナルによる異常終了、タイムアウト、ウォッチドッグのタイムアウト(終了コードが0以外なだけでは再起動しない)
on-abort正常終了扱いでないシグナルで終了したときだけ
on-watchdogウォッチドッグのタイムアウトのときだけ
always終了の理由にかかわらず再起動する

ここでの「正常な終了」は、終了コード0のほか、oneshot 以外ではSIGHUP、SIGINT、SIGTERM、SIGPIPEのシグナルによる終了も含みます。systemd.service(5)は、長く動き続けるサービスには on-failure を勧めています。

再起動には回数の制限があります。systemd.unit(5)の StartLimitIntervalSec= と StartLimitBurst= で、「一定時間のうちに何回まで起動してよいか」を決めます(既定値はsystemdのマネージャー設定で決まります)。設定ミスで起動直後に落ちるサービスは、この上限に達すると再起動されなくなり、failedのまま止まります。原因を直したあと、sudo systemctl reset-failed sample-app で回数をリセットしてから起動し直します。RestartSec= で再起動までの間隔を空けておくと、上限に一気に達するのを避けやすくなります。

systemctl editでドロップインを使って上書きする

override.confを作る

パッケージで入れたサービスの設定を少し変えたいとき、/usr/lib/systemd/system のファイルを直接編集すると、パッケージの更新で元に戻ってしまいます。そこで使うのがドロップインです。

systemd.unit(5)によると、foo.service というユニットに対して foo.service.d/ というディレクトリを作り、そこに .conf で終わるファイルを置くと、本体のユニットファイルを読んだあとにその内容が重ねて読み込まれます。/etc/ に置いたドロップインは、本体のユニットファイルがどこにあっても、それより優先されます。

このファイルを手で作る代わりに、systemctl edit を使うのが簡単です。

ドロップインの作成
sudo systemctl edit sample-app

エディタが開くので、変えたい設定だけを、セクション名と一緒に書いて保存します。

/etc/systemd/system/sample-app.service.d/override.conf
[Service]
Environment=NODE_ENV=staging
RestartSec=10

systemctl(1)によると、systemctl edit は既定で override.conf というドロップインを作成または編集し、エディタを閉じると自動でdaemon-reload相当の読み直しをします。設定を反映させるには、続けて sudo systemctl restart sample-app でサービスを再起動します。

関連するオプションは次のとおりです。

コマンド動き
systemctl edit sample-appドロップイン(override.conf)を作成・編集する
systemctl edit --full sample-appユニットファイル全体のコピーを作って編集する
systemctl edit --drop-in=10-env sample-appoverride.conf 以外の名前でドロップインを作る
systemctl cat sample-app本体とドロップインをまとめて表示する
systemctl revert sample-appドロップインや上書き用のファイルを消して、パッケージの状態に戻す

エディタは環境変数 SYSTEMD_EDITOR、EDITOR、VISUAL の順に使われます。どれも無ければ editor、nano、vim、vi の順に試されます。

複数書ける設定は、いったん空にしてから書く

ドロップインで注意が必要なのは、ExecStart= や Environment= のように複数回書ける設定です。ドロップインに ExecStart= を書くと、元の値を置き換えるのではなく、追加しようとします。Type=oneshot 以外では ExecStart= は1つしか書けないので、そのままではエラーになります。

置き換えたいときは、空の ExecStart= で一度リセットしてから、新しい値を書きます。systemd.service(5)には、ExecStart= に空文字列を指定すると、それまでのコマンドのリストがリセットされると書かれています。

ExecStart= を置き換えるドロップイン
[Service]
ExecStart=
ExecStart=/usr/bin/node --max-old-space-size=512 /opt/sample-app/server.js

daemon-reloadが必要な場面

daemon-reload は、systemdにユニットファイルを読み直させ、依存関係を組み立て直させるコマンドです。必要になるのは次のような場面です。

場面daemon-reload
ユニットファイルやドロップインを手で作成・編集・削除した必要
systemctl edit で編集した不要(自動で読み直す)
systemctl enable / disable / mask / unmask を実行した不要(自動で読み直す)
アプリ自身の設定ファイルを変えた不要。reload か restart を使う

読み直しを忘れると、ディスク上のファイルとsystemdが覚えている設定が食い違います。systemctl(1)によると、systemctl cat はディスク上のファイルを表示するので、daemon-reloadをしていないと、表示とsystemdの実際の設定が一致しないことがあります。また daemon-reload はユニットの設定を読み直すだけで、動いているサービスは再起動されません。変更をサービスに反映させるには、続けて restart が必要です。

journalctlでログを見る

よく使うオプション

journalctl(1)から、よく使うオプションをまとめます。

オプション意味例
-u指定したユニットのログだけを表示するjournalctl -u sample-app
-f最新のログを表示し、新しいログを流し続ける(Ctrl-Cで終了)journalctl -u sample-app -f
-n最新のN件だけ表示する(数値を省くと10件)journalctl -u sample-app -n 50
-b今回の起動以降のログ。-b -1 で前回の起動journalctl -b -1 -u sample-app
--list-boots記録されている起動の一覧journalctl --list-boots
--since / --until時刻で絞り込むjournalctl --since "2026-11-17 09:00" --until "2026-11-17 10:00"
-p優先度で絞り込むjournalctl -p err -b
-gメッセージを正規表現で絞り込むjournalctl -u sample-app -g "timeout"
-o出力形式を変えるjournalctl -u sample-app -o short-iso
-r新しい順に表示するjournalctl -u sample-app -r
-x説明文(メッセージカタログ)を付けて表示するjournalctl -xu sample-app
-eページャーで末尾から表示するjournalctl -eu sample-app
-kカーネルのメッセージだけ(dmesg相当)journalctl -k -b
--no-pagerページャーを使わずに出力するjournalctl -u sample-app --no-pager
--user-unitユーザーサービスのログjournalctl --user-unit sample-app

--since には "2026-11-17 09:00:00" のような日時のほか、today、yesterday、"30min ago"、-1h のような相対的な指定も使えます(書き方はsystemd.time(7))。

-o の出力形式は、既定の short(従来のsyslogに近い1行形式)のほか、タイムスタンプをISO 8601形式にする short-iso、メッセージだけを出す cat、JSONを見やすく整形する json-pretty などがあります。ログを他のツールに渡すときは -o json が便利です。

優先度(-p)で絞り込む

-p には、syslogと同じ8段階の優先度を指定します。

番号名前番号名前
0emerg4warning
1alert5notice
2crit6info
3err7debug

1つだけ指定すると、その優先度と、それより重要な(番号が小さい)ログが表示されます。-p err なら0から3までです。-p 2..4(crit、err、warning)のように範囲で指定することもできます。

前回起動のログを見る

サーバーが再起動したあとに「再起動の前に何が起きていたか」を調べるには journalctl -b -1 を使います。ただし、ジャーナルがメモリ上(/run/log/journal)にしか保存されていない設定では、再起動するとログが消えるので、前回の起動のログは見られません。

保存先はjournald.conf(5)の Storage= で決まります。auto の場合は /var/log/journal ディレクトリがあればディスクに保存され、無ければメモリだけになります。最新のmanページでは既定値は persistent(ディスクに保存)ですが、この値はビルド時に決まるため、ディストリビューションによって違う可能性があります。journalctl --list-boots で過去の起動が並んでいれば、ディスクに残っています。

ログを読める人と容量

journalctl(1)によると、システムのジャーナルを読めるのは、既定ではrootと、systemd-journal、adm、wheel グループのメンバーです。一般ユーザーで journalctl -u を実行して何も出ないときは、sudo を付けるか、グループへの追加を検討します。

ジャーナルが使っているディスク容量は journalctl --disk-usage で確認できます。古いログを消すには sudo journalctl --vacuum-time=2weeks や sudo journalctl --vacuum-size=500M を使います。消えるのはアーカイブ済みのジャーナルファイルで、今書き込み中のファイルは対象外です。

サービスが起動しない時の調べ方

起動しないサービスは、次の順に確かめると原因に早くたどり着けます。

1. statusのLoaded行とActive行を見る

systemctl status sample-app

Loaded: が not-found ならユニットファイルが見つかっていません(ファイル名の誤り、置き場所の誤り、daemon-reloadのし忘れ)。bad-setting ならユニットファイルの必須の設定が解釈できていません。masked ならmaskされています。

Active: が failed のときは、カッコの中に結果が出ます。次の出力は形を示すための例です。

起動に失敗したときの status の例(イメージ)
× sample-app.service - Sample App (Node.js API server)
     Loaded: loaded (/etc/systemd/system/sample-app.service; enabled; preset: enabled)
     Active: failed (Result: exit-code) since Tue 2026-11-17 09:12:03 JST; 5s ago
    Process: 12345 ExecStart=/usr/bin/node /opt/sample-app/server.js (code=exited, status=203/EXEC)
   Main PID: 12345 (code=exited, status=203/EXEC)

Result: に出る値は、systemd.exec(5)の $SERVICE_RESULT の表に定義されています。

値意味
exit-code0以外の終了コードで終了した
signalシグナルで異常終了した
core-dumpシグナルで異常終了し、コアダンプを出した
timeout起動や停止などの処理がタイムアウトした
watchdogウォッチドッグの期限に間に合わなかった
oom-killメモリ不足でOOM killerに終了させられた
protocolType= で決めた手順をサービスが守らなかった(notify なのに通知が来ない、など)

2. 終了コードから当たりをつける

status=203/EXEC のような200番台の終了コードは、アプリではなくsystemdが「プログラムを実行する前の準備」で失敗したことを表します。systemd.exec(5)の表から、よく見るものを挙げます。

コード名前意味と確かめること
200CHDIR作業ディレクトリに移動できなかった。WorkingDirectory= のパスと権限
203EXECプログラムを実行できなかった(execve()の失敗)。ExecStart= のパスの誤り、ファイルが無い、実行権限が無い
209STDOUT標準出力の準備に失敗した。StandardOutput= の設定
217USERユーザーの切り替えに失敗した。User= に書いたユーザーが存在するか

200番台ではない小さい数字(1など)の場合は、多くはアプリ自身がエラーで終了したときの終了コードです。この場合はアプリのログを読みます。

3. journalctl -xeuで直前のログを見る

sudo journalctl -xeu sample-app

-x(説明文を付ける)、-e(末尾へ移動する)、-u(ユニットで絞る)をまとめた書き方です。-e を付けると、特に指定しなければ今回の起動の最新1000件に絞られます。アプリが出したエラーメッセージ(ポートが使用中、設定ファイルが読めない、など)はここに出ます。なお、journalctl(1)は、バグ報告にログを貼るときは -x を付けないよう注意しています。

4. ターミナルとsystemdでは環境が違う

「ターミナルで実行すると動くのに、systemdだと動かない」ときに一番多い原因が、環境の違いです。cronで起きる問題と同じ構図です(crontabの書き方入門の実行環境の章も参照)。

  • systemd.exec(5)によると、システムのサービスは PATH に固定の値 /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin が使われる。~/.bashrc などで足したパス(nvmやpyenvのディレクトリなど)は入らない
  • ログインシェルの設定ファイル(~/.bashrc、~/.profile など)は読まれないので、そこで設定した環境変数はサービスには渡らない。必要な変数は Environment= か EnvironmentFile= で渡す
  • WorkingDirectory= を指定しないと、作業ディレクトリは / になる。相対パスで設定ファイルを読むアプリは、ファイルが見つからずに失敗する
  • User= を指定すると、ホームディレクトリなどはそのユーザーのものになる。ターミナルで試したユーザーと違えば、読めるファイルも違う

Environment= で設定した値は、systemctl show sample-app -p Environment で確かめられます(EnvironmentFile= で読んだ値は、ファイルを直接確認します)。

5. 権限を確かめる

User= で指定したユーザーで、プログラムや設定ファイル、書き込み先のディレクトリにアクセスできるかを確かめます。sudo -u sample-app を使うと、そのユーザーとして同じコマンドを試せます。

サービスのユーザーで試す
sudo -u sample-app /usr/bin/node /opt/sample-app/server.js
sudo -u sample-app ls -l /opt/sample-app

ただし、これは環境変数や作業ディレクトリまでは再現しません。4.の違いも合わせて考えます。

6. systemd-analyze verifyでユニットファイルを検査する

systemd-analyze verify /etc/systemd/system/sample-app.service

systemd-analyze(1)によると、verify はユニットファイルを読み込み、エラーがあれば警告を表示します。指定したファイルから参照されている他のユニットも読み込まれます。項目名の打ち間違いや、存在しないプログラムの指定などを、起動する前に見つけられます。

7. 再起動の上限に達していないか

Restart= を設定したサービスが何度も落ちていると、前述の起動回数の上限に達して止まります。この状態では、原因を直しても start が拒否されることがあります。直したあとに sudo systemctl reset-failed sample-app を実行してから起動します。

systemdタイマーで定期実行する

systemdにはcronのような定期実行の仕組みもあります。タイマーユニット(.timer)が、決まった時刻に同じ名前のサービスユニットを起動します。毎日4時30分にバックアップを取る例です。

/etc/systemd/system/sample-backup.service
[Unit]
Description=Sample backup job
 
[Service]
Type=oneshot
User=sample-app
ExecStart=/usr/local/bin/sample-backup.sh
/etc/systemd/system/sample-backup.timer
[Unit]
Description=Run sample backup daily at 04:30
 
[Timer]
OnCalendar=*-*-* 04:30:00
Persistent=true
 
[Install]
WantedBy=timers.target
タイマーを有効にする
sudo systemctl daemon-reload
sudo systemctl enable --now sample-backup.timer
systemctl list-timers sample-backup.timer

enableするのはサービスではなくタイマーの方です。systemd.timer(5)によると、Unit= を書かなければ、タイマーと同じ名前(拡張子だけ違う)のサービスが起動されます。主な設定は次のとおりです。

設定意味
OnCalendar=カレンダーの時刻で指定する(*-*-* 04:30:00、Mon..Fri *-*-* 09:00:00、daily など)
OnBootSec=起動からの経過時間で指定する(OnBootSec=5min など)
OnUnitActiveSec=前回サービスが起動してからの経過時間で指定する
Persistent=true にすると、電源が切れていて実行できなかった分を、次にタイマーが動いた時にすぐ実行する(OnCalendar= にのみ有効。既定は false)
RandomizedDelaySec=実行時刻を0から指定した時間の間でランダムにずらす
AccuracySec=実行時刻の精度。既定は1分で、その範囲で実行時刻がまとめられる

OnCalendar= の書き方は、systemd-analyze calendar "Mon..Fri *-*-* 09:00:00" で次に動く時刻を確かめられます。cronとの違い(書きやすさ、ログ、電源オフの間の扱い)は、crontabの書き方入門の「systemd timerとの違い」で比較しています。

ユーザーサービス(--user)

root権限を持たない一般ユーザーでも、自分専用のsystemd(ユーザーマネージャー)にサービスを登録できます。ユニットファイルは ~/.config/systemd/user/ に置き、systemctl と journalctl に --user を付けて操作します。

ユーザーサービスの操作
mkdir -p ~/.config/systemd/user
# ~/.config/systemd/user/sample-app.service を作成する
systemctl --user daemon-reload
systemctl --user enable --now sample-app
systemctl --user status sample-app
journalctl --user-unit sample-app

ユーザーサービスの [Install] には、WantedBy=default.target を書きます。systemd.special(7)によると、ユーザーマネージャーでは default.target が中心のターゲットで、システムの multi-user.target に当たります。また、ユーザーサービスでは User= で別のユーザーに切り替えることはできません。

注意点は、ユーザーマネージャーが「ログインしている間だけ」動くことです。ログアウトするとユーザーサービスも止まり、サーバーを再起動してもログインするまで起動しません。ログインしていなくても動かしたいときは、loginctl(1)の enable-linger を使います。

sudo loginctl enable-linger sample-user

これで、起動時にそのユーザーのマネージャーが起動され、ログアウトしたあとも残るようになります。SSHでログインして作業するサーバーでは、ログアウトでサービスが止まって困ることがあるので覚えておくと便利です。

macOSはsystemdではなくlaunchd

macOSにはsystemdも systemctl もありません。macOSで同じ役割を担っているのはlaunchdで、ジョブはplistファイルで定義し、launchctl で操作します。Macでアプリを常駐させたり定期実行したりしたい場合は、macOS launchctlの基本を参照してください。

まとめ

  • systemdはPID 1として動くinitで、サービスやタイマーなどを「ユニット」として管理する。操作は systemctl、ログは journalctl で見る
  • 自動起動は enable、今すぐの起動は start。両方まとめるなら enable --now。完全に起動させないなら mask
  • 自作のユニットファイルは /etc/systemd/system に置く。/usr/lib/systemd/system のファイルは直接編集しない
  • 常駐アプリは Type=exec、User= で専用ユーザー、Restart=on-failure を基本にする。ExecStart= はシェルを通らないので、パイプやリダイレクトは使えず、標準の場所以外のプログラムは絶対パスで書く
  • パッケージのサービスの設定変更は systemctl edit のドロップインで行う。ExecStart= を置き換えるときは空の ExecStart= で一度リセットする
  • ユニットファイルを手で編集したら daemon-reload、サービスに反映させるには restart
  • 起動しないときは、status の Loaded: と Active:、終了コード(200番台はsystemd側の準備の失敗)、journalctl -xeu、環境変数とPATHの違い、権限、systemd-analyze verify の順に確かめる

参考資料

crontabの書き方入門 - cronの5つのフィールドと、動かないときに見る実行環境・ログ・二重起動

crontabの書き方入門 - cronの5つのフィールドと、動かないときに見る実行環境・ログ・二重起動

約26分

crontabは「分 時 日 月 曜日 コマンド」の1行で、決まった時刻にコマンドを動かす設定ファイルです。5つのフィールドと特殊文字(* , - /)の読み方、日と曜日を両方指定したときのOR条件、@dailyなどの短縮表記、crontab -eと/etc/cron.dの違い、PATHや%の落とし穴、タイムゾーン、ログの見方、flockによる二重起動の防止、systemd timerやGitHub Actionsのscheduleとの違いを、crontab(5)などのmanページを一次ソースに、cron式を試せるデモ付きで整理します。

Linuxコンテナの仕組み入門 - namespaceとcgroupsから理解するDocker

Linuxコンテナの仕組み入門 - namespaceとcgroupsから理解するDocker

約48分

コンテナは軽量な仮想マシンではありません。Linuxカーネルのnamespace・cgroups・capabilities・seccomp・overlayfsという既存機能を組み合わせた「普通のプロセス」です。man7.orgのmanページ、kernel.orgのcgroup-v2ドキュメント、OCI仕様、Docker公式ドキュメントを一次ソースに、8種類のnamespaceの役割、cgroup v1とv2の違い、unshareやlsnsで手を動かす確認手順、runcとcontainerdの関係、そしてコンテナがセキュリティ境界として弱い理由までを積み上げて整理します。

SSH の仕組み - 鍵交換・ホスト鍵検証・公開鍵認証を一次ソースで理解する

SSH の仕組み - 鍵交換・ホスト鍵検証・公開鍵認証を一次ソースで理解する

約18分

リモートサーバー運用の土台である SSH プロトコルを、一次ソースの RFC 4251/4252/4253/4254(SSH-2 の Architecture / Authentication / Transport / Connection)を軸に整理します。TCP 接続からバージョン交換、KEXINIT による鍵交換と Diffie-Hellman、ホスト鍵の検証(known_hosts と TOFU の弱点)、公開鍵認証(authorized_keys と署名)、チャネルの多重化とポートフォワーディング(ssh -L / -R / -D)まで、その仕組みと OpenSSH での確認方法をインフラ担当者・開発者向けにまとめます。

楽天市場のおすすめPR / 楽天アフィリエイト