
systemctl と systemd の使い方 - サービスの自動起動・ユニットファイル・ログ確認の基本
当サイトは 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やメモリ)を管理する |
| スコープ | .scope | systemdが起動したのではない外部のプロセスをまとめて管理する |
スライスやスコープの資源管理には、Linuxカーネルのcgroupが使われています。cgroupそのものの仕組みはLinuxコンテナの仕組み入門を参照してください。
systemctlとjournalctlの関係
systemdまわりでよく使うコマンドは2つです。
| コマンド | 相手 | 役割 |
|---|---|---|
systemctl | systemd(サービスマネージャー) | ユニットの起動・停止・自動起動の設定、状態の確認 |
journalctl | systemd-journald(ログを集めるサービス) | ジャーナル(systemdのログ)を検索して表示する |
サービスが標準出力や標準エラー出力に書いた内容は、既定でジャーナルに送られます(systemd.exec(5)の StandardOutput= の既定値は、マネージャー設定の DefaultStandardOutput= で、その既定は journal)。そのため、アプリ側でログファイルを用意しなくても、console.log や print の出力を journalctl で読めます。systemctl status の末尾にも、このジャーナルから直近のログが表示されます。
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-restart | reloadに対応していればreload、そうでなければrestartする |
is-active | 動いていれば終了コード0を返す。スクリプトでの判定に使う |
is-failed | failed状態なら終了コード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-appsystemctl(1)によると、enable はユニットファイルの [Install] セクションに書かれた内容に従ってシンボリックリンクを作り、そのあとdaemon-reload相当の読み直しをします。ただし、enableしただけではユニットは起動しません。今すぐ動かしたいときは --now を付けるか、別に start を実行します。
is-enabled は主に次の値を返します。
| 値 | 意味 |
|---|---|
enabled | 有効(.wants/ などへのシンボリックリンクがある) |
disabled | 無効。ただし [Install] セクションがあるので、enableできる |
static | 無効で、[Install] セクションも無い。他のユニットから依存として起動される前提のもの |
masked | マスクされていて、どんな方法でも起動できない(後述) |
一覧を見る
| コマンド | 表示されるもの |
|---|---|
systemctl list-units | systemdがメモリに読み込んでいるユニット。既定では動いているもの、ジョブ待ちのもの、失敗したものだけ |
systemctl list-units --all | 読み込まれているユニットをすべて |
systemctl list-units --type=service | サービスだけ |
systemctl list-unit-files | インストールされているユニットファイルと、その自動起動の設定(is-enabledと同じ値) |
systemctl --failed | failed状態のユニット(--state=failed と同じ) |
systemctl list-timers | タイマーと、次に動く時刻 |
systemctl cat sample-app | ユニットファイルと、上書き用のドロップインの中身 |
list-units は「今メモリにあるユニット」、list-unit-files は「ディスク上にあるユニットファイル」という違いがあります。一度も起動されていないユニットは list-units には出てこないことがあります。
maskで起動そのものを禁止する
disable は自動起動をやめるだけで、手動の start や、他のユニットからの依存による起動は止められません。完全に起動させたくないときは mask を使います。
# 起動できないようにする(--now で今動いているものも止める)
sudo systemctl mask --now sample-app
# 元に戻す
sudo systemctl unmask sample-appsystemctl(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 に置きます。
[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= とファイルの両方にあると、ファイルの方が優先されます。
# データベースの接続先などの秘密情報
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 -fenable は内部で読み直しもするので、新規作成の時は 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)によると、流れは次のとおりです。
ExecStop=が書かれていれば、それを実行するKillSignal=(既定はSIGTERM)をプロセスに送るTimeoutStopSec=の時間が過ぎても終わらなければ、SIGKILLで強制終了する
KillMode= の既定は control-group で、メインのプロセスだけでなく、サービスのcgroupに残っているプロセスすべてが対象になります。アプリ側でSIGTERMを受け取って処理中のリクエストを片付けてから終了する(graceful shutdown)ようにしておくと、停止や再起動のたびにリクエストが途中で切られるのを防げます。シグナルの受け取り方はUNIXシグナルとプロセスのライフサイクルで解説しています。
Type=の違い
Type= は、systemdが「このサービスの起動が完了した」とみなすタイミングを決める設定です。後続のユニットをいつ起動するか、systemctl start がいつ戻ってくるかに影響します。systemd.service(5)をもとにまとめます。
| 値 | 起動完了とみなすタイミング | 向いているもの |
|---|---|---|
simple | メインプロセスをfork()した直後(プログラムを実行する前) | ExecStart= を書いて Type= を省略したときの既定 |
exec | fork()に続いて、プログラムの実行(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-failure | 0以外の終了コード、シグナルによる異常終了、タイムアウト、ウォッチドッグのタイムアウト |
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エディタが開くので、変えたい設定だけを、セクション名と一緒に書いて保存します。
[Service]
Environment=NODE_ENV=staging
RestartSec=10systemctl(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-app | override.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= に空文字列を指定すると、それまでのコマンドのリストがリセットされると書かれています。
[Service]
ExecStart=
ExecStart=/usr/bin/node --max-old-space-size=512 /opt/sample-app/server.jsdaemon-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段階の優先度を指定します。
| 番号 | 名前 | 番号 | 名前 |
|---|---|---|---|
| 0 | emerg | 4 | warning |
| 1 | alert | 5 | notice |
| 2 | crit | 6 | info |
| 3 | err | 7 | debug |
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-appLoaded: が not-found ならユニットファイルが見つかっていません(ファイル名の誤り、置き場所の誤り、daemon-reloadのし忘れ)。bad-setting ならユニットファイルの必須の設定が解釈できていません。masked ならmaskされています。
Active: が failed のときは、カッコの中に結果が出ます。次の出力は形を示すための例です。
× 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-code | 0以外の終了コードで終了した |
signal | シグナルで異常終了した |
core-dump | シグナルで異常終了し、コアダンプを出した |
timeout | 起動や停止などの処理がタイムアウトした |
watchdog | ウォッチドッグの期限に間に合わなかった |
oom-kill | メモリ不足でOOM killerに終了させられた |
protocol | Type= で決めた手順をサービスが守らなかった(notify なのに通知が来ない、など) |
2. 終了コードから当たりをつける
status=203/EXEC のような200番台の終了コードは、アプリではなくsystemdが「プログラムを実行する前の準備」で失敗したことを表します。systemd.exec(5)の表から、よく見るものを挙げます。
| コード | 名前 | 意味と確かめること |
|---|---|---|
| 200 | CHDIR | 作業ディレクトリに移動できなかった。WorkingDirectory= のパスと権限 |
| 203 | EXEC | プログラムを実行できなかった(execve()の失敗)。ExecStart= のパスの誤り、ファイルが無い、実行権限が無い |
| 209 | STDOUT | 標準出力の準備に失敗した。StandardOutput= の設定 |
| 217 | USER | ユーザーの切り替えに失敗した。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.servicesystemd-analyze(1)によると、verify はユニットファイルを読み込み、エラーがあれば警告を表示します。指定したファイルから参照されている他のユニットも読み込まれます。項目名の打ち間違いや、存在しないプログラムの指定などを、起動する前に見つけられます。
7. 再起動の上限に達していないか
Restart= を設定したサービスが何度も落ちていると、前述の起動回数の上限に達して止まります。この状態では、原因を直しても start が拒否されることがあります。直したあとに sudo systemctl reset-failed sample-app を実行してから起動します。
systemdタイマーで定期実行する
systemdにはcronのような定期実行の仕組みもあります。タイマーユニット(.timer)が、決まった時刻に同じ名前のサービスユニットを起動します。毎日4時30分にバックアップを取る例です。
[Unit]
Description=Sample backup job
[Service]
Type=oneshot
User=sample-app
ExecStart=/usr/local/bin/sample-backup.sh[Unit]
Description=Run sample backup daily at 04:30
[Timer]
OnCalendar=*-*-* 04:30:00
Persistent=true
[Install]
WantedBy=timers.targetsudo systemctl daemon-reload
sudo systemctl enable --now sample-backup.timer
systemctl list-timers sample-backup.timerenableするのはサービスではなくタイマーの方です。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の順に確かめる
参考資料
- systemd(1)(freedesktop.org)
- systemctl(1)(freedesktop.org)
- systemd.unit(5)(freedesktop.org)
- systemd.service(5)(freedesktop.org)
- systemd.exec(5)(freedesktop.org)
- systemd.kill(5)(freedesktop.org)
- systemd.special(7)(freedesktop.org)
- journalctl(1)(freedesktop.org)
- journald.conf(5)(freedesktop.org)
- systemd.timer(5)(freedesktop.org)
- systemd.time(7)(freedesktop.org)
- systemd-analyze(1)(freedesktop.org)
- loginctl(1)(freedesktop.org)
- systemd/systemd(GitHub)
- systemd.io


