Function runStart

src/cli/commands/start.ts:71–141

(options: StartOptions, passthrough: string[])

}

export const runStart = async (options: StartOptions, passthrough: string[]): Promise<number> => {
  ensureNotRoot()

  const explicitPortFlag = process.argv.slice(2).some((arg) => arg === '--port' || arg.startsWith('--port='))
  const hasPort = typeof options.port === 'number' && Number.isFinite(options.port)
  if (explicitPortFlag && !hasPort) {
    throw new Error('Port must be a safe integer between 1 and 65535')
  }

  if (hasPort) {
    if (!Number.isSafeInteger(options.port) || options.port < 1 || options.port > 65535) {
      throw new Error('Port must be a safe integer between 1 and 65535')
    }
  }

  logStep('Preparing configuration')
  ensureConfigBootstrap()

  const composeFiles = ['docker-compose.yml']

  if (options.tor) {
    ensureTorDataDir()
    composeFiles.push('docker-compose.tor.yml')
  }

  if (options.i2p) {
    ensureI2PDataDir()
    composeFiles.push('docker-compose.i2p.yml')
  }

  if (options.nginx) {
    await ensureNginxBootstrap()
    composeFiles.push('docker-compose.nginx.yml')
  }

  let overrideFile: string | undefined
  if (hasPort) {
    overrideFile = createPortOverrideComposeFile(options.port)
    composeFiles.push(overrideFile)
  }

  const env: NodeJS.ProcessEnv = {}

  if (options.debug) {
    env.DEBUG = process.env.DEBUG || 'primary:*,worker:*,knex:*'
  }

  const spinner = ora('Starting relay...').start()
  const composePassthrough = passthrough.filter((arg) => arg !== '--')
  const upArgs = ['up', '--build', '--remove-orphans', ...(options.detach ? ['-d'] : []), ...composePassthrough]

  try {
    const code = await runDockerCompose({
      files: composeFiles,
      args: upArgs,
      env,
    })