5

Running docker container with non root user

St. Veit edited this page 2023-09-23 08:01:33 +02:00

By default vaultwarden/server is using root user to run service inside the container. There are few things you need to set to run the container as non-root user if you wish to do so:

1. Make sure that the directory, you're mounting inside the container will be writable by the user. For example if you decide to run as nobody, the directory needs to be writable by user with id 65534. For other ways to specify user inside the container, see the docker documentation, in our examples here we will use nobody.

# Make the directory on the host, change this to you preferred path
sudo mkdir /vw-data

# Set the owner using user id. 
# Note that the ownership must match user in /etc/passwd *inside* the container, not on your host
sudo chown 65534 /vw-data

# Give the owner full rights to the folder
sudo chmod u+rwx /vw-data

2. Start the container with proper parameters. Define the user and make sure to start with port set to 1024 or higher.

docker run -d \
  --name vaultwarden \
  --user nobody \
  -e ROCKET_PORT=1024 \
  -v /vw-data/:/data/ \
  -p 80:1024 \
  vaultwarden/server:latest

Notice that the port mapping (-p 80:1024) reflects the ROCKET_PORT setting.

Another way may be CAP_NET_BIND_SERVICE, which allows to bind to ports below 1024 as non-root user.

cap_add:
  - CAP_NET_BIND_SERVICE
user: nobody

FAQs

1. FAQs
2. Audits
3. Supporting upstream development

Troubleshooting

1. Logging
2. Bitwarden Android troubleshooting

Container Image Usage

1. Which container image to use
2. Starting a container
3. Using Docker Compose
4. Using Podman
5. Updating the vaultwarden image

Reverse Proxy

1. Proxy examples
2. Using an alternate base dir (subdir/subpath)

HTTPS

1. Enabling HTTPS
2. Running a private vaultwarden instance with Let's Encrypt certs

Configuration

1. Overview
2. Enabling admin page
3. SMTP configuration
4. Disable registration of new users
5. Disable invitations
6. Enabling WebSocket notifications
7. Enabling Mobile Client push notification
8. Other configuration

Database

1. Using the MariaDB (MySQL) Backend
2. Using the PostgreSQL Backend
3. Running without WAL enabled
4. Migrating from MariaDB (MySQL) to SQLite

Security

1. Hardening Guide
2. Password hint display
3. Enabling U2F and FIDO2 WebAuthn authentication
4. Enabling YubiKey OTP authentication
5. Fail2Ban Setup
6. Fail2Ban + ModSecurity + Traefik + Docker

Performance

1. Changing the API request size limit
2. Changing the number of workers

Customization

1. Translating the email templates
2. Translating admin page
3. Customize Vaultwarden CSS
4. Disabling or overriding the Vault interface hosting

Backup

1. General (not docker)
2. Backing up your vault

Development

1. Building binary
2. Building your own docker image
3. Git hooks
4. Differences from the upstream API implementation

Alternative deployments

1. Pre-built binaries
2. Creating a systemd service
3. Third-party packages
4. Deployment examples
5. Disable the admin token

Other Information

1. Importing data from Keepass or KeepassX
2. Changing persistent data location
3. Syncing users from LDAP
4. Caddy 2.x with Cloudflare DNS
5. Logrotate example