README.md

🌸 Blossom-server

blossom-server is a Typescript implementation of a Blossom Server

Running with npx

This app is also packaged as an npm module which you can easily run

# copy the example config
wget https://raw.githubusercontent.com/hzrd149/blossom-server/master/config.example.yml -O config.yml
# run using npx
npx blossom-server-ts

Or you can install the module using npm or yarn

# npm
npm install
./node_modules/.bin/blossom-server-ts

# yarn
yarn add blossom-server-ts
yarn run blossom-server-ts

Running with docker

An example config file can be found here

# create data volume
docker volume create blossom_data
# run container
docker run -v blossom_data:/app/data -v $(pwd)/config.yml:/app/config.yml -p 3000:3000 ghcr.io/hzrd149/blossom-server:master

You can also run it using docker compose with the docker-compose.yml file

Running from source

This project uses yarn to manage dependencies. It needs to be installed first in order to build the app

Next clone the repo, install the dependencies, and build

git clone https://github.com/hzrd149/blossom-server.git
cd blossom-server
yarn install
cd admin && yarn install && cd ../
yarn build

Next copy the config and modify it

cp config.example.yml config.yml
nano config.yml

And finally start the app

yarn start
# or
node .

Once the server is running you can open http://localhost:3000 to access the server