2026年1月5日 (月) 16:05にWikiによる

2026-01-05T16:05:48Z

Wiki: ページの作成:「== 概要 == KiCADは、オープンソースのプリント基板設計ツールである。

Docker / Podmanコンテナとして実行することにより、開発環境で簡単に導入できる。
回路設計、PCB設計、ガーバー出力等の様々な用途に適している。

KiCADコンテナの主な機能を以下に示す。
* KiCAD : 回路エディタ、PCBエディタを含む統合環境 kicad-cli *: コマンドラ…」

2026-01-05T15:53:46Z

ページの作成:「== 概要 == KiCADは、オープンソースのプリント基板設計ツールである。 Docker / Podmanコンテナとして実行することにより、開発環境で簡単に導入できる。 回路設計、PCB設計、ガーバー出力等の様々な用途に適している。 KiCADコンテナの主な機能を以下に示す。 * KiCAD *: 回路エディタ、PCBエディタを含む統合環境 * kicad-cli *: コマンドラ…」

新規ページ

== 概要 ==
KiCADは、オープンソースのプリント基板設計ツールである。 
 
Docker / Podmanコンテナとして実行することにより、開発環境で簡単に導入できる。 
回路設計、PCB設計、ガーバー出力等の様々な用途に適している。 
 
KiCADコンテナの主な機能を以下に示す。 
* KiCAD
*: 回路エディタ、PCBエディタを含む統合環境
* kicad-cli
*: コマンドラインインターフェース
* スキーマティックのエクスポート
*: PDF、SVG、ネットリスト形式に対応
* PCBのエクスポート
*: ガーバー、PDF、SVG、STEP形式に対応
* DRC (デザインルールチェック)
* 日本語環境対応
*: 日本語フォントとロケール設定済み
 

== 利用可能なバージョン ==
2026年1月現在、KiCADコンテナイメージで利用可能なバージョンを下表に示す。 
 
<center>
{| class="wikitable"
! タグ !! 説明
|-
| 9.0 || 最新の9.0安定版（推奨）
|-
| 9.0.x || 特定の9.0.xリリース
|-
| 8.0 || 最新の8.0安定版
|-
| 8.0.x || 特定の8.0.xリリース
|-
| nightly || 最新のmaster開発版
|-
| nightly-full || 最新のmaster開発版（3Dシンボル含む）
|}
</center>
 

== Dockerfile / Containerfile ==
KiCADを使用したDockerfile / Containerfileを作成する。 
 
<syntaxhighlight lang="dockerfile">
# KiCAD Containerfile

## KiCAD 9.0を使用
ARG KICAD_VERSION=9.0

FROM docker.io/kicad/kicad:${KICAD_VERSION}

## rootユーザとして実行することを明示
USER root

## 必要なディレクトリを作成して、パーミッションを設定
RUN mkdir -p /var/lib/apt/lists/partial && \
chmod -R 755 /var/lib/apt/lists

## 日本語環境のセットアップ
RUN apt update && \
apt install -y --no-install-recommends \
locales \
fonts-noto-cjk \
fonts-noto-cjk-extra \
&& rm -rf /var/lib/apt/lists/*

## 日本語ロケールの設定
RUN sed -i -e 's/# ja_JP.UTF-8 UTF-8/ja_JP.UTF-8 UTF-8/' /etc/locale.gen && \
locale-gen

ENV LANG=ja_JP.UTF-8 \
LANGUAGE=ja_JP:ja \
LC_ALL=ja_JP.UTF-8

## 作業ディレクトリの設定
WORKDIR /workspace

## デフォルトコマンド (GUIの場合)
CMD ["kicad"]
</syntaxhighlight>
 
コンテナイメージをビルドする。 
podman build -t kicad:9.0 -f Containerfile .
 
他のバージョンを使用する場合は、ビルド時にバージョンを指定する。 
# KiCAD 8.0を使用する場合
podman build --build-arg KICAD_VERSION=8.0 -t kicad:8.0 -f Containerfile .

# 最新のnightly版 (3Dシンボル含む)
podman build --build-arg KICAD_VERSION=nightly-full -t kicad:nightly -f Containerfile .
 

== KiCADの実行 ==
==== 基本 ====
カレントディレクトリをマウントして実行する。 
 
podman run -it --rm \
-e DISPLAY=${DISPLAY} \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v $(pwd):/workspace \
kicad:9.0
 
コマンドオプションの説明を以下に示す。 
* -it
*: インタラクティブモード、TTY有効
* --rm
*: コンテナ終了時に自動削除
* -e DISPLAY=${DISPLAY}
*: X11ディスプレイ環境変数を渡す
* -v /tmp/.X11-unix:/tmp/.X11-unix:ro
*: X11ソケットをマウント (画面描画に必要、読み取り専用)
* -v $(pwd):/workspace
*: カレントディレクトリをコンテナ内の/workspaceにマウント
 
X11転送を許可する必要がある場合は、以下に示すコマンドを実行する。 
xhost +local:
 
==== SELinux環境での実行 ====
RHEL、SUSE 16等のSELinuxが有効な環境においては、以下に示すオプションを追加する。 
 
podman run -it --rm \
-e DISPLAY=${DISPLAY} \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v $(pwd):/workspace:Z \
--security-opt label=type:container_runtime_t \
kicad:9.0
 
SELinux環境向けの追加オプションを以下に示す。 
* :Z
*: SELinuxコンテキストを自動設定 (プライベートアンラベル)
* --security-opt label=type:container_runtime_t
*: SELinuxタイプをコンテナランタイムに設定
 
==== 特定のディレクトリをマウント ====
プロジェクトディレクトリを指定してマウントする例を以下に示す。 
 
podman run -it --rm \
-e DISPLAY=${DISPLAY} \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v /home/<ユーザ名>/projects:/workspace \
kicad:9.0
 
==== 複数のディレクトリをマウント ====
複数のディレクトリを同時にマウントする例を以下に示す。 
 
podman run -it --rm \
-e DISPLAY=${DISPLAY} \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v $(pwd):/workspace \
-v /home/<ユーザ名>/projects:/projects \
kicad:9.0
 
上記コマンドのコマンドにおいて、コンテナ内からは以下に示すパスでアクセスすることができる。 
* /workspace
*: カレントディレクトリ
* /projects
*: /home/<ユーザ>/projectsディレクトリ
 
==== 設定ファイルの永続化 ====
KiCADの設定ファイルを永続化する場合は、以下に示すようにマウントする。 
 
podman run -it --rm \
-e DISPLAY=${DISPLAY} \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v $(pwd):/workspace \
-v $HOME/.config/kicad:/root/.config/kicad \
kicad:9.0
 

== 起動スクリプト ==
==== 非SELinux環境 ====
<syntaxhighlight lang="sh">
#!/usr/bin/env sh
# KiCAD起動スクリプト

set -e

# 設定
IMAGE_NAME="${KICAD_IMAGE:-kicad:9.0}"
WORKSPACE_DIR="${KICAD_WORKSPACE:-$(pwd)}"

echo "KiCAD Podman起動スクリプト"
echo "==========================="
echo "イメージ: ${IMAGE_NAME}"
echo "ワークスペース: ${WORKSPACE_DIR}"
echo ""

# X11転送の許可 (X11を使用している場合)
xhost +local: 2>/dev/null || true

# KiCADを起動
podman run -it --rm \
-e DISPLAY="${DISPLAY}" \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v "${WORKSPACE_DIR}:/workspace" \
"${IMAGE_NAME}" "$@"
</syntaxhighlight>
 
==== SELinux環境 ====
<syntaxhighlight lang="sh">
#!/usr/bin/env sh
# KiCAD起動スクリプト

set -e

# 設定
IMAGE_NAME="${KICAD_IMAGE:-kicad:9.0}"
WORKSPACE_DIR="${KICAD_WORKSPACE:-$(pwd)}"

echo "KiCAD Podman起動スクリプト"
echo "==========================="
echo "イメージ: ${IMAGE_NAME}"
echo "ワークスペース: ${WORKSPACE_DIR}"
echo ""

# SELinux環境の検出
SELINUX_OPTS=""
if [ -f /sys/fs/selinux/enforce ] && [ "$(cat /sys/fs/selinux/enforce)" = "1" ]; then
echo "SELinux: 有効"
SELINUX_OPTS="--security-opt label=type:container_runtime_t"
VOLUME_OPTS=":Z"
else
echo "SELinux: 無効または未検出"
VOLUME_OPTS=""
fi

# X11転送の許可 (X11を使用している場合)
xhost +local: 2>/dev/null || true

# KiCADを起動
podman run -it --rm \
-e DISPLAY="${DISPLAY}" \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v "${WORKSPACE_DIR}:/workspace${VOLUME_OPTS}" \
${SELINUX_OPTS} \
"${IMAGE_NAME}" "$@"
</syntaxhighlight>
 
==== 複数ディレクトリをマウントする場合 ====
<syntaxhighlight lang="sh">
#!/usr/bin/env sh
# KiCAD起動スクリプト

set -e

# 設定
IMAGE_NAME="${KICAD_IMAGE:-kicad:9.0}"
CURRENT_DIR="$(pwd)"
PROJECT_DIR="${KICAD_PROJECT_DIR:-/home/user/projects}"

echo "KiCAD起動スクリプト"
echo "==========================="
echo "イメージ: ${IMAGE_NAME}"
echo "カレントディレクトリ: ${CURRENT_DIR} -> /workspace"
echo "プロジェクトディレクトリ: ${PROJECT_DIR} -> /projects"
echo ""

# SELinux環境の検出
SELINUX_OPTS=""
VOLUME_OPTS=""
if [ -f /sys/fs/selinux/enforce ] && [ "$(cat /sys/fs/selinux/enforce)" = "1" ]; then
echo "SELinux: 有効"
SELINUX_OPTS="--security-opt label=type:container_runtime_t"
VOLUME_OPTS=":Z"
fi

# X11転送の許可 (X11を使用している場合)
xhost +local: 2>/dev/null || true

# KiCADを起動
podman run -it --rm \
-e DISPLAY="${DISPLAY}" \
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
-v "${CURRENT_DIR}:/workspace${VOLUME_OPTS}" \
-v "${PROJECT_DIR}:/projects${VOLUME_OPTS}" \
${SELINUX_OPTS} \
"${IMAGE_NAME}" "$@"
</syntaxhighlight>
 
スクリプトに実行権限を付与する。 
chmod u+x run-kicad-gui.sh
 
スクリプトを実行してKiCADを起動する。 
./run-kicad-gui.sh
 
環境変数でイメージやディレクトリを指定することもできる。 
# イメージを指定
KICAD_IMAGE=kicad:8.0 ./run-kicad-gui.sh

# ワークスペースを指定
KICAD_WORKSPACE=/path/to/project ./run-kicad-gui.sh

# 両方を指定
KICAD_IMAGE=kicad:nightly KICAD_WORKSPACE=/path/to/project ./run-kicad-gui.sh
 

== CLI版の実行 ==
kicad-cliを使用してコマンドラインから操作する。 
 
==== 基本 ====
ヘルプを表示する。 
 
podman run --rm kicad:9.0 kicad-cli --help
 
バージョンを確認する。 
podman run --rm kicad:9.0 kicad-cli --version
 
==== 回路図のエクスポート ====
回路図をPDFへ変換する。 
 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli sch export pdf -o <出力するPDFファイル名>.pdf <入力するプロジェクトファイル名>.kicad_sch
 
スキーマティックをSVGに変換する例を以下に示す。 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli sch export svg -o <出力するPDFファイル名>.svg <入力するプロジェクトファイル名>.kicad_sch
 
ネットリストを出力する。 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli sch export netlist -o <出力するネットリスト名>.net <入力するプロジェクトファイル名>.kicad_sch
 
==== PCBのエクスポート ====
PCBをガーバーファイルへ出力する。 
 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli pcb export gerbers -o ./gerbers/ <入力するプロジェクトファイル名>.kicad_pcb
 
PCBをPDFへ変換する。 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli pcb export pdf -o <出力するPDFファイル名>.pdf <入力するプロジェクトファイル名>.kicad_pcb
 
PCBをSVGへ変換する。 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli pcb export svg -o <出力するSVGファイル名>.svg <入力するプロジェクトファイル名>.kicad_pcb
 
PCBを3DモデルSTEP形式でエクスポートする。 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli pcb export step -o <出力する3Dモデルファイル名>.step <入力するプロジェクトファイル名>.kicad_pcb
 
==== DRC (デザインルールチェック) ====
PCBのデザインルールチェックを実行する。 
 
podman run --rm \
-v $(pwd):/workspace \
kicad:9.0 \
kicad-cli pcb drc -o <出力するDRCファイル名>.txt <入力するプロジェクトファイル名>.kicad_pcb
 

== CLI実行スクリプト ==
kicad-cliを簡単に実行するためのスクリプトを作成する。 
 
<syntaxhighlight lang="sh">
#!/usr/bin/env sh
# KiCAD CLI実行スクリプト

set -e

# 設定
IMAGE_NAME="${KICAD_IMAGE:-kicad:9.0}"
WORKSPACE_DIR="${KICAD_WORKSPACE:-$(pwd)}"

# 引数が指定されていない場合はヘルプを表示
if [ $# -eq 0 ]; then
echo "KiCAD CLI実行スクリプト"
echo "======================="
echo ""
echo "使用方法:"
echo " $0 <kicad-cliコマンド>"
echo ""
echo "例:"
echo " # ヘルプ表示"
echo " $0 --help"
echo ""
echo " # スキーマティックをPDFに変換"
echo " $0 sch export pdf -o output.pdf input.kicad_sch"
echo ""
echo " # PCBをGerberに出力"
echo " $0 pcb export gerbers -o ./gerbers/ input.kicad_pcb"
echo ""
echo "環境変数:"
echo " KICAD_IMAGE : 使用するイメージ（デフォルト: kicad:9.0）"
echo " KICAD_WORKSPACE : ワークスペースディレクトリ（デフォルト: カレントディレクトリ）"
echo ""
exit 1
fi

# SELinux環境の検出
VOLUME_OPTS=""
if [ -f /sys/fs/selinux/enforce ] && [ "$(cat /sys/fs/selinux/enforce)" = "1" ]; then
VOLUME_OPTS=":Z"
fi

# KiCAD CLIを実行
podman run --rm \
-v "${WORKSPACE_DIR}:/workspace${VOLUME_OPTS}" \
"${IMAGE_NAME}" \
kicad-cli "$@"
</syntaxhighlight>
 
スクリプトに実行権限を付加する。 
chmod u+x run-kicad-cli.sh
 
スクリプトを実行する。 
# ヘルプ表示
./run-kicad-cli.sh --help

# 回路図をPDFに変換
./run-kicad-cli.sh sch export pdf -o <出力するPDFファイル名>.pdf <入力するプロジェクトファイル名>.kicad_sch

# PCBをガーバーへ出力
./run-kicad-cli.sh pcb export gerbers -o ./gerbers/ <入力するプロジェクトファイル名>.kicad_pcb
 

== CI/CD環境での使用 ==
==== GitLab CI ====
<syntaxhighlight lang="yaml">
stages:
- build
- export

generate_gerbers:
stage: export
image: docker.io/kicad/kicad:9.0
script:
- kicad-cli pcb export gerbers -o ./gerbers/ project.kicad_pcb
artifacts:
paths:
- gerbers/
expire_in: 1 week

generate_pdf:
stage: export
image: docker.io/kicad/kicad:9.0
script:
- kicad-cli sch export pdf -o schematic.pdf project.kicad_sch
- kicad-cli pcb export pdf -o pcb.pdf project.kicad_pcb
artifacts:
paths:
- schematic.pdf
- pcb.pdf
expire_in: 1 week

run_drc:
stage: build
image: docker.io/kicad/kicad:9.0
script:
- kicad-cli pcb drc -o drc-report.txt project.kicad_pcb
- cat drc-report.txt
artifacts:
paths:
- drc-report.txt
expire_in: 1 week
</syntaxhighlight>
 
==== GitHub Actions ====
<syntaxhighlight lang="yaml">
name: KiCAD Export

on:
push:
branches: [ main ]
pull_request:
branches: [ main ]

jobs:
export:
runs-on: ubuntu-latest
container:
image: docker.io/kicad/kicad:9.0

steps:
- name: Checkout
uses: actions/checkout@v3

- name: Generate Gerbers
run: |
kicad-cli pcb export gerbers -o ./gerbers/ project.kicad_pcb

- name: Generate PDFs
run: |
kicad-cli sch export pdf -o schematic.pdf project.kicad_sch
kicad-cli pcb export pdf -o pcb.pdf project.kicad_pcb

- name: Run DRC
run: |
kicad-cli pcb drc -o drc-report.txt project.kicad_pcb

- name: Upload Artifacts
uses: actions/upload-artifact@v3
with:
name: kicad-outputs
path: |
gerbers/
*.pdf
drc-report.txt
</syntaxhighlight>
 

== トラブルシューティング ==
==== GUIが起動しない ====
X11転送を許可する。 
 
xhost +local:
 
DISPLAYが正しく設定されているか確認する。 
echo $DISPLAY
 
XAuthの問題の場合は、以下に示すオプションを追加する。 
-v ${HOME}/.Xauthority:/root/.Xauthority:ro
 
==== パーミッションエラー ====
SELinux環境では、ボリュームマウントに:Zオプションを付与する。 
 
-v $(pwd):/workspace:Z
 
ホスト側のディレクトリのパーミッションを確認する。 
ls -la $(pwd)
 
==== 日本語が表示されない ====
イメージを再ビルドする。 
 
# Docker
docker build -t kicad:9.0 -f Containerfile . --no-cache

# Podman
podman build -t kicad:9.0 -f Containerfile . --no-cache
 
日本語フォントがインストールされているか確認する。 
# Docker
docker run --rm kicad:9.0 fc-list | grep -i noto

# Podman
podman run --rm kicad:9.0 fc-list | grep -i noto
 
==== ファイルが見つからない ====
ボリュームマウントのパスを確認する。 
 
# コンテナ内でファイルを確認 (Docker)
docker run --rm -v $(pwd):/workspace kicad:9.0 ls -la /workspace

# コンテナ内でファイルを確認 (Podman)
podman run --rm -v $(pwd):/workspace kicad:9.0 ls -la /workspace
 
作業ディレクトリを確認する。 
# Docker
docker run --rm -v $(pwd):/workspace kicad:9.0 pwd

# Podman
podman run --rm -v $(pwd):/workspace kicad:9.0 pwd
 
==== コマンドが見つからない ====
kicad-cliが正しくインストールされているか確認する。 
 
# Docker
docker run --rm kicad:9.0 which kicad-cli
docker run --rm kicad:9.0 kicad-cli --version

# Podman
podman run --rm kicad:9.0 which kicad-cli
podman run --rm kicad:9.0 kicad-cli --version
 

== 参考情報 ==
KiCADに関する詳細な情報を知りたい場合は、以下に示すWebサイトを参照すること。 
 
* KiCAD公式サイト
*: https://www.kicad.org/
* KiCAD Dockerイメージ
*: https://hub.docker.com/r/kicad/kicad
* KiCAD CLIドキュメント
*: https://docs.kicad.org/master/en/cli/cli.html
* KiCADドキュメント
*: https://docs.kicad.org/
* KiCAD GitLab
*: https://gitlab.com/kicad/code/kicad
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:コンテナ]]

コンテナ - KiCAD - 版の履歴

2026年1月5日 (月) 16:05にWikiによる