Skip to content

Getting started (User)

Pre-requisites

  • OpenJDK 1.8
  • Set the JAVA_HOME variable to point to your Java installation.
  • Set the PATH variable to include $JAVA_HOME/bin.

System Requirements

In order to run Strongbox you need to have a machine with minimum:

  • 6-8 GB RAM
  • 2 cores
  • Disk space would vary based on your caching needs

Installation

Download strongbox

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# Open a terminal

sudo su

mkdir /opt/strongbox /opt/strongbox-vault

groupadd strongbox
useradd -d /opt/strongbox -g strongbox -r strongbox

chown -R strongbox:strongbox /opt/strongbox /opt/strongbox-vault

chmod -R 770 /opt/strongbox /opt/strongbox-vault

su strongbox
tar -zxf /path/to/strongbox-distribution*.tar.gz \
    -C /opt/strongbox \ 
    --strip-components=2

# If you just want to start Strongbox without installing the systemd service:

/opt/strongbox/bin/strongbox console

# If you want to install Strongbox as a service then download the 
# systemd service file. Make sure to change the `Environment` variables 
# in the service file where necessary. Depending on your distribution, 
# you could also move the environment variables into `EnvironmentFile` 
# and load that instead.

sudo curl -o /etc/systemd/system/strongbox.service \
     https://strongbox.github.io/assets/resources/systemd/strongbox.service 
sudo systemctl deamon-reload
sudo service strongbox start

# this step is optional: only if you want to start Strongbox at boot!
sudo systemctl enable strongbox
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
# Open a terminal

# First, make sure you have a JRE with version 1.8
# installed on your system.  You can use your favorite package manager
# to find one.

sudo rpm -ivh /path/to/strongbox-distribution-*.rpm

# If you just want to start Strongbox without installing the systemd service:
su strongbox
/opt/strongbox/bin/strongbox console

# If you want to configure strongbox to start at system, boot:

sudo systemctl enable strongbox.service
sudo service strongbox start
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
# Open a terminal

# First, make sure you have a JRE with version 1.8
# installed on your system.  You can use your favorite package manager
# to find one.

# Install:
sudo dpkg -i /path/to/strongbox-*.deb

# If you just want to start Strongbox without installing the systemd service:
su strongbox
/opt/strongbox/bin/strongbox console

# If you want to configure strongbox to start at system, boot:
sudo systemctl enable strongbox
sudo systemctl start strongbox

# Remove the package:
sudo dpkg -r strongbox

# Purge configuration files, note this does not remove strongbox-vault:
sudo dpkg -P strongbox
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# Unzip the distribution.

# To start Strongbox, run cmd or PowerShell and execute:
c:\java\strongbox> bin\strongbox.bat console
      wrapper   | Strongbox: Distribution started...

# To install Strongbox as a service, run cmd or PowerShell and execute:
c:\java\strongbox> bin\strongbox.bat install
      wrapper  | Strongbox: Distribution installed.
c:\java\strongbox> bin\strongbox.bat start
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# Open a terminal

sudo su
sysadminctl -addUser strongbox

mkdir -p /opt/strongbox /opt/strongbox-vault

chown -R strongbox:staff /opt/strongbox /opt/strongbox-vault

chmod -R 770 /opt/strongbox /opt/strongbox-vault

su strongbox
tar -zxf /path/to/strongbox-distribution*.tar.gz \
    -C /opt/strongbox \ 
    --strip-components=2

# If you just want to start Strongbox without installing the launchctl service:

/opt/strongbox/bin/strongbox console

# If you want to install Strongbox as a LaunchDaemon then download the 
# plist file. If you've customized the installation, edit the details
# in the plist file where necessary.
# (This file must be owned by root.)
sudo curl -o /Library/LaunchDaemons/strongbox.plist \
     https://strongbox.github.io/assets/resources/launchctl/strongbox.plist

# This will validate that launchd can load the file and start the service.
sudo launchctl load /opt/strongbox/etc/strongbox.plist

# Strongbox will now start on boot.
1
2
3
4
5
Currently unavailable due to our heavy development.
We are planning to start releasing to hub.docker.com very soon.

Meanwhile, you could clone strongbox/strongbox 
use `docker-compose up` instead.

Last update: 2020-12-07