Basic Auth is the easiest way to get started with GiiS. However, we recommend using Google OAuth, OIDC, or SAML for production deployments.

TIP

If you have questions about which authentication approach is best for your organization, don't hesitate to contact us

• we're happy to help you choose the right solution.

Basic Setup

Using Docker:

In your .env file, set:

AUTH_TYPE=basic

Using Helm:

In your values.yaml file, set:

configMap:
  AUTH_TYPE: basic

If you don't need email verification, you're done!

Restart GiiS to apply the changes and the next time you visit the site, you'll be prompted to create an account and set a password.

• 12+ characters
• 1 number
• 1 special character
• 1 uppercase letter
• 1 lowercase letter

Basic Auth with Email Verification

Enabling email verification blocks your users from signing in until they click their verification email.

Using Docker:

Set the following in your .env file:

AUTH_TYPE=basic

# Enable email verification
REQUIRE_EMAIL_VERIFICATION=true

# Email configuration
SMTP_USER=  # e.g. noreply@yourcompany.com
SMTP_PASS=

# Required for non-Gmail accounts
SMTP_SERVER=
SMTP_PORT=  # default: 587

Using Helm:

Set the following in your values.yaml file:

auth:
  secrets:
      smpt_pass: 
configMap:
  AUTH_TYPE: basic

  REQUIRE_EMAIL_VERIFICATION: true
  SMTP_USER: 

  # Required for non-Gmail accounts
  SMTP_SERVER: 
  SMTP_PORT:

Next Steps

Google OAuth is a secure and easy way to authenticate users with their Google accounts.

There are many other configuration options available for GiiS.