Linux Standard Deployment

Den här artikeln går igenom proceduren för att installera och distribuera Bitwarden till din egen Linux-server. Bitwarden kan också installeras och distribueras på Windows-maskiner. Vänligen granska Bitwarden-programvaruversionens supportdokumentation.

ª - Docker Compose installeras automatiskt som en plugin när du laddar ner Docker Engine.

Följande är en sammanfattning av installationsproceduren i den här artikeln. Länkarna i det här avsnittet hoppar till detaljerade avsnitt om installationsprocedur:

1. Konfigurera din domän. Ställ in DNS-poster för ett domännamn som pekar på din maskin och öppna portarna 80 och 443 på maskinen.

2. Installera Docker och Docker Compose på din maskin.

3. Skapa en Bitwarden-användare och katalog för att slutföra installationen.

4. Hämta ett installations-id och nyckel från https://bitwarden.com/host för användning i installationen.

   För mer information, se Vad används mitt installations-id och installationsnyckel till?

5. Installera Bitwarden på din maskin.

6. Konfigurera din miljö genom att justera inställningarna i ./bwdata/env/global.override.env.

   tip

   Konfigurera som ett minimum variablerna globalSettings__mail__smtp... för att ställa in en e-postserver för att bjuda in och verifiera användare.

7. Starta din instans.

8. Testa din installation genom att öppna din konfigurerade domän i en webbläsare.

9. När den väl har distribuerats rekommenderar vi att du regelbundet säkerhetskopierar din server och letar efter systemuppdateringar.

Som standard kommer Bitwarden att betjänas via portarna 80 (http) och 443 (https) på värddatorn. Öppna dessa portar så att Bitwarden kan nås inifrån och/eller utanför nätverket. Du kan välja att välja olika portar under installationen.

Vi rekommenderar att du konfigurerar ett domännamn med DNS-poster som pekar på din värddator (till exempel bitwarden.example.com), särskilt om du betjänar Bitwarden över internet.

Bitwarden kommer att distribueras och köras på din maskin med hjälp av en mängd Docker-behållare. Bitwarden kan köras med vilken Docker-utgåva eller plan som helst. Utvärdera vilken utgåva som är bäst för din installation. Distribution av containrar orkestreras med Docker Compose. Docker Compose installeras automatiskt som en plugin när du laddar ner Docker Engine.

Ladda ner Docker Engine för Linux.

Vi rekommenderar att du konfigurerar din Linux-server med ett dedikerat bitwarden-tjänstkonto, från vilket du kan installera och köra Bitwarden. Om du gör det isolerar du din Bitwarden-instans från andra applikationer som körs på din server.

Dessa steg är Bitwarden-rekommenderade bästa praxis, men är inte obligatoriska. För mer information, se Dockers efterinstallationssteg för Linux-dokumentation.

1. Skapa en bitwarden-användare:

   BashCopy
   sudo adduser bitwarden

2. Ange lösenord för bitwarden-användare (starkt lösenord):

   BashCopy
   sudo passwd bitwarden

3. Skapa en dockningsgrupp (om den inte redan finns):

   BashCopy
   sudo groupadd docker

4. Lägg till bitwarden-användaren till dockargruppen:

   BashCopy
   sudo usermod -aG docker bitwarden

5. Skapa en bitwarden-katalog:

   BashCopy
   sudo mkdir /opt/bitwarden

6. Ange behörigheter för katalogen /opt/bitwarden:

   BashCopy
   sudo chmod -R 700 /opt/bitwarden

7. Ställ in bitwarden-användaren som ägare av /opt/bitwarden-katalogen:

   BashCopy
   sudo chown -R bitwarden:bitwarden /opt/bitwarden

Bitwarden tillhandahåller ett skalskript för enkel installation på Linux och Windows (PowerShell). Slutför följande steg för att installera Bitwarden med hjälp av skalskriptet:

1. Ladda ner Bitwarden-installationsskriptet (bitwarden.sh) till din maskin:

   BashCopy
   curl -Lso bitwarden.sh "https://func.bitwarden.com/api/dl/?app=self-host&platform=linux" && chmod 700 bitwarden.sh

2. Kör installationsskriptet. En ./bwdata-katalog kommer att skapas i förhållande till platsen för bitwarden.sh.

   BashCopy
   ./bitwarden.sh install

3. Fyll i anvisningarna i installationsprogrammet:

   • Ange domännamnet för din Bitwarden-instans:

     Vanligtvis bör detta värde vara den konfigurerade DNS-posten.

   • Vill du använda Let's Encrypt för att generera ett gratis SSL-certifikat? (å/n):

     Ange y för att generera ett pålitligt SSL-certifikat med Let's Encrypt. Du kommer att bli ombedd att ange en e-postadress för utgångspåminnelser från Let's Encrypt. För mer information, se Certifikatalternativ.

     Alternativt, ange n och använd Har du ett SSL-certifikat att använda? alternativ.

   • Ange ditt installations-id:

     Hämta ett installations-id med en giltig e-post på https://bitwarden.com/host. För mer information, se vad används mitt installations-id och installationsnyckel till?

   • Ange din installationsnyckel:

     Hämta en installationsnyckel med en giltig e-post på https://bitwarden.com/host. För mer information, se Vad används mitt installations-id och installationsnyckel till?

   • Ange din region (USA/EU):
     Ange USA eller EU beroende på vilken molnserver du kommer att använda för att licensiera betalda funktioner, endast tillämpligt om du ansluter ett konto eller en organisation med egen värd till en betalprenumeration.

   • Har du ett SSL-certifikat att använda? (å/n):

     Om du redan har ditt eget SSL-certifikat, ange y och placera de nödvändiga filerna i katalogen ./bwdata/ssl/your.domain. Du kommer att tillfrågas om det är ett pålitligt SSL-certifikat (y/n). För mer information, se Certifikatalternativ.

     Alternativt, ange n och använd det självsignerade SSL-certifikatet? alternativ, som endast rekommenderas för teständamål.

   • Vill du generera ett självsignerat SSL-certifikat? (å/n):

     Ange y för att låta Bitwarden generera ett självsignerat certifikat åt dig. Det här alternativet rekommenderas endast för testning. För mer information, se Certifikatalternativ.

     Om du anger n kommer din instans inte att använda ett SSL-certifikat och du kommer att behöva fronta din installation med en HTTPS-proxy, annars kommer Bitwarden-applikationer inte att fungera korrekt.

Att konfigurera din miljö kan innebära att du gör ändringar i två filer; en miljövariabelfil och en installationsfil:

Miljövariabler (obligatoriskt)

Vissa funktioner i Bitwarden är inte konfigurerade av bitwarden.sh-skriptet. Konfigurera dessa inställningar genom att redigera miljöfilen, som finns på ./bwdata/env/global.override.env. Som ett minimum bör du ersätta värdena för:

BashCopy
...
globalSettings__mail__smtp__host=<placeholder>
globalSettings__mail__smtp__port=<placeholder>
globalSettings__mail__smtp__ssl=<placeholder>
globalSettings__mail__smtp__username=<placeholder>
globalSettings__mail__smtp__password=<placeholder>
...
adminSettings__admins=
...

Ersätt globalSettings__mail__smtp...= platshållare för att ansluta till SMTP-postservern som kommer att användas för att skicka verifieringsmail till nya användare och inbjudningar till organisationer. Om du lägger till en e-postadress till adminSettings__admins= tillhandahålls åtkomst till systemadministratörsportalen.

Efter att ha redigerat global.override.env, kör följande kommando för att tillämpa dina ändringar:

BashCopy
./bitwarden.sh restart

Installationsfil

Bitwardens installationsskript använder inställningar i ./bwdata/config.yml för att generera de nödvändiga tillgångarna för installationen. Vissa installationsscenarier (som installationer bakom en proxy med alternativa portar) kan kräva justeringar av config.yml som inte tillhandahålls under standardinstallationen.

Redigera config.yml vid behov och tillämpa dina ändringar genom att köra:

BashCopy
./bitwarden.sh rebuild

När du har slutfört alla tidigare steg, starta din Bitwarden-instans:

BashCopy
./bitwarden.sh start

Kontrollera att alla behållare körs korrekt:

BashCopy
docker ps

Grattis! Bitwarden är nu igång på din angivna domän (i exemplet ovan, https://bitwarden.example.com). Besök webbvalvet i din webbläsare för att bekräfta att det fungerar.

Du kan nu registrera ett nytt konto och logga in. Du måste ha konfigurerade smtp-miljövariabler (se Miljövariabler) för att verifiera e-postadressen för ditt nya konto.

• Om du planerar att själv vara värd för en Bitwarden-organisation, se självvärd för en organisation för att komma igång.

• För ytterligare information se vanliga frågor om självhotell.

Bitwardens installationsskript (bitwarden.sh eller bitwarden.ps1) har följande kommandon tillgängliga: