Server Configuration

Configure the server settings for your Gigantics instance, including host, port, and base URL.

Configuration Properties

The server configuration section in your config/default.yaml file controls how the Gigantics web server operates:

server:
  baseUrl: 'http://localhost:5000'
  host: localhost
  port: 5000

Property Details

baseUrl

• Type: String
• Default: 'http://localhost:5000'
• Description: The base URL where your Gigantics instance will be accessible. This is used for generating links in emails and other absolute URLs.

host

• Type: String
• Default: 'localhost'
• Description: The hostname or IP address the server will bind to. Use '0.0.0.0' to bind to all available interfaces.

port

• Type: Number
• Default: 5000
• Description: The port number the server will listen on.

Examples

Development Configuration

server:
  baseUrl: 'http://localhost:5000'
  host: localhost
  port: 5000

Production Configuration

server:
  baseUrl: 'https://gigantics.yourcompany.com'
  host: '0.0.0.0'
  port: 80

Custom Port Configuration

server:
  baseUrl: 'http://your-server:3000'
  host: '0.0.0.0'
  port: 3000

Best Practices

1. Development vs Production: Use different settings for development and production environments
2. Security: In production, always set a proper baseUrl with HTTPS
3. Accessibility: Use host '0.0.0.0' if you want the server to be accessible from other machines
4. Port Selection: Choose an appropriate port that doesn't conflict with other services

Testing Configuration Changes

After modifying server configuration, restart the application:

./gig stop
./gig start

Then verify the server is running on the specified host and port.