dsfx/docs/hosting.md

Hosting

Installation

We currently support two installation methods for DSFX: Docker and manual installation.

Docker

pre-requisites:

• docker

To run DSFX using Docker, you first need to log into the gitea registry. You can do this with the following command.

export GITEA_PAT="hex string of pat created in gitea console"

echo $GITEA_PAT | docker login koti.casa -u <your-username> --password-stdin

Then, you can pull the DSFX image from the registry and run it.

docker run -d --name dsfx -p 8000:8000 koti.casa/numenorlabs/dsfx:latest

Manual Installation

pre-requisites:

• go

To install DSFX manually, you need to clone the repository and compile the code. You can do this with the following commands:

git clone https://koti.casa/numenor-labs/dsfx.git

cd dsfx

go build -o <installation-target> ./cmd/dsfx

Environment Variables

DSFX uses the following environment variables to configure its behavior:

Variable	Description	Default Value
DSFX_HOST	The host on which the DSFX server will run	0.0.0.0
DSFX_PORT	The port on which the DSFX server will listen	8000
DSFX_CONFIG_DIR	The directory where the DSFX configuration files are stored	/etc/dsfx/config
DSFX_STORAGE_DIR	The directory where the DSFX storage files are stored	/etx/dsfx/data