Project

General

Profile

Wiki » History » Version 5

Gareth Eaton, 07/15/2023 12:20 AM

1 1 Gareth Eaton
h1. Wiki
2
3
Install
4
5
To install Bitwarden on a Proxmox server, you can follow these general steps:
6
7
1. Set up a Linux container (LXC) on your Proxmox server. Bitwarden supports various Linux distributions, such as Ubuntu or Debian, so you can choose the one you are most comfortable with. For example, if you want to use Ubuntu, you can create an Ubuntu LXC container.
8
9
2. Once the LXC container is created, log in to the container via SSH or the Proxmox web interface.
10
11
3. Update the package repositories and upgrade the system by running the following commands:
12 2 Gareth Eaton
13 1 Gareth Eaton
<pre>
14 2 Gareth Eaton
sudo apt update
15
sudo apt upgrade
16
</pre>
17 1 Gareth Eaton
18
4. Install the required dependencies. Bitwarden requires Docker and Docker Compose. Install them using the following commands:
19 2 Gareth Eaton
20 1 Gareth Eaton
<pre>
21 4 Gareth Eaton
sudo apt install docker.io -y && sudo apt install docker-compose
22 1 Gareth Eaton
</pre>
23
24
5. Start the Docker service:
25 2 Gareth Eaton
26 1 Gareth Eaton
<pre>
27 3 Gareth Eaton
sudo systemctl start docker
28 1 Gareth Eaton
</pre>
29
30
6. Create a directory to store the Bitwarden configuration and data:
31
32
<pre>
33 3 Gareth Eaton
sudo mkdir /opt/bitwarden
34 1 Gareth Eaton
</pre>
35
36
7. Change the ownership of the directory to the user running Docker:
37
38
<pre>
39 3 Gareth Eaton
sudo chown 1000:1000 /opt/bitwarden
40 1 Gareth Eaton
</pre>
41
42
8. Navigate to the Bitwarden directory:
43
44
<pre>
45 3 Gareth Eaton
cd /opt/bitwarden
46 1 Gareth Eaton
</pre>
47
48
9. Download the Bitwarden Docker Compose file:
49
50
<pre>
51
   sudo curl -Lso docker-compose.yml https://raw.githubusercontent.com/bitwarden/server/master/docker/docker-compose.yml
52
</pre>
53
54
10. Open the docker-compose.yml file using a text editor. For instance:
55
56
<pre>
57
sudo nano docker-compose.yml
58
</pre>
59
60
Add the following... if you want to make Bitwarden accessible at IP address 192.168.1.69, modify the ports configuration for the 
61
62
<pre>
63
services:
64
  '404':
65
    image: bitwarden/setup:latest
66
    # Rest of the service configuration
67
68
  bitwarden:
69
    image: bitwardenrs/server:latest
70
    container_name: bitwarden
71
    ports:
72 5 Gareth Eaton
      - 0.0.0.0:80:80
73 1 Gareth Eaton
    # Other configuration options for the Bitwarden service
74 5 Gareth Eaton
environment:
75
  - SIGNUPS_ALLOWED=true
76
  - DOMAIN=<your-domain>
77
  - SMTP_HOST=smtp.gmail.com
78
  - SMTP_PORT=587
79
  - SMTP_FROM=<your-email>
80
  - SMTP_FROM_NAME=Bitwarden
81
  - SMTP_SSL=true
82
  - SMTP_USERNAME=<your-smtp-username>
83
  - SMTP_PASSWORD=<your-smtp-password>
84
  - SMTP_AUTH=true
85
# Other configuration options for the Bitwarden service
86 1 Gareth Eaton
87
</pre>
88
89
90
91
92
11. Save and close the Docker Compose file.
93
94
12. Start the Bitwarden containers using Docker Compose:
95
96
Swich to the docker folder
97
98
<pre>
99
cd /opt/bitwarden
100
</pre>
101
102
<pre>
103
   sudo docker-compose up -d
104
</pre>
105
106
13. Wait for the containers to start and initialize. You can check the status by running:
107
108
<pre>
109
   sudo docker-compose ps
110
 </pre>
111
112
14. Once the containers are up and running, you should be able to access Bitwarden by visiting the IP address or domain name of your Proxmox server in a web browser. Make sure to use HTTPS for secure access.
113
114
That's it! You have successfully installed Bitwarden on your Proxmox server. Remember to configure any necessary firewall rules to allow external access to the Bitwarden service, and consider setting up SSL/TLS certificates for secure communication.
115
116
---
117
118
By default, the Bitwarden containers will not start automatically after a server reboot. However, you can configure them to start automatically on server boot by using systemd services.
119
120
Here's a step-by-step guide to setting up systemd services for Bitwarden:
121
122
Create a systemd service unit file for Bitwarden. Open a new file with a .service extension using a text editor, such as bitwarden.service:
123
124
125
<pre>
126
sudo nano /etc/systemd/system/bitwarden.service
127
</pre>
128
129
Add the following content to the bitwarden.service file. Make sure to adjust the paths based on your specific configuration:
130
131
<pre>
132
133
[Unit]
134
Description=Bitwarden Service
135
After=network.target
136
137
[Service]
138
Type=simple
139
ExecStart=/usr/bin/docker-compose -f /opt/bitwarden/docker-compose.yml up
140
WorkingDirectory=/opt/bitwarden
141
User=root
142
Restart=always
143
144
[Install]
145
WantedBy=multi-user.target
146
</pre>
147
148
Save the changes and exit the text editor.
149
150
Enable the systemd service to start on boot:
151
152
<pre>
153
154
sudo systemctl enable bitwarden.service
155
</pre>
156
157
Start the Bitwarden systemd service:
158
159
160
<pre>
161
sudo systemctl start bitwarden.service
162
</pre>
163
164
With these steps, the Bitwarden containers should now start automatically when the server reboots. The systemd service will ensure that the docker-compose up command is executed with the appropriate configuration.
165
166
You can use the following commands to manage the Bitwarden systemd service:
167
168
Start the service: sudo systemctl start bitwarden.service
169
170
Stop the service: sudo systemctl stop bitwarden.service
171
172
Restart the service: sudo systemctl restart bitwarden.service
173
174
Check the status of the service: sudo systemctl status bitwarden.service
175
176
Remember to adjust the paths and configurations in the bitwarden.service file to match your specific setup.
177
178
After configuring the systemd service, you can test it by rebooting the server and verifying that Bitwarden starts automatically.