① Giteaコンテナの起動
sudo docker run -d
--name gitea
-p 3000:3000
-p 222:22
-v ~/gitea-data:/data
--restart always
gitea/gitea:latest
↑ まず最初にこのコマンドを実行します。
② 初回Giteaにアクセスする
ブラウザで以下のURLにアクセスします。
http://サーバのIPアドレス:3000
初回アクセス時に表示されるセットアップ画面で、以下の設定を行います。
1. データベースの設定(Database Settings)
- データベースタイプ: 「SQLite3」(推奨、デフォルト)
- パス: デフォルトのまま変更不要(通常は「/data/gitea.db」)
2. 一般設定(General Settings)
- サイト名: 任意の名前(例: MyGitea)
- ドメイン: サーバのIPアドレスやドメイン名(例: 192.168.0.10)
- SSHポート: 「222」
- HTTPポート: 「3000」
- URLベース: デフォルトのまま「/」
3. 管理者ユーザー作成(Administrator Account Settings)
- 管理者ユーザー名: 任意(例: admin)
- パスワード: 安全なパスワードを設定
- メールアドレス: 任意のメールアドレスを入力
設定を入力後、「Install Gitea」ボタンをクリックして設定を完了します。
設定完了後はログイン画面が表示され、作成した管理者アカウントでログインできます。
③ クライアント側でのGitリポジトリの利用手順
1. Giteaでリポジトリ作成
Giteaにログイン後、「New Repository」をクリックして新規リポジトリを作成します。
2. クライアントでリポジトリをクローン
クライアント側で以下のコマンドを実行します。
git clone ssh://git@サーバのIPアドレス:222/ユーザー名/リポジトリ名.git
cd リポジトリ名
3. ファイルの追加とコミット
echo "My First File" > README.md
git add README.md
git commit -m "Initial commit"
4. リモートリポジトリの設定とPush
既存のリモートが存在する場合は削除します。
git remote remove origin
新しいリモートを設定します。
git remote add origin ssh://git@サーバのIPアドレス:222/ユーザー名/リポジトリ名.git
その後、Pushします。
git push -u origin main
これでクライアントからのリポジトリ操作が完了します。
(補足)Docker未インストール時の手順
Dockerがまだインストールされていない場合は以下を実行します。
sudo apt update
sudo apt install -y docker.io docker-compose
sudo systemctl enable --now docker
④ コンテナ操作の基本コマンド
- コンテナの停止
sudo docker stop gitea
- コンテナの起動
sudo docker start gitea
- コンテナの再起動
sudo docker restart gitea
- コンテナの削除
sudo docker rm -f gitea
- データの削除
rm -rf ~/gitea-data
- 削除後の確認
ls -la ~/gitea-data
⑤ データディレクトリの権限設定(事前準備)
mkdir -p ~/gitea-data
chmod 775 ~/gitea-data
⑥ Giteaのアップデート方法
sudo docker pull gitea/gitea:latest
sudo docker stop gitea
sudo docker rm gitea
sudo docker run -d \
--name gitea \
-p 3000:3000 \
-p 222:22 \
-v ~/gitea-data:/data \
--restart always \
gitea/gitea:latest
この順番で進めると、ローカル環境でのGiteaセットアップ・運用がスムーズに行えます。