Install

You can find binaries for RapidForge in the releases page. Contact us if you need binaries for other platforms. You can either ran binary directly or use docker image. For our internal use we use following docker image but you can use any image you want with any tools that is installed.

FROM debian:latest

# sqlite3 is required if you want Key-Value store to work
RUN apt-get update && apt-get install -y \
    ca-certificates \
    curl \
    jq \
    sqlite3 \
    tar \
    && rm -rf /var/lib/apt/lists/*

WORKDIR /app

# Fetch the latest version dynamically from GitHub
ARG ARCH="x86_64"
ARG PLATFORM="Linux"
ARG BINARY_NAME="rapidforge"
RUN VERSION=$(curl -s https://api.github.com/repos/rapidforge-io/release/releases/latest | jq -r '.tag_name') && \
    TARBALL="${BINARY_NAME}_${PLATFORM}_${ARCH}.tar.gz" && \
    curl -L "https://github.com/rapidforge-io/release/releases/download/${VERSION}/${TARBALL}" -o ${TARBALL} && \
    tar -xzvf ${TARBALL} && \
    chmod +x ${BINARY_NAME} && \
    rm ${TARBALL}

ARG PORT=8080
ENV RF_PORT=$PORT
EXPOSE ${PORT}

CMD ["./rapidforge"]

Configuration

RapidForge is minimally configured software. When RapidForge is ran for the first time it will create username and password for admin user. This will be printed out in logs only for the first time. After that its high recommended to change the password. RapidForge allows user to retrying login only for 5 times. After that user will be forced out of the system. In order to gain access user needs to contact with another admin to restart retries vai user panel.

Environment Variable Default Value Description
RF_DATABASE_URL rapidforge.sqlite3 Database URL
RF_KV_URL None Key-Value store URL
RF_DOMAIN localhost Domain name
RF_PORT :4000 Port number
TLS_CERT None PEM-encoded certificate data