Skip to content

index.md

Latest commit

 

History

History
47 lines (32 loc) · 1.22 KB

index.md

File metadata and controls

47 lines (32 loc) · 1.22 KB
Raw

Developer guide

Development uses the same appliance contract as production.

Start

docker compose \
  -f compose.yaml \
  -f compose.dev.yaml \
  up --build

Open:

http://localhost:8080

Retrieve the first-run password:

docker compose \
  -f compose.yaml \
  -f compose.dev.yaml \
  logs truthgate

Guides

Important local rule

Do not run another Kubo/IPFS Desktop node on the same machine with the default ports while debugging TruthGate. Both will normally want swarm TCP and UDP port 4001, and conflicting local gateways or RPC assumptions can make failures confusing.

Stop the other node or deliberately change the development swarm host port.

Source layout principle

Production behavior belongs in the production definitions and source. Development overrides should only change what is required to develop.

A feature that needs a new environment variable, port, volume, or runtime dependency should normally be added to compose.yaml first and then adjusted in compose.dev.yaml only when development differs.