Portabel version

Kör HolyArrs som ett vanligt program på Linux eller Windows, utan Docker. Docker är fortfarande det huvudsakliga sättet att köra det.

Caution

Ingen publicerar portabla arkiv ännu, och de är inte signerade. Du bygger dem själv från källkoden.

Innan du börjar

• Python 3, Git och Docker på byggdatorn.
• En fylld Go-modulcache från ett vanligt projektbygge, och frontend-beroenden installerade från app/frontend/package-lock.json.
• Den byggda webbappen incheckad. Bygget använder bara incheckad källkod; ändringar som inte är incheckade lämnas utanför.

Bygg och kör

1. Bygg arkiven från din checkout:

   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

   Använd en ny utdatamapp utanför checkouten. Du ska se ett arkiv per mål och en fil SHA256SUMS.

2. Kontrollera arkivet mot SHA256SUMS.

3. Packa upp det i en ny mapp. Håll programmet och konfigurationen i separata mappar.

4. Starta det med din egen konfigurationssökväg:

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

   I Windows PowerShell:

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

5. Öppna http://your-server:6262. Du ska se guiden vid första start. Skapa ägarkontot direkt; den första besökaren blir ägare.

Val

Vilken användare som kör det

Kör HolyArrs under ett eget konto, med skrivrättigheter bara till konfigurationen och dina media.

• Som root utanför en container, utan PUID och PGID, stannar det med “started as root outside a container”.
• Med PUID och PGID satta ger det konfigurationsmappen till den användaren och byter till den.
• På Windows skyddar du konfigurationsmappen med en NTFS-behörighet för det kontot.

Omstarter och gränser

Arkivet installerar ingen tjänst. Konfigurera automatisk omstart och hårda minnesgränser i din egen tjänsthanterare (systemd, NSSM, Aktivitetsschemaläggaren). Omstart från appen och en återställning av backup avslutar båda programmet och förväntar sig att det startas igen.

Uppdatera och gå tillbaka

1. Kontrollera det nya arkivet innan du stoppar appen.
2. Stoppa HolyArrs och kopiera hela konfigurationsmappen, med huvudnyckeln. Eller gör en backup i appen och spara dess nyckel separat.
3. Packa upp det nya programmet i en annan mapp. Behåll det gamla programmet och den gamla konfigurationskopian.
4. Starta det nya programmet på din konfiguration. Du ska kunna logga in, och /health ska visa running.

Danger

Rikta aldrig ett äldre program mot databaser som ett nyare har ändrat. För att gå tillbaka sparar du först den nyare konfigurationen och startar sedan det gamla programmet på dess matchande gamla konfigurationskopia.

Se Backuper.

Om det inte fungerar

Symptom	Orsak	Lösning
“started as root outside a container”	Startades som root	Kör det som en egen användare, eller sätt PUID och PGID.
Appen avslutas efter en återställning	En återställning förbereder datan och avslutar med kod 75	Starta den igen för att tillämpa den. Låt din tjänsthanterare starta om den.
HTTPS-anrop misslyckas på Linux	Inga CA-certifikat i systemet	Installera dem.
Bygget säger att utdata redan finns	Befintliga utdatamappar nekas	Välj en ny mapp.

För experter

Byggalternativ

Alternativ	Vad det gör	Standard
--targets	Kommaseparerad delmängd att bygga	linux-amd64,linux-arm64,linux-armv7,windows-amd64
--low-resource	Varje byggcontainer får 1 CPU, 2 GiB och 256 processer; Go bygger ett paket i taget. Packningen körs fortfarande på hosten, utanför de gränserna.	av

Bygget körs i projektets fastlåsta Go-byggimage utan nätverk, så det laddar inte ner något. Modulcachen monteras skrivskyddad. Om något mål misslyckas lämnas ingen utdatamapp kvar. Committen läggs till i versionsnumret och byggs in i programmet; appen och dess backuper rapporterar den.

Vad ett arkiv innehåller

Programmet, licensen, meddelanden om tredjepartskod, guider, en källmanifestfil och paketidentiteten. Ett separat källarkiv innehåller projektets källkod och Go-beroenden; behåll det bredvid binärerna.

SHA256SUMS bevisar att filerna stämmer. Det är inte en signatur. Samma commit, version och indata ger samma arkiv, så du kan bygga om för att kontrollera.

Körningsanteckningar

Ämne	Detalj
Konfigurationssökväg	Standard /config. Ange alltid -config, på en lokal disk.
Minnesmål	384 MiB utan GOMEMLIMIT. Sätt det till ungefär 80 procent av det minne du ger. Ett mål, inte en hård gräns.
Läge för lite minne	På Linux slås det på av sig självt vid ungefär 2,5 GiB eller mindre; målet sjunker till en fjärdedel av minnet, mellan 192 och 384 MiB. HOLYARRS_LOW_MEMORY=1 eller 0 avgör.
Node	Behövs inte för att köra.
Hardlinks	Behåll nedladdningar och biblioteksmappar på ett filsystem.

Relaterat

• Installation
• Delar och felsäkert läge
• Uppdateringar