Instalare pe propriul server

Creează mediul și obține un token

Hub: deschide hub.codai.ro/projects, creează un proiect, apoi Mediu nou → Propria mașină. Pe pagina mediului alege Generează token de înrolare; tokenul e de unică folosință, valabil 30 de minute, iar pagina afișează comanda exactă de instalare.

CLI: cu CODAI_API_KEY setat (sau o cheie în ~/.codai/codaid.json):

codaid env create --project my-app --name dev-box
# afișează mediul și:
#   curl -fsSL https://codai.ro/install-codaid.sh | CODAI_ENROLL_TOKEN=codai_env_… sh

API: POST /v1/environments cu "provider": "byo", apoi POST /v1/environments/{id}/enroll-token — vezi pagina de API.

Instalează și înrolează (Linux)

Rulează pe mașină, cu un utilizator care are sudo:

curl -fsSL https://github.com/codai-ro/codaid/releases/latest/download/install.sh \
  | CODAI_ENROLL_TOKEN=codai_env_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX sh

Installer-ul descarcă binarul pentru arhitectura ta în /usr/local/bin/codaid (verificând .sha256-ul publicat), rulează codaid enroll și — dacă systemd rulează — instalează și pornește codaid.service pentru utilizatorul care l-a lansat. Are nevoie de curl sau wget.

Pentru că un mediu BYO nu are o cheie API proprie, codaid enroll pornește apoi o autentificare cu cod de dispozitiv: afișează un URL și un cod, le aprobi în browser de pe orice dispozitiv, iar daemonul salvează cheia obținută. Transmite CODAI_API_KEY=codai_… ca să sari peste acest pas (util pentru flote).

Același script este oglindit la https://codai.ro/install-codaid.sh; URL-ul release-ului de pe GitHub este mereu cel mai nou.

Sau înrolează manual

codaid enroll --token codai_env_… [--api-key codai_…] [--workspace /srv/app]
codaid run            # în prim-plan; Ctrl-C îl oprește
codaid status         # JSON: configurație (cheie ascunsă), workspace, git, porturi, identitate, lock-uri

enroll scrie ~/.codai/codaid.json (director 0700, fișier 0600) cu id-ul dispozitivului, cheia API, id-ul mediului și URL-ul relay-ului. O reînrolare păstrează același id de dispozitiv. Cheia nu este afișată niciodată — status arată doar prefixul și lungimea ei.

Pe Windows, descarcă codaid-windows-x86_64.exe, apoi rulează codaid enroll --token … și codaid run într-un terminal. Comenzile de shell se execută în PowerShell. Nu există încă un serviciu Windows.

Rulează ca serviciu

# unitate pentru propriul utilizator (ce face installer-ul)
codaid install-service --user "$USER" | sudo tee /etc/systemd/system/codaid.service
sudo systemctl daemon-reload && sudo systemctl enable --now codaid

# unitate de sistem (root): conturi Linux per membru, repository-uri partajate, lock de build per repo
sudo codaid install-service --system [--identity per-user|shared] [--user codai] [--home /var/lib/codai]

--system trebuie rulat ca root, pe Linux cu systemd; creează utilizatorul serviciului și, în modul per-user, grupul codai-dev plus /srv/codai/repos și /var/lib/codai/locks. Dacă mașina nu e încă înrolată, afișează comanda sudo CODAI_HOME=/var/lib/codai/.codai codaid enroll … de rulat în continuare. Unitatea repornește la eșec, la fiecare 5 s.

Verifică dacă e online

codaid env status dev-box      # online=true, versiunea daemonului, porturi, branch git

Hub-ul afișează Daemon conectat, iar vizualizarea Medii din desktop arată un punct verde. Daemonul trimite un heartbeat la fiecare 15 s și se reconectează cu back-off (1 s → 30 s) de câte ori cade socket-ul; relay-ul închide orice WebSocket după o oră, iar daemonul se reconectează imediat.