1. クラウドサーバー
  2. サポート
04 Support

SSH接続、Xcodeビルド、Runner設定:セルフサービスサポートドキュメント

まずはドキュメントを確認し、それでも解決しない場合にチケットを発行してください。接続・署名・VNCという頻出の3種類の問題は、このページを10分ほど確認すれば大半が自己解決できます。それでも解決しない場合は、ページ末尾でエンジニアが一目で状況を把握できるチケットの書き方を紹介しています。

Quick Start

クイックスタート:3ステップ

ご注文後、平均5分でログイン情報のメールが届きます。以下の3ステップに従えば、初回接続は3分以内に完了します。

01

ログイン情報メールを受け取る

メールにはノードアドレス(例:hk1.oncemini.com)、SSHポート 22、初期アカウント dev、初期パスワード、VNCパスワードが記載されています。届いていない場合はまず迷惑メールフォルダを確認し、次に管理コンソールのインスタンス詳細ページをご確認ください。

02

SSHで初回ログインしパスワードを変更

ssh -p 22 dev@ノードアドレス を実行してログインしたら、すぐに passwd で初期パスワードを変更してください。続けて ssh-copy-id で公開鍵をアップロードし、パスワードログインを無効化することをおすすめします。

03

VNCでGUIに接続

macOS標準の「画面共有」または任意のVNCクライアントで ノードアドレス:5900 に接続し、VNCパスワードを入力すると完全なmacOSデスクトップにアクセスできます。Xcodeの初回ペアリングやポップアップの許可もここで行います。

提供時からroot権限付き:sudo は常時利用可能で、システムレベルの設定も自由に変更できます。設定を壊してしまっても大丈夫——管理コンソールからセルフサービスでmacOSを再インストールできます。詳細は下記のガイドをご覧ください。
Terminal

ログインからアップロードまで:ひと続きのフローで完結

こちらは香港ノードのMini M(M4/24GB)で実際に取得した出力の抜粋です:SSHログイン、Xcodeビルド、fastlaneによるApp Store Connectへのアップロード。右側のコマンドはそのままコピーできます。

dev@mini-hk1 — zsh — 96×28
ssh -p 22 dev@hk1.oncemini.com
Last login: Mon Jul 27 09:12:33 2026 from 203.0.113.24
sw_vers
ProductName:    macOS
ProductVersion: 15.5
BuildVersion:   24F74
xcodebuild -scheme App -configuration Release -destination 'generic/platform=iOS' build
▸ Compiling AppDelegate.swift
▸ Linking App
▸ Signing App.app
** BUILD SUCCEEDED ** [128.4s]
bundle exec fastlane release
[10:24:08] Login to App Store Connect (API key)
[10:26:41] Upload progress: 100%
Successfully uploaded package to App Store Connect
dev@mini-hk1 ~ % 

よく使うコマンド・クリックでコピー

ssh -p 22 dev@hk1.oncemini.com
passwd
ssh-copy-id -i ~/.ssh/id_ed25519.pub dev@hk1.oncemini.com
sudo xcode-select -s /Applications/Xcode_16.4.app
xcodebuild -scheme App -configuration Release build
security unlock-keychain login.keychain-db

hk1 をご利用のノードのプレフィックスに置き換えるだけです。各ノードのドメインはノード一覧をご確認ください。ローカルで動作しているCIスクリプトは、そのまま持ち込んでご利用いただけます。

Guides

よくあるタスクガイド

よく寄せられる4つのタスクについて、手順どおりに進めるだけで完了します。各ガイドは実機で検証済みです。

複数バージョンのXcodeと切り替え

  1. 提供時のイメージには安定版のXcodeが2つプリインストールされており、バージョン番号に従って /Applications/Xcode_16.4.app/Applications/Xcode_15.4.app に配置されています。
  2. 現在有効になっているバージョンの確認:xcodebuild -version
  3. グローバルな切り替え:sudo xcode-select -s /Applications/Xcode_15.4.app
  4. CI環境ではグローバル設定を変更せず、環境変数でその都度指定してください:DEVELOPER_DIR=/Applications/Xcode_16.4.app xcodebuild …
  5. 他のバージョン(beta含む)が必要な場合は、バージョン番号を明記してチケットを発行してください。プリインストールライブラリは15.0以降の正式版すべてをカバーしており、営業時間内であれば通常2時間以内にマシンへ反映されます。

GitHub Actionsのself-hosted runnerを設定する

  1. リポジトリの Settings → Actions → Runners → New self-hosted runner を開き、OSはmacOS、アーキテクチャはARM64を選択します。
  2. 表示されたコマンドに従ってrunnerパッケージをダウンロード・展開し、./config.sh --url … --token … を実行して登録を完了します。
  3. 常駐サービスとして登録:./svc.sh install && ./svc.sh start を実行すると、マシン再起動後もlaunchdが自動的に起動します。
  4. workflowには runs-on: [self-hosted, macOS, ARM64] と記述します。複数台運用する場合はカスタムラベルで区別することをおすすめします。
  5. 同時実行数の目安:Mini M(24GB)は2件の並列ジョブを安定して実行できます。より高い並列度が必要な場合は Mini Pro(64GB)をご検討ください。詳細はレンタルプランをご覧ください。

実機を接続してリモートデバッグ

  1. テスト用のiPhoneとクラウドMacが同一LAN内にない場合は、まずWireGuardなどのVPNツールでデバイスとホストを同一ネットワークに接続してください。
  2. 初回のペアリングはXcodeの「Devices and Simulators」ウィンドウで行い、VNC経由のGUI操作を一度行うだけで完了します。
  3. ペアリング時に「ネットワークデバッグ」にチェックを入れておくと、以降は xcodebuild -destination 'platform=iOS,name=デバイス名' で実機を直接指定できます。
  4. ユニットテストやシミュレーターでのUIテストのみであれば実機は不要で、提供された時点でそのままご利用いただけます。ネットワーク設定も不要です。

macOSの再インストール

  1. 管理コンソールにログイン → インスタンス詳細 → 「OS再インストール」を選択し、macOS 14 / 15 のいずれかのメジャーバージョンを選べます。
  2. 再インストールを行うとディスク全体が消去され復元できません。事前に管理コンソールでスナップショットをダウンロードしてください。
  3. すべてセルフサービスで完了し、平均 10 分でログイン待ち状態に戻ります。新しいログイン情報は自動的に再発行され、メールで再送されます。
  4. 回数制限も追加料金もありません。設定を壊してしまった場合、メジャーバージョンを変更したい場合、解約前にディスクを手動で消去したい場合など、いずれもこの方法で対応できます。
Glossary

用語ミニ辞典

ドキュメントやチケット対応で頻出する8つの用語です。定義を揃えることで、認識のズレを防ぎます。

物理専用サーバー
物理Mac mini本体をそのまま提供する方式です。OSは実機ハードウェア上で直接動作し、仮想化レイヤーが介在しないためパフォーマンスの損失がありません。
専有
1台のマシンは同時に1つのテナントのみが使用します。CPU、メモリ、SSD、1Gbpsの帯域幅は誰とも共有しません。
VNC
リモートGUI接続プロトコルです。接続すると完全なmacOSデスクトップが表示され、デバイスのペアリングやシステムのポップアップ操作もすべてこれを通じて行います。
self-hosted runner
自分のマシンに登録するCI実行エージェントです。GitHub Actions / GitLab CIのmacOSタスクをこのMacが直接実行するため、公式のキュー待ちが発生しません。
ユニファイドメモリ
Apple SiliconではCPUとGPUが同一のメモリプールを共有します。64GBモデルなら大規模な量子化モデルもそのままロードでき、専用VRAMの制約を受けません。
Apple Silicon
Appleが自社開発したARMアーキテクチャのチップです(当サービスではM4 / M4 Proを採用)。iOS実機ビルドやMLX・CoreMLの実験は、いずれもこのチップをネイティブターゲットとしています。
スナップショット
ディスク全体をパッケージ化したイメージです。管理コンソールからいつでも作成・ローカルへダウンロードでき、再インストールや解約、ノード変更前の保険として利用できます。
SLA
サービス可用率の保証値で、当サービスでは 99.9% です。基準を下回った場合は規定に基づき利用期間を補償します。詳細はセキュリティ&信頼をご覧ください。
Troubleshoot

障害セルフチェックリスト

この3種類の問題がチケット全体の約7割を占めています。順番にチェックしていけば、多くの場合ステップ2〜3で原因が特定できます。

SSHに接続できない

  1. 管理コンソールでインスタンスのステータスが running になっており、電源インジケーターが正常であることを確認します。
  2. ローカルから ping / mtr でノードのドメインを確認します。パケットロスが多い場合はネットワークを変えるか、ノード一覧ページのテスト用IPで回線を再確認してください。
  3. ポート 22 とユーザー名 dev を確認し、ssh -v を実行してハンドシェイクがどのステップで止まっているか確認します。
  4. sshd_config を変更して自分でログインできなくなった場合は、管理コンソールから強制再起動を行い、VNC経由でデスクトップに入って設定を元に戻してください。
  5. それでも解決しない場合は、ssh -vvv の出力全体をチケットに貼り付けてください。

ビルド時の署名エラー

  1. errSecInternalComponent やキーチェーンアクセスの失敗が出た場合は、まず security unlock-keychain login.keychain-db を実行してください。
  2. CIセッションではデフォルトでキーチェーンがロックされているため、スクリプトの先頭にロック解除コマンドを追加するか、fastlane matchで証明書を管理してください。
  3. 証明書が正しくインポートされているか確認:security find-identity -v -p codesigning を実行し、署名アイデンティティが表示されることを確認します。
  4. unsupported SDK というエラーは大抵Xcodeのバージョン不一致が原因です。上記のガイドに従ってバージョンを切り替えてから再試行してください。

VNCが黒い画面のまま

  1. まずSSHで接続を試してください。ログインできればシステム自体は正常で、表示サービスのみの問題です。すぐに再インストールする必要はありません。
  2. SSH経由で画面共有サービスを再起動:sudo launchctl kickstart -k system/com.apple.screensharing
  3. 解像度が高すぎると黒い画面や表示崩れが発生することがあります。クライアント側の解像度を 1920×1080 に下げて再接続してください。
  4. それでも解決しない場合は、管理コンソールからインスタンスを再起動してください。ホストには仮想ディスプレイが搭載されているため、再起動後は表示が復旧します。
Tickets

チケットと対応時間

サポートチームはUTC+8とUTC-8の2つのタイムゾーンでシフト対応しています。窓口は管理コンソールのチケットとサポートメールの2つのみで、電話やチャットでの対応は行っておりません。

管理コンソールのチケット(推奨)

手順:管理コンソールにログイン → チケット → 新規作成、対象のインスタンスを選択します。チケットには自動的にインスタンスの情報が付与されるため、対応が最も速くなります。適用範囲:インスタンス障害、Xcodeバージョンのリクエスト、スペック変更、再インストールのサポートなど。

  • インスタンスID、ノード名、問題が発生した時刻を明記してください
  • コマンドとエラー出力はスクリーンショットではなくテキストで貼ってください
  • このページのチェックリストで確認済みの手順を列記すると、やり取りの往復が減ります

サポートメール

管理コンソールにログインできない場合、会計・請求書に関する問題、ご注文前の技術的なご質問がある場合は、support@oncemini.com までメールをお送りください。件名に用件を明記し、本文に登録メールアドレスを記載していただくと、アカウントの照合がスムーズです。

  • 登録済みのメールアドレスから送信すると、本人確認のやり取りが不要になります
  • その他の連絡方法や文面テンプレートはお問い合わせをご覧ください
問題の種類 初回応答 対応時間帯 推奨窓口
緊急障害(インスタンスのダウン、完全な接続不可) 30分以内 7×24 管理コンソールのチケット(緊急マークを付与)
一般的な技術的問題(ビルド、設定、パフォーマンス) 2時間以内 営業時間内(UTC+8 / UTC-8 シフト対応) 管理コンソールのチケット
会計・請求書・ご注文前のご相談 1営業日以内 営業時間内 support@oncemini.com
Uptime

稼働状況と通知の仕組み

FAQ

お支払い・アカウントに関するよくある質問

接続やビルドに関する質問は上記をご参照ください。ここでは料金とデータに関する質問にお答えします。料金の詳細はレンタルプランをご覧ください。

課金はいつから始まりますか?

ご注文時点ではなく、ログイン情報のメールが届いた瞬間から課金が始まります。日単位プランは24時間を1日として計算し、平均5分の提供時間には課金されません。

更新の方法は?自動で支払われますか?

管理コンソールのインスタンス詳細ページからいつでも手動で更新できます。自動更新をオンにすることも可能です。期限の72時間前と24時間前にそれぞれリマインドメールが送信されます。自動更新に失敗した場合(カードの期限切れなど)は即座にメールでお知らせし、72時間の猶予期間を設けています。

期限切れで更新しなかった場合、データはすぐに削除されますか?

いいえ。期限切れ後はまずインスタンスが停止し、データは 72 時間保持されます。この間に更新すればそのまま復元されます。72時間を超えるとAPFS暗号化ボリュームの鍵を破棄したうえでディスク全体を上書きするため、復元は不可能になります。詳しい流れはセキュリティ&信頼をご覧ください。

古いマシンから新しいマシンへデータを移行するには?

両方のマシンがまだ利用期間内であれば、マシン間で直接同期するのが最速です:rsync -avz -e "ssh -p 22" ~/work/ dev@新しいノード:~/work/。同一リージョンのノード間であれば、内部ネットワークでギガビット速度を出せます。あるいは、管理コンソールでスナップショットをローカルにダウンロードし、新しいマシンに復元する方法もあります。

どの決済方法に対応していますか?

全サービスの料金は米ドル(USD)で表示・決済されます。USDT-TRC20とVisa / Mastercard / Amex(Stripe)がご利用いただけます。詳細はポータルの決済ページに表示される方法をご確認ください。隠れた通信量課金などはなく、請求金額はプラン表示価格と一致します。

請求書は発行できますか?

お支払いごとにPDF形式の請求レシートが自動生成され、管理コンソールの請求ページからいつでもダウンロードできます。宛名の指定や税番号の追記が必要な場合は support@oncemini.com までご連絡いただければ、1営業日以内に対応いたします。

利用中にスペックをアップグレードしたい場合、費用はどう計算されますか?

アップグレードは残りの利用期間に応じた差額のみを計算し、重複して課金されることはありません。管理コンソールでアップグレード申請を行うと、データはスナップショット経由で新しいマシンに移行されます。移行中も旧マシンは利用可能な状態を維持します。ダウングレードは現在の利用期間終了後に反映されます。

初回利用で満足できなかった場合、返金は可能ですか?

初回のご利用開始から24時間以内であれば全額返金が可能です(更新分の返金は対象外です)。まずは日単位プランの $19.9 で1日試してみて、実際にビルドスクリプトを実行してから月額プランへの切り替えをご検討いただくことをおすすめします。

macOSの再インストールは有料ですか?回数に制限はありますか?

無料で回数制限もなく、すべて管理コンソールからセルフサービスで行えます。平均10分で完了します。唯一の注意点は、再インストールによりディスク全体が消去されることです。事前にスナップショットをダウンロードしてください。

1つのアカウントで複数台レンタルできますか?第三者への転貸はできますか?

1つのアカウントで同時に複数台レンタルできます。チームでは、プロジェクトごとに1台ずつレンタルし、ラベルでrunnerを区別する運用が一般的です。第三者への転貸・再販は利用規約に違反し、確認された場合はサービスを停止します。なお、チーム内で複数人が同じマシンを共用することに制限はありません。

$ oncemini ticket new --priority normal

ドキュメントで解決しない問題がありますか?

管理コンソールからチケットを発行してください。営業時間内であれば2時間以内に担当者からご連絡します。まだマシンをお持ちでない場合は、まず日単位プランでお試しください。