https://github.com/tobru/keybox-openshift
KeyBox on OpenShift
https://github.com/tobru/keybox-openshift
docker docker-image dockerfile keybox openshift openshift-templates
Last synced: 3 months ago
JSON representation
KeyBox on OpenShift
- Host: GitHub
- URL: https://github.com/tobru/keybox-openshift
- Owner: tobru
- License: mit
- Created: 2017-09-27T20:11:13.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2017-09-28T11:45:39.000Z (about 8 years ago)
- Last Synced: 2025-07-14T00:11:21.377Z (3 months ago)
- Topics: docker, docker-image, dockerfile, keybox, openshift, openshift-templates
- Language: Smarty
- Size: 10.7 KB
- Stars: 0
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# KeyBox in Docker and OpenShift
[](https://hub.docker.com/r/tobru/keybox/)
[](https://hub.docker.com/r/tobru/keybox/)
This repository provides a Dockerfile and an OpenShift template
for [KeyBox](https://github.com/skavanagh/KeyBox).
**Please note**: KeyBox runs without TLS! Terminating TLS is the job of the
loadbalancer / reverse proxy in front of it (like the OpenShift router).
## Docker run
Example for running KeyBox in Docker:
```
docker build -t local/keybox .
docker run --name keybox \
-d \
--user 1000001:root \
-e DB_PASSWORD=blablubb \
-p 8080:8080 \
-v keybox_data:/opt/keybox/jetty/keybox/WEB-INF/classes/keydb \
local/keybox
```
## Configuration
On startup the KeyBox configuration file `KeyBoxConfig.properties` is
generated by `dockerize`. The only mandatory paramater is
`DB_PASSWORD` or else the container won't start properly.
To see the defaults and available parameters, have a look into
`KeyBoxConfig.properties.tpl`.
## Deploy on OpenShift
### 0 Create OpenShift project
Create an OpenShift project if not already provided by the service
```
PROJECT=keybox
oc new-project $PROJECT
```
### 1 Deploy KeyBox
```
oc process -f https://raw.githubusercontent.com/tobru/keybox-openshift/master/keybox-template.yaml | oc -n $PROJECT create -f -
```
### 2 Configure KeyBox
Navigate to the generated URL and login with the KeyBox default credentials.
Change the admin password now!
**Hint**
The template is configured with an `emptyDir` storage. You might want to
replace this with a persistent storage volume (PVC) or else you'll lose
your configuration when the Pod restarts.
## Maintenance of this Repo
This repo triggers an automated Docker Hub build and always builds the latest
tag from master - there is no release process involved. If a new KeyBox
release is available, the Dockerfile needs to be updated and pushed.
This will only be done occasionally. So if it's not done in time, feel
free to send a PR - this can speed up things.