find /var/lib/amusewiki -maxdepth 1 -name "*.yaml" -o -maxdepth 1 -name "*.conf" -o -maxdepth 1 -name "*.json" | sort

/var/lib/amusewiki/dbic.yaml
/var/lib/amusewiki/dbinfo.conf
/var/lib/amusewiki/fontspec.json
/var/lib/amusewiki/log4perl.conf

amusewiki restart

amusewiki clone-site export --directory /tmp/amw-export

Using directory /tmp/amw-export for output
Exported site amw to /tmp/amw-export/amw.yaml
Exported site demo to /tmp/amw-export/demo.yaml

amusewiki set-site-variable --help

Usage:
    Usage: amusewiki-set-site-variable [ --all | site_id site_id_2 ... ]
    --set name=value [ --set ... ]

    Set a site option from the command line. The site IDs should be passed
    as arguments, or you can use "--all" to affect all of them.

    The option name/value pairs should be passed to "--set" arguments as
    shown in the example.

    You can pass as many pairs you want.

    With the "--help" option, show this help and exit.

sub update_option_value {
    my ($self, $option, $value) = @_;
    die "Missing option name" unless $option;
    my %reserved = (id => 1,
                    mode => 1,
                    last_updated => 1);
    die "$option is reserved, please use the admin panel" if $reserved{$option};

# Normally you shouldn't need to change any of this.
name AmuseWikiFarm

<Model::Webserver>
    ## cgit port
    cgit_port 7015
    ## nginx log format
    log_format combined
    ## nginx root
    nginx_root /etc/nginx
    ## string to identify this installation
    instance_name amusewikidebian
    webserver_root /usr/share/perl5/AmuseWikiFarm/root
    fcgi_socket /var/lib/amusewiki/amusewiki.socket
</Model::Webserver>

amuse:
  dsn: 'dbi:SQLite:/var/lib/dbconfig-common/sqlite3/amusewiki/amusewiki'
  user: ''
  password: ''
  on_connect_do: 'PRAGMA foreign_keys = ON'
  AutoCommit: 1
  RaiseError: 1
  sqlite_unicode: 1
  quote_names: 1

dbc_install='true'
dbc_upgrade='true'
dbc_remove='true'
dbc_dbtype='sqlite3'
dbc_dbname='amusewiki'
dbc_basepath='/var/lib/dbconfig-common/sqlite3/amusewiki'

##
## database access settings in /bin/sh format
## automatically generated from /etc/dbconfig-common/amusewiki.conf
## by /usr/sbin/dbconfig-generate-include
##
## by default this file is managed via ucf, so you shouldn't have to
## worry about manual changes being silently discarded.  *however*,
## you'll probably also want to edit the configuration file mentioned
## above too.
##

dbuser=''
dbpass=''
basepath='/var/lib/dbconfig-common/sqlite3/amusewiki'
dbname='amusewiki'
dbserver=''
dbport=''
dbtype='sqlite3'

# This is a stock file, but it's yours for modifying (even if the
# defaults are sane). You can also create a file
# log4perl.local.conf in this directory and the application will use
# that one.

log4perl.logger=INFO, Log, Mail

log4perl.appender.Log=Log::Dispatch::FileRotate
log4perl.appender.Log.filename=log/amw.log
log4perl.appender.Log.mode=append

# 10M then rotate, max 10, 100M of logs
log4perl.appender.Log.size=10485760
log4perl.appender.Log.max=10

log4perl.appender.Log.layout=Log::Log4perl::Layout::PatternLayout
log4perl.appender.Log.layout.ConversionPattern=%d %p - %c - %F:%L - %m%n

# send the errors to root.

log4perl.appender.Mail=Log::Dispatch::Email::MailSend
log4perl.appender.Mail.Threshold=ERROR
log4perl.appender.Mail.from=amusewiki@localhost
log4perl.appender.Mail.to=root@localhost
log4perl.appender.Mail.subject="[AmuseWiki errors: localhost]"
log4perl.appender.Mail.buffered=0
log4perl.appender.Mail.layout=Log::Log4perl::Layout::PatternLayout
log4perl.appender.Mail.layout.ConversionPattern=%d %p - %c - %F:%L - %m%n

2026/11/01 11:23:12 INFO - AmuseWikiFarm.Schema.Result.Site - /usr/share/perl5/AmuseWikiFarm/Schema/Result/Site.pm:1481 - pdf for t1 is disabled
2026/11/01 11:23:12 INFO - AmuseWikiFarm.Schema.Result.Site - /usr/share/perl5/AmuseWikiFarm/Schema/Result/Site.pm:1481 - sl_pdf for t1 is disabled
2026/11/01 11:23:12 INFO - AmuseWikiFarm.Schema.Result.CustomFormat - /usr/share/perl5/AmuseWikiFarm/Schema/Result/CustomFormat.pm:864 - c9 is without format code
2026/11/01 11:23:12 INFO - AmuseWikiFarm.Schema.Result.CustomFormat - /usr/share/perl5/AmuseWikiFarm/Schema/Result/CustomFormat.pm:864 - c10 is without format code

[
   {
      "bold" : "/usr/share/fonts/truetype/cmu/cmunbx.ttf",
      "bolditalic" : "/usr/share/fonts/truetype/cmu/cmunbi.ttf",
      "desc" : "CMU Serif",
      "italic" : "/usr/share/fonts/truetype/cmu/cmunti.ttf",
      "name" : "CMU Serif",
      "regular" : "/usr/share/fonts/truetype/cmu/cmunrm.ttf",
      "type" : "serif"
   },
   {
      "name" : "Linux Libertine O",
      "type" : "serif",
      "regular" : "/usr/share/fonts/opentype/linux-libertine/LinLibertine_R.otf",
      ...
   },
   {
      "name" : "TeX Gyre Pagella",
      "type" : "serif",
      ...
   }
]

[Unit]
Description=Amusewiki web server
After=nss-user-lookup.target

[Service]
# this is already something
Environment="PM_MAX_REQUESTS=1000"
# You'll need Linux::Pid (liblinux-pid-perl) installed for the max size to work
# Environment="PM_MAX_SIZE=524288"
# Environment="PM_SIZECHECK_NUM_REQUESTS=10"

WorkingDirectory=/var/lib/amusewiki
User=amusewiki
Group=amusewiki
ExecStart=/usr/bin/plackup -s FCGI --listen /var/lib/amusewiki/amusewiki.socket --nproc 8 -E deployment --manager FCGI::ProcManager::Constrained /usr/share/perl5/AmuseWikiFarm/psgi/amusewiki.psgi
Restart=always

[Install]
WantedBy=multi-user.target

[Unit]
Description=Amusewiki jobber
After=nss-user-lookup.target

[Service]
WorkingDirectory=/var/lib/amusewiki
User=amusewiki
Group=amusewiki
Environment="PATH=/opt/amusewiki-texlive/current/bin/arch:/usr/local/bin:/usr/bin:/bin"
ExecStart=/usr/bin/amusewiki-jobber
Restart=always

[Install]
WantedBy=multi-user.target

# amusewiki-nginx-reload.path
[Unit]
Description=Path to monitor to trigger an nginx reload

[Path]
PathChanged=/var/lib/amusewiki/ssl/amusewiki_requests_webserver_reload.txt

[Install]
WantedBy=multi-user.target

# amusewiki-nginx-reload.service
[Unit]
Description=Trigger an nginx reload
Wants=nginx.service

[Service]
ExecStart=/bin/sh -c '/usr/sbin/nginx -t && /usr/sbin/service nginx reload'

server {
    listen 80;
    listen [::]:80;
    listen 443 ssl;
    listen [::]:443 ssl;
    ssl_certificate_key /var/lib/amusewiki/ssl/amusewikidebian.key;
    ssl_certificate     /var/lib/amusewiki/ssl/amusewikidebian.crt;
    server_name localhost;
    access_log /var/log/nginx/localhost.log combined;
    error_log /var/log/nginx/localhost.err.log;
    client_max_body_size 8m;
    include amusewikidebian_include;

}

    root /usr/share/perl5/AmuseWikiFarm/root;

    # LEGACY STUFF
    rewrite ^/lib/(.*)$ /library/$1 permanent;
    rewrite ^/epub/(.*)\.epub /library/$1.epub permanent;
    rewrite ^/topics/(.*)\.html /category/topic/$1 permanent;
    rewrite ^/authors/(.*)\.html /category/author/$1 permanent;
    # END LEGACY STUFF

    location /static/js/ckeditor/ {
        expires 1w;
        alias /usr/share/javascript/ckeditor/;
    }
    location /.well-known/acme-challenge/ {
        root /var/lib/amusewiki/ssl/ACME_ROOT;
    }
    # deny direct access to the CGI file
    location /git/cgit.cgi {
        deny all;
    }
    location /src/ {
        deny all;
    }
    location /themes/ {
        deny all;
    }
    location /private/repo/ {
        internal;
        alias /var/lib/amusewiki/repo/;
    }
    location /private/staging/ {
        internal;
        alias /var/lib/amusewiki/staging/;
    }
    location @proxy {
        fastcgi_param  QUERY_STRING       $query_string;
        fastcgi_param  REQUEST_METHOD     $request_method;
        ...
        fastcgi_param HTTP_X_SENDFILE_TYPE X-Accel-Redirect;
        fastcgi_param HTTP_X_ACCEL_MAPPING /var/lib/amusewiki=/private;
        fastcgi_pass  unix:/var/lib/amusewiki/amusewiki.socket;
    }

CREATE TABLE IF NOT EXISTS "site" ( "id" varchar(16) NOT NULL, "mode" varchar(16) NOT NULL DEFAULT 'private', "locale" varchar(3) NOT NULL DEFAULT 'en', "magic_question" varchar(255) NOT NULL DEFAULT '12 + 4 =', "magic_answer" varchar(255) NOT NULL DEFAULT '16', "fixed_category_list" text, "sitename" varchar(255) NOT NULL DEFAULT '', "siteslogan" varchar(255) NOT NULL DEFAULT '', "theme" varchar(32) NOT NULL DEFAULT '', "logo" varchar(255) NOT NULL DEFAULT '', "mail_notify" text, "mail_from" text, "canonical" varchar(255) NOT NULL, "secure_site" integer(1) NOT NULL DEFAULT 1, "secure_site_only" integer(1) NOT NULL DEFAULT 0, "sitegroup" varchar(255) NOT NULL DEFAULT '', "cgit_integration" integer(1) NOT NULL DEFAULT 0, "ssl_key" varchar(255) NOT NULL DEFAULT '', "ssl_cert" varchar(255) NOT NULL DEFAULT '', "ssl_ca_cert" varchar(255) NOT NULL DEFAULT '', "ssl_chained_cert" varchar(255) NOT NULL DEFAULT '', "acme_certificate" integer(1) NOT NULL DEFAULT 0, "multilanguage" varchar(255) NOT NULL DEFAULT '', "active" integer(1) NOT NULL DEFAULT 1, "blog_style" integer(1) NOT NULL DEFAULT 0, "bb_page_limit" integer NOT NULL DEFAULT 1000, "tex" integer(1) NOT NULL DEFAULT 1, "pdf" integer(1) NOT NULL DEFAULT 1, "a4_pdf" integer(1) NOT NULL DEFAULT 0, "lt_pdf" integer(1) NOT NULL DEFAULT 0, "sl_pdf" integer(1) NOT NULL DEFAULT 0, "html" integer(1) NOT NULL DEFAULT 1, "bare_html" integer(1) NOT NULL DEFAULT 1, "epub" integer(1) NOT NULL DEFAULT 1, "zip" integer(1) NOT NULL DEFAULT 1, "ttdir" varchar(255) NOT NULL DEFAULT '', "papersize" varchar(64) NOT NULL DEFAULT '', "division" integer NOT NULL DEFAULT 12, "bcor" varchar(16) NOT NULL DEFAULT '0mm', "fontsize" integer NOT NULL DEFAULT 10, "mainfont" varchar(255) NOT NULL DEFAULT 'CMU Serif', "sansfont" varchar(255) NOT NULL DEFAULT 'CMU Sans Serif', "monofont" varchar(255) NOT NULL DEFAULT 'CMU Typewriter Text', "beamertheme" varchar(255) NOT NULL DEFAULT 'default', "beamercolortheme" varchar(255) NOT NULL DEFAULT 'dove', "nocoverpage" integer(1) NOT NULL DEFAULT 0, "logo_with_sitename" integer(1) NOT NULL DEFAULT 0, "opening" varchar(16) NOT NULL DEFAULT 'any', "twoside" integer(1) NOT NULL DEFAULT 0, "binary_upload_max_size_in_mega" integer NOT NULL DEFAULT 8, "git_token" text, "last_updated" datetime, PRIMARY KEY ("id") );
CREATE UNIQUE INDEX "canonical_unique" ON "site" ("canonical");

amw|localhost|AmuseWiki documentation|private||en|1|1|1|1|1|0|0|0|0|0|0|0
demo|demo.localhost|Demo Library|private||en|1|1|1|1|1|0|0|0|0|0|0|0

amusewiki set-site-variable demo --set theme=amusejournal
curl -s -H "Host: demo.localhost" http://localhost/login | grep -oE "bootstrap\.[a-z]+\.css"

Updating demo theme => amusejournal
bootstrap.amusejournal.css

amusewiki set-site-variable demo --set theme=
curl -s -H "Host: demo.localhost" http://localhost/login | grep -oE "bootstrap\.[a-z]+\.css|amusewiki\.css"

Updating demo theme => 
bootstrap.amusewiki.css
amusewiki.css

amw|c3|Plain PDF|pdf|0
amw|c1|A4 imposed PDF|a4.pdf|0
amw|c2|Letter imposed PDF|lt.pdf|0
amw|c4|Slides (PDF)|sl.pdf|0
demo|c3|Plain PDF|pdf|0
demo|c1|A4 imposed PDF|a4.pdf|0
demo|c2|Letter imposed PDF|lt.pdf|0
demo|c4|Slides (PDF)|sl.pdf|0

CREATE TABLE IF NOT EXISTS "site_options" ( "site_id" varchar(16) NOT NULL, "option_name" varchar(64) NOT NULL, "option_value" text, PRIMARY KEY ("site_id", "option_name"), FOREIGN KEY ("site_id") REFERENCES "site"("id") ON DELETE CASCADE ON UPDATE CASCADE );

amusewiki include-path --site demo --add /var/lib/amusewiki/shared

Site: demo include paths:
 - /var/lib/amusewiki/shared

sqlite3 /var/lib/dbconfig-common/sqlite3/amusewiki/amusewiki "select * from site_options;"

demo|include_path|/var/lib/amusewiki/shared

amusewiki include-path --site demo --reset
sqlite3 /var/lib/dbconfig-common/sqlite3/amusewiki/amusewiki "select count(*) from site_options;"

Resetting include paths for demo
0

CREATE TABLE IF NOT EXISTS "roles" ( "id" INTEGER PRIMARY KEY NOT NULL, "role" varchar(128) );
CREATE UNIQUE INDEX "role_unique" ON "roles" ("role");

1|root

sed -e "s/canonical: localhost/canonical: t1.localhost/" \
    -e "s/^id: amw/id: t1/" \
    -e "s/sitename: AmuseWiki documentation/sitename: T1 Sandbox/" \
    /tmp/amw-export/amw.yaml > /tmp/amw-export/t1.yaml
amusewiki clone-site import /tmp/amw-export/t1.yaml --bootstrap

Please place the site tree into /var/lib/amusewiki/repo/t1 at /usr/bin/amusewiki-clone-site line 109.
Importing /tmp/amw-export/t1.yaml
admin already exists, adding it to the site

---
id: press01                      # 主键，=仓库目录名
canonical: press.example.com     # 路由域名，全库唯一
sitename: Press One Library
siteslogan: Poetry & essays
mode: public                     # 公开可读（面板改，CLI 保留）
locale: zh                       # 简体中文界面
theme: amusejournal
mainfont: Noto Serif CJK SC      # 需先注册进 fontspec.json
sansfont: Noto Sans CJK SC
monofont: Noto Sans Mono CJK SC
papersize: a5
fontsize: 11
twoside: 1                       # 双面印刷
bcor: 8mm                        # 胶装书脊出血
division: 12
tex: 1
html: 1
bare_html: 1
epub: 1
zip: 1
pdf: 1
a4_pdf: 0
secure_site: 1
acme_certificate: 1              # Let's Encrypt 自动证书
binary_upload_max_size_in_mega: 32   # 同步 nginx client_max_body_size 32m
bb_page_limit: 1000
cgit_integration: 0
# git_token: 面板生成，勿写入受版本控制的模板

Updating demo mode => public
amw|private
demo|private
GET /: 401
GET /library/: 401

mode is reserved, please use the admin panel at /usr/share/perl5/AmuseWikiFarm/Schema/Result/Site.pm line 4096.
DBIx::Class::Storage::TxnScopeGuard::DESTROY(): A DBIx::Class::Storage::TxnScopeGuard went out of scope without explicit commit or error. Rolling back.

sqlite3 /var/lib/dbconfig-common/sqlite3/amusewiki/amusewiki "update site set mode='public' where id='demo';"
curl -s -H "Host: demo.localhost" -o /dev/null -w "GET /library/ (public): %{http_code}\n" http://localhost/library/

GET /library/ (public): 200

amusewiki generate-nginx-conf

# please execute as root:
diff -Nu /etc/nginx/sites-enabled/amusewikidebian /tmp/nginx-amusewiki-aPV7Ipvj/amusewikidebian
cat /tmp/nginx-amusewiki-aPV7Ipvj/amusewikidebian > /etc/nginx/sites-enabled/amusewikidebian
nginx -t && service nginx reload