/vaultwarden-startos

wrapper for building bitwarden.s9pk

Primary LanguageShellGNU Affero General Public License v3.0AGPL-3.0

Project Logo

Vaultwarden for StartOS

Vaultwarden is a lightweight and secure password manager for storing and auto-filling sensitive information such as usernames and passwords, credit cards, identities, and notes. It is an alternative implementation of the Bitwarden server API written in Rust and compatible with upstream Bitwarden clients. This repository creates the s9pk package that is installed to run Vaultwarden on StarOS.

Dependencies

Install the system dependencies below to build this project by following the instructions in the provided links. You can also find detailed steps to setup your environment in the service packaging documentation.

Cloning

Clone the project locally:

git clone git@github.com:Start9Labs/vaultwarden-startos.git
cd vaultwarden-startos

Building

After setting up your environment, build the vaultwarden package by running:

make

To build the vaultwarden package for a single platform, run:

# for amd64
make x86

or

# for arm64
make arm

Installing (on StartOS)

Before installation, define host: https://server-name.local in your ~/.embassy/config.yaml config file then run the following commands to determine successful install:

ℹ️ Change server-name.local to your Start9 server address

start-cli auth login
#Enter your StartOS password
make install

Tip: You can also install the vaultwarden.s9pk by sideloading it under the StartOS > System > Sideload a Service section.

Verify Install

Via the StartOS web-UI, select Services > Vaultwarden, configure and start the service. Then, verify its interfaces are accessible.

Done!