# CLI flags always take precedence over values set here.

Runs SolidInvoice

Usage:
  SolidInvoice run [flags]

Flags:
      --disable-https           Disable HTTPS. The application will only be accessible using http://. This setting is not recommended, unless you are setting up a reverse proxy which will handle https. Combine with --domain to specify the hostname Caddy should accept when behind a reverse proxy (e.g. --disable-https --domain solidinvoice.example.com)
      --domain string           The domain name to use for the application. When specifying a domain, an SSL certificate will automatically be generated for you
      --enable-metrics          Enable Prometheus metrics endpoint on a dedicated port. Exposes Caddy HTTP metrics and FrankenPHP worker/thread metrics for scraping
  -h, --help                    help for run
      --lets-encrypt            Enable Let's Encrypt for automatic SSL certificates (requires --domain)
      --log-format string       Log output format: 'json' for structured JSON logs, or 'console' (default) for human-readable console output (default "console")
      --messenger-workers int   Number of messenger worker processes to spawn. Each worker processes async messages independently. Set to 0 to disable built-in workers entirely (recommended for Kubernetes, where a dedicated worker pod runs 'solidinvoice worker'). Increase above 1 for high-traffic standalone deployments (e.g., --messenger-workers=5) (default 1)
      --metrics-port int        Port for the Prometheus metrics endpoint (only used when --enable-metrics is set) (default 9090)
      --port string             The default port to use for the application. When specifying a domain to use, the port will default to 443 (default "8765")
      --server-ip string        If you have multiple IP addresses on your server, specify the IP address to use. By default, the server will bind to all IP addresses (default "10.89.58.3")
      --skip-intro              Skip the introductory application info message
      --ssl-cert string         Path to custom SSL certificate file (requires --ssl-key and --domain)
      --ssl-key string          Path to custom SSL private key file (requires --ssl-cert and --domain)
      --worker-mode             Enable FrankenPHP worker mode for improved performance (keeps PHP workers alive between requests). Recommended for SaaS/high-traffic deployments. Can also be enabled via FRANKENPHP_WORKER_MODE=1 environment variable
      --worker-threads int      Number of FrankenPHP worker threads when worker mode is enabled (default: 2) (default 2)

# 反向代理终止 TLS，应用只监听本机回环的 9000 端口
solidinvoice run --disable-https --port=9000 --log-format=json

# 独立暴露公网，自动 Let's Encrypt 证书 + Prometheus 指标
solidinvoice run --domain=invoice.example.com --lets-encrypt --enable-metrics

oauth
solidinvoice.decrypt.private.php
solidinvoice.encrypt.public.php
solidinvoice.list.php
solidinvoice.SOLIDINVOICE_APPLICATION_URL.170fd7.php
solidinvoice.SOLIDINVOICE_APP_SECRET.31f70b.php
solidinvoice.SOLIDINVOICE_BUILD_ID.276607.php
solidinvoice.SOLIDINVOICE_DATABASE_URL.86f089.php
solidinvoice.SOLIDINVOICE_ENABLE_TELEMETRY.3b5772.php
solidinvoice.SOLIDINVOICE_INSTALLED.c0d8a4.php
solidinvoice.SOLIDINVOICE_LOCALE.b96b2c.php

<?php

return [
    'SOLIDINVOICE_APPLICATION_URL' => null,
    'SOLIDINVOICE_APP_SECRET' => null,
    'SOLIDINVOICE_BUILD_ID' => null,
    'SOLIDINVOICE_DATABASE_URL' => null,
    'SOLIDINVOICE_ENABLE_TELEMETRY' => null,
    'SOLIDINVOICE_INSTALLED' => null,
    'SOLIDINVOICE_LOCALE' => null,
];

<?php // solidinvoice.SOLIDINVOICE_LOCALE.b96b2c on Sat, 24 Oct 2026 07:11:10 +0000

return "\x25\xA8\x0B\x8CL\x86\x40o\x5C\xA5\x91\xD8\xF3\xCD\x10\xF8\x8B\x0C_...";

<?php // solidinvoice.decrypt.private on Sat, 24 Oct 2026 07:10:33 +0000

// SYMFONY_DECRYPTION_SECRET=<base64 解密密钥，本文脱敏>
return "X\xC11\x80SiQ\x0C...";

solidinvoice console secrets:set SOLIDINVOICE_APPLICATION_URL

setting_key      varchar(191)   配置键（路径式命名，如 invoice/payment_terms）
setting_value    varchar(191)   配置值（NULL 表示未设置，走 default_value）
description      text           字段说明
field_type       varchar(191)   Symfony 表单类型全限定名（决定设置页的控件形态）
form_options     longtext       表单选项（JSON）
default_value    varchar(191)   默认值
company_id       binary(16)     公司标识（多公司隔离维度）

Description:
  Installs the application

Usage:
  solidinvoice:install [options]

Options:
      --database-driver=DATABASE-DRIVER      The database driver to use
      --database-host=DATABASE-HOST          The database host
      --database-port=DATABASE-PORT          The database port
      --database-name=DATABASE-NAME          The name of the database to use (will be created if it doesn't exist)
      --database-user=DATABASE-USER          The name of the database user
      --database-password=DATABASE-PASSWORD  The password for the database user
      --skip-user                            Skip creating the admin user
      --admin-password=ADMIN-PASSWORD        The password of admin user
      --admin-email=ADMIN-EMAIL              The email address of admin user
      --locale=LOCALE                        The locale to use
      --application-url=APPLICATION-URL      The URL where this SolidInvoice instance will be accessible (including protocol, e.g. https://invoices.example.com). Use `bin/console secrets:set SOLIDINVOICE_APPLICATION_URL` to update this after installation.
      --disable-telemetry                    Disable sending anonymous usage statistics
  -h, --help                                 Display help for the given command. When no command is given display help for the list command
      --silent                               Do not output any message
  -q, --quiet                                Only errors are displayed. All other output is suppressed
  -V, --version                              Display this application version
      --ansi|--no-ansi                       Force (or disable --no-ansi) ANSI output
  -n, --no-interaction                       Do not ask any interactive question
  -e, --env=ENV                              The Environment name. [default: "prod"]
      --no-debug                             Switch off debug mode.
      --profile                              Enables profiling (requires debug).
  -v|vv|vvv, --verbose                       Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug