...
Eroare Linux · Procese, servicii, cron și disc

app.service: Main process exited, code=exited, status=1/FAILURE

Pe scurt

Programul pornit de serviciu a rulat, dar s-a oprit singur cu codul de ieșire 1, adică a raportat o eroare. Motivul real e în jurnal, chiar deasupra acestei linii: citește-l cu journalctl -u app -n 30. Des e un fișier găsit doar din alt folder (lipsește WorkingDirectory) sau o variabilă lipsă.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

systemd îți spune că procesul principal al serviciului (Main process) s-a terminat normal (code=exited), cu codul 1, pe care systemd îl numește FAILURE. Spre deosebire de 203/EXEC, aici programul chiar a pornit; el însuși a decis să se oprească. Urmează de obicei Failed with result 'exit-code', iar cu Restart=on-failure serviciul repornește până la start-limit-hit.

Motivul e scris de program în ieșirea lui, pe care systemd o pune în jurnal, deci journalctl -u app -n 30 sau systemctl status app (ultimele linii). Cauza cea mai frecventă la început: programul merge din terminal, dar nu ca serviciu, pentru că systemd îl pornește din folderul /, ca root (sau alt User=), cu un mediu minim, fără variabilele din .bashrc și fără PATH-ul tău.

De ce apare: cauzele frecvente

1Căi relative, fără WorkingDirectory

Greșit
BASH
[Service]
ExecStart=/home/elev/app/start.sh
Corect
BASH
[Service]
WorkingDirectory=/home/elev/app
ExecStart=/home/elev/app/start.sh

Fără WorkingDirectory, procesul pornește din /, iar config.ini relativ nu e găsit. Apoi sudo systemctl daemon-reload și restart.

2Variabile de mediu din .bashrc

Greșit
BASH
# în .bashrc: export DB_HOST=localhost
ExecStart=/home/elev/app/start.sh
Corect
BASH
Environment=DB_HOST=localhost
ExecStart=/home/elev/app/start.sh

Serviciile nu citesc .bashrc. Variabilele se dau în unitate cu Environment= sau EnvironmentFile=.

3Alt utilizator, fără drepturi

Greșit
BASH
User=www-data
ExecStart=/home/elev/app/start.sh
Corect
BASH
User=elev
ExecStart=/home/elev/app/start.sh

Utilizatorul serviciului trebuie să poată citi fișierele aplicației; altfel programul primește Permission denied și iese cu 1.

Repară tu

Repară eroarea, direct în pagină

Serviciul app pornește scriptul /home/elev/app/start.sh, care citește config.ini din folderul lui. Din terminal, din folderul app, merge, dar sudo systemctl start app se termină cu Main process exited, code=exited, status=1/FAILURE. Citește jurnalul, repară unitatea /etc/systemd/system/app.service și pornește serviciul, ca să rămână activ.

Indiciu

Jurnalul spune ce fișier nu e găsit; systemd pornește programul din folderul /.

Alte forme ale mesajului

  • Main process exited, code=exited, status=1/FAILURE
  • app.service: Failed with result 'exit-code'.
  • Active: failed (Result: exit-code)
  • Process: 1210 ExecStart=/home/elev/app/start.sh (code=exited, status=1/FAILURE)
  • app.service: Main process exited, code=exited, status=2/INVALIDARGUMENT

Cum o eviți pe viitor

  • Testează programul exact cum îl pornește systemd: din /, cu calea completă (cd / && /home/elev/app/start.sh).
  • Pune în unitate WorkingDirectory=, User= și variabilele necesare.
  • Fă programul să scrie un mesaj clar pe stderr înainte de exit 1, ca jurnalul să explice problema.
  • După orice modificare a unității: sudo systemctl daemon-reload, apoi restart, apoi status.

Întrebări frecvente

Unde văd de ce a ieșit cu 1?

În jurnal: journalctl -u app -n 30 --no-pager sau journalctl -xeu app. Mesajele programului apar etichetate cu numele lui, de exemplu start.sh[1210]: Nu gasesc config.ini.

Ce înseamnă alte coduri, de exemplu status=127?

Codurile vin de la program. Pentru scripturi bash, 127 înseamnă de obicei că o comandă din script nu a fost găsită (mediul serviciului are alt PATH), iar 126 că un fișier nu poate fi executat.

Erori înrudite

← Toate erorile Linux

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Linux de la zero, cu exerciții la fiecare lecție

Curs Linux: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.