Global Settings

Global Settings allow administrators to configure system-wide behaviors and settings for the Gigantics instance. This panel is accessible only to users with Root privileges.

Be careful with these options. Any alteration or misconfiguration can make the instance work incorrectly.

Accessing Global Settings

To access the Global Settings:

Click on your user avatar in the upper right corner of the interface
Select Global Settings from the dropdown menu

The Global Settings panel contains several sections organized in a sidebar menu:

General - Basic system configuration
Authentication - User authentication and login methods
Licensing - License management and configuration
About - System information and version details

General Settings

The General tab contains basic system configuration options that affect how the instance operates.

Server Configuration

Field	Description	Example
Server	Base URL for your Gigantics instance	`https://yourserver/`

Email Configuration

Field	Description	Example
Email Server	SMTP server address for sending notifications	`smtp.yourserver.com`

User Permissions

Configure what users can do within the system:

Setting	Description	Default
User can leave organizations	Allows regular users to leave organizations they belong to	Enabled
Admin users can delete projects	Grants permission to admin users to delete projects	Enabled

System Limits

Set operational limits for the system:

Setting	Description	Default
Owner can limit the number of users on projects	Allows project owners to set user limits on their projects	Enabled
Only owners and admins can install plugins	Restricts plugin installation to privileged users only	Enabled

To apply most changes, it's necessary to restart the server using gig restart.

Authentication Settings

Configure how users authenticate and access the system.

Third-Party Authentication Providers

Enable or disable authentication through external services. Each provider works independently:

Provider	Description	Required Settings
Google	Allow users to sign in with Google accounts	Client ID, Client Secret
GitHub	Allow users to sign in with GitHub accounts	Client ID, Client Secret
Slack	Allow users to sign in with Slack accounts	Client ID, Client Secret

Obtaining OAuth Credentials

To enable third-party authentication, you'll need to obtain Client ID and Client Secret from each provider:

Google: Using OAuth 2.0 to Access Google APIs ↗
GitHub: Connect your app to GitHub ↗
Slack: Slack - Using OAuth 2.0 ↗

User Registration

Control how new users can register on the platform:

Setting	Description	Configuration
Enable Signup	Allow new user registration	Toggle On/Off
Custom Domains	Restrict registration to specific email domains	Comma-separated domains

Domain Restriction Examples

mycompany.com
mycompany.*
*.mycompany-*.com
domain1.com, domain2.org

LDAP Authentication

Integrate with your existing LDAP directory for user authentication:

Setting	Description	Example
LDAP Server	LDAP server hostname or IP	`ldap.yourserver.com`
LDAP Port	Port number for LDAP connection	`389` or `636`
Bind DN	Distinguished name for LDAP bind	`cn=admin,dc=yourserver,dc=com`
Bind Password	Password for LDAP bind account	••••••••
Base DN	Base DN for user searches	`ou=users,dc=yourserver,dc=com`
User Filter	LDAP filter for finding users	`(uid={username})`

If you are going to use LDAP, we recommend disabling sign up as well as registration through third party applications.

Licensing Settings

Manage licenses for your Gigantics instance and connected components.

License Types

License Type	Description	Usage
Server License	Main Gigantics server license	Required for server operation
Tap Licenses	Data source connector licenses	Per-driver licensing

License Actions

Action	Description	When to Use
Add License	Install a new license key	When adding new features or users
Validate License	Check license validity and compliance	For compliance verification
Remove License	Deactivate an unused license	When decommissioning features

License Tiers

Different tiers provide access to different features and capacities:

Tier	Features	User Limits	Driver Support
Basic	Core functionality	Limited	Essential drivers
Professional	Advanced features	Higher limits	Extended driver support
Enterprise	Full feature set	Unlimited	All drivers

About

View system information and version details:

Information	Description
Version	Current Gigantics version number
Build Information	Build date and commit hash
License Information	Current license status and terms
System Resources	Memory and CPU usage information

System information can be useful for troubleshooting and when contacting support.

Best Practices

Configuration Management

Document Changes: Keep a record of configuration changes and their rationale
Test Settings: Apply changes in a test environment before production
Backup Configuration: Export configuration settings before major changes

Security Considerations

Principle of Least Privilege: Only enable features and permissions that are actually needed
Regular Review: Periodically review authentication methods and user permissions
Monitor Access: Keep an eye on system events and access patterns

Performance Optimization

License Management: Regularly review and optimize license usage
User Limits: Set appropriate user limits based on your hardware capacity
Plugin Control: Limit plugin installation to maintain system stability

Troubleshooting

Common Issues

Issue	Potential Cause	Solution
Settings not applied	Server restart required	Run `gig restart` to apply changes
LDAP authentication fails	Incorrect bind credentials	Verify LDAP server connection and credentials
License validation errors	Invalid or expired license	Check license key and expiration date
Users cannot register	Domain restrictions too strict	Review domain restriction patterns

Getting Help

If you encounter issues with Global Settings:

Check the System Events for error messages
Verify your configuration settings
Consult the official documentation at https://gigantics.io/docs/
Contact support with system information from the About tab

Always backup your data and configuration before making significant changes to Global Settings.

Tabla de Contenidos