Skip to content

Installation

Jump to bottom
Stas Dmytryshyn edited this page Jul 5, 2025 · 11 revisions

Setup

The easiest way to set up Go-Money is via a Docker image and a Docker Compose file.

An example docker-compose.yaml file is hosted under the "compose" folder of the repository

Quick Start

Requirements

  • docker
  • docker compose
  • git
git clone https://github.com/ft-t/go-money
cd go-money/compose/
cp .env.example .env
<configure your instance, refer to configuration section> (nano\vi .env)
docker compose up -d

Configuration

  1. You will need to copy .env.example to .env and adjust it according to your environment.

  2. By default, .env file contains a reference to the latest tag, but you can fetch a specific tag version from Repository

  3. You can configure GO_MONEY_EXTERNAL_HOST and GRAFANA_EXTERNAL_HOST to your public domain, so Traefik (router/lb) will route traffic via the internal Docker network.

    1. If you don't want to use Traefik, you can expose the app directly in docker-compose.yaml. By default, it's exposed on 127.0.0.1 and port GRPC_PORT = 52055
    2. Grafana is also exposed on 127.0.0.1 and port GRAFANA_PORT = 3000

  4. Your instance, by default,t will be exposed on port :80 (HTTP) via Traefik, If you need to adjust that, you can change PUBLIC_PORT to any other port

Please make sure to change GRAFANA_ADMIN_PASSWORD and DB_PASSWORD to your values.

Architecture and components overview

https://github.com/ft-t/go-money/wiki/Architecture

Security

Please check the security guide https://github.com/ft-t/go-money/wiki/Security

Advanced configuration

A list of all environment variables can be extracted from Go configuration structure Struct

Example env variables are:

GRPC_PORT=12562

GRAFANA_CONFIG_URL=https://mygrafana.url

Clone this wiki locally