Portabel versjon

Kjør HolyArrs som et vanlig program på Linux eller Windows, uten Docker. Docker er fortsatt hovedmåten å kjøre den på.

Advarsel

Ingen publiserer arkiver av den portable versjonen ennå, og de er ikke signert. Du bygger dem selv fra kildekoden.

Før du begynner

• Python 3, Git og Docker på byggemaskinen.
• En fylt Go-modulcache fra et vanlig prosjektbygg, og frontend-avhengigheter installert fra app/frontend/package-lock.json.
• Web-appen bygget og committet. Bygget bruker bare committet kildekode; endringer som ikke er committet, utelates.

Bygg og kjør

1. Fra den utsjekkede kildekoden bygger du arkivene:

   python deploy/release/package.py --ref HEAD --version 1.0.0 --output /srv/holyarrs-archives/1.0.0 --web-node-modules app/frontend/node_modules --module-cache /home/you/go/pkg/mod

   Bruk en ny utdatamappe utenfor den utsjekkede kildekoden. Du skal se ett arkiv per mål og en SHA256SUMS-fil.

2. Sjekk arkivet mot SHA256SUMS.

3. Pakk det ut i en ny mappe. Ha programmet og konfigurasjonen i separate mapper.

4. Start det med din egen konfigurasjonssti:

   ./holyarrs -config /srv/holyarrs/config -addr :6262

   I Windows PowerShell:

   .\holyarrs.exe -config 'C:\HolyArrs\config' -addr ':6262'

5. Åpne http://your-server:6262. Du skal se veiviseren ved første oppstart. Lag eierkontoen med en gang; den første som besøker siden, blir eier.

Valg

Hvilken bruker som kjører den

Kjør HolyArrs under en egen konto, med skrivetilgang bare til konfigurasjonen og mediene dine.

• Som root utenfor en container, uten PUID og PGID, stopper den med «started as root outside a container».
• Med PUID og PGID satt gir den konfigurasjonsmappen til den brukeren og bytter til den.
• På Windows beskytter du konfigurasjonsmappen med en NTFS-tillatelse for den kontoen.

Omstarter og grenser

Arkivet installerer ingen tjeneste. Sett opp automatisk omstart og harde minnegrenser i din egen tjenestebehandler (systemd, NSSM, Oppgaveplanlegger). Omstart fra appen og gjenoppretting av backup avslutter begge programmet og forventer at det startes igjen.

Oppdater og gå tilbake

1. Sjekk det nye arkivet før du stopper appen.
2. Stopp HolyArrs og kopier hele konfigurasjonsmappen, hovednøkkelen med. Eller ta en backup i appen og oppbevar nøkkelen for seg.
3. Pakk det nye programmet ut i en annen mappe. Behold det gamle programmet og den gamle konfigurasjonskopien.
4. Start det nye programmet på konfigurasjonen din. Du skal kunne logge inn, og /health skal vise running.

Fare

Pek aldri et eldre program på databaser som et nyere har endret. For å gå tilbake lagrer du først den nyere konfigurasjonen, og starter så det gamle programmet på den tilhørende gamle konfigurasjonskopien.

Se Backuper.

Hvis det ikke fungerer

Symptom	Årsak	Løsning
«started as root outside a container»	Startet som root	Kjør den som en egen bruker, eller sett PUID og PGID.
Appen avslutter etter en gjenoppretting	En gjenoppretting klargjør dataene og avslutter med kode 75	Start den igjen for å ta dem i bruk. Sett tjenestebehandleren til å starte den på nytt.
HTTPS-kall mislykkes på Linux	Ingen CA-sertifikater i systemet	Installer dem.
Bygget sier at utdataene finnes	Eksisterende utdatamapper avvises	Velg en ny mappe.

For viderekomne

Byggevalg

Valg	Hva det gjør	Standard
--targets	Kommaseparert delmengde som skal bygges	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Hver byggecontainer får 1 CPU, 2 GiB og 256 prosesser; Go bygger én pakke om gangen. Pakkingen kjører fortsatt på verten, utenfor disse grensene.	av

Bygget kjører i prosjektets låste Go-byggeimage med nettverk av, så det laster ikke ned noe. Modulcachen monteres skrivebeskyttet. Hvis noe mål mislykkes, blir ingen utdatamappe liggende igjen. Committen legges til versjonsnummeret og bygges inn i programmet; appen og backupene rapporterer den.

Hva et arkiv inneholder

Programmet, lisensen, merknader om tredjepart, veiledninger, et kildemanifest og pakkeidentiteten. Et eget kildearkiv inneholder prosjektets kildekode og Go-avhengighetene; ha det ved siden av binærfilene.

SHA256SUMS beviser at filene stemmer. Det er ikke en signatur. Samme commit, versjon og inndata gir de samme arkivene, så du kan bygge på nytt for å sjekke.

Merknader om kjøring

Tema	Detalj
Konfigurasjonssti	Standard /config. Send alltid -config, på en lokal disk.
Minnemål	384 MiB uten GOMEMLIMIT. Sett den til omtrent 80 prosent av minnet du gir. Et mål, ikke en hard grense.
Modus for lite minne	På Linux slår den seg på av seg selv ved omtrent 2,5 GiB eller mindre; målet faller til en fjerdedel av minnet, mellom 192 og 384 MiB. HOLYARRS_LOW_MEMORY=1 eller 0 avgjør.
Node	Trengs ikke for å kjøre.
Hardlinks	Ha nedlastinger og bibliotekmapper på ett filsystem.

Relatert

• Installasjon
• Deler og sikkermodus
• Oppdateringer