Skip to content

Latest commit

 

History

History
39 lines (27 loc) · 1.94 KB

soft-serve.md

File metadata and controls

39 lines (27 loc) · 1.94 KB

Soft Serve

Soft Serve is a tasty, self-hostable Git server for the command line.

Configuration

To enable this service, add the following configuration to your vars.yml file and re-run the installation process:

########################################################################
#                                                                      #
# soft-serve                                                           #
#                                                                      #
########################################################################

soft_serve_enabled: true

# The hostname of this system.
# It will be used for generating git clone URLs (e.g. ssh://mash.example.com/repository.git)
soft_serve_hostname: mash.example.com

# Expose Soft Serve's port. For git servers the usual git-over-ssh port is 22
soft_serve_container_bind_port: 2222

# This key will be able to authenticate with ANY user until you configure Soft Serve
soft_serve_initial_admin_key: YOUR PUBLIC SSH KEY HERE

########################################################################
#                                                                      #
# /soft-serve                                                          #
#                                                                      #
########################################################################

Usage

After you've installed Soft Serve, you can ssh [email protected] -p 2222 with the SSH key defined in soft_serve_initial_admin_key to see its TUI and follow the instructions to configure Soft Serve further.

Note that you have to finish the configuration yourself, otherwise any user with soft_serve_initial_admin_key will work as an admin.