Skip to content

Stargazer

services.stargazer.certLifetime

How long certs generated by Stargazer should live for. Certs live forever by default.

Type: string

Default

""

Example

"1y"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.certOrg

The name of the organization responsible for the X.509 certificate's /O name.

Type: string

Default

"stargazer"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.connectionLogging

Whether or not to log connections to stdout. Type: boolean

Default

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.debugMode

Run Stargazer in debug mode. Type: boolean

Default

false

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.enable

Whether to enable Stargazer Gemini server. Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.genCerts

Set to false to disable automatic certificate generation. Use if you want to provide your own certs.

Type: boolean

Default

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.group

Group account under which stargazer runs. Type: string

Default

"stargazer"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.ipLog

Log client IP addresses in the connection log. Type: boolean

Default

false

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.ipLogPartial

Log partial client IP addresses in the connection log. Type: boolean

Default

false

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.listen

Address and port to listen on.

Type: list of string

Default

[ "0.0.0.0" ] ++ lib.optional config.networking.enableIPv6 "[::0]"

Example

[ "10.0.0.12" "[2002:a00:1::]" ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.regenCerts

Set to false to turn off automatic regeneration of expired certificates. Use if you want to provide your own certs.

Type: boolean

Default

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.requestTimeout

Number of seconds to wait for the client to send a complete request. Set to 0 to disable.

Type: signed integer

Default

5

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.responseTimeout

Number of seconds to wait for the client to send a complete request and for stargazer to finish sending the response. Set to 0 to disable.

Type: signed integer

Default

0

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.routes

Routes that Stargazer should server.

Expressed as a list of attribute sets. Each set must have a key route that becomes the section name for that route in the stargazer ini cofig. The remaining keys and values become the parameters for that route.

Refer to upstream docs for other params

Type: list of (attribute set of (INI atom (null, bool, int, float or string)))

Default

[ ]

Example

[{route = "example.com";root = "/srv/gemini/example.com"}{route = "example.com:/man";root = "/cgi-bin";cgi = true;}{route = "other.org~(.*)";redirect = "gemini://example.com";rewrite = "\1";}]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.routes.*.route

Route section name Type: string

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.store

Path to the certificate store on disk. This should be a persistent directory writable by Stargazer.

Type: path

Default

/var/lib/gemini/certs

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix

services.stargazer.user

User account under which stargazer runs. Type: string

Default

"stargazer"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/web-servers/stargazer.nix