Installation

Prerequisits

PostgreSQL database

Databucket works only with PosgreSQL server. It has been tested on PosgreSQL v13, but it should also works on verstion v10+. Before configuration, you need to create an empty database dedicated only for Databucket.

Databucket server JAR file.

You can download the latest Databucket server release from Releases page, or you can build it by yourself. The descrption how to do this you can find in the README.md.

Configuration

Before you run Databucket server using databucket-server-3.x.x.jar file, you need to prepare a configuration file and save it with the name application-profile_name.yaml, where profile_name is the name used in run command. You can use multiple such files with different profile names, e.g. application-test.yaml, application-prd.yaml alternately depending on your needs.

Here you can see an example base configuration:

jwt:
  secret: veryverysecret # a secret text to encrypt user's password (set once and don't change!)
  expire.hours: 24 # after what time the user's password expires

server:
  port: 8080 # Databucket server port
  servlet.context-path: / # Databucket url suffix. If your base Databucket url is localhost:8080/test, then this path should be set as /test

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/databucket # PosgreSQl connection string
    username: username # database user name
    password: userpassword # database user password

Running

Suppose you have the following files in your directory:

• application-dev.yaml
• databucket-3.0.0.jar

Then, from the command line, you need to run:

java -jar "-Dspring.profiles.active=dev" databucket-server-3.0.0.jar

Database initialization

The database is initialized during first Databucket startup. In this process, the application creates required tables and default user account with SUPER role. Use this account to create your personal account. After that, set this user as disabled.

Default user credentials:

• User name: super
• User password: super