How to install amusewiki in 4 commands (on Debian Bookworm/Trixie/Ubuntu)

Please note that the .deb packages provided here are fully compatible for Debian and Ubuntu, and the instructions are the same even if the source list will say debian.

Existing packages for older Debian and Ubuntu releases are still provided at https://packages.amusewiki.org, but support for them has stopped with Amusewiki release 2.611 (December 2025). You can still run Amusewiki on such systems using the manual installation.

Supported database are mysql/mariadb, postgresql and sqlite3. Please install postgresql or mariadb-server before starting the installation. You will be prompted to choose which one to use, but use postgresql if you can.

Amusewiki uses nginx as frontend server, so if you have Apache running, you need to change your setup (and free the HTTP and HTTPS ports) before starting the installation. See for example this article for a combined setup Apache/Nginx.

Add the keyring and the APT source list

For Trixie:
# wget https://deb.amusewiki.org/amusewiki-archive-keyring-trixie_1.0.0_all.deb
# dpkg -i amusewiki-archive-keyring-trixie_1.0.0_all.deb
For Bookworm:
# wget https://deb.amusewiki.org/amusewiki-archive-keyring-bookworm_1.0.0_all.deb
# dpkg -i amusewiki-archive-keyring-bookworm_1.0.0_all.deb
Then run:
# apt-get update      
# apt-get install --no-install-recommends amusewiki

The output is going to prompt you to change the nginx configuration and give you the credentials for the login and a hostname to use.

The virtual host used by nginx is roughly a blind guess, so probably you will need to put the ip/hostname association in the /etc/hosts file on the client machine (i.e. yours, not the server) to access the server for the initial configuration.

This is the point where people get stuck. Amusewiki is multisite, so it is not going to respond unless you request the correct hostname. The initial configuration assigned a guessed hostname (say, amusewiki.yournetwork.org) and you need to use that to access the dashboard, hence the /etc/hosts trick. Once you reach the dashboard you can update the server name to the correct one.

The initial site with documentation is created to give you a way to reach the admin panel, where you should create a brand new site from /admin/sites and possibly make inactive the default one.

The installation procedure will send a mail to root@localhost with the credentials to login and the nginx configuration instructions. If for some reason you didn't get it, you can look at /var/log/amusewiki/installation.log (since version 2.310).

List of packages provided by this repository

You can browse them here

Trixie

amusewiki 2.613-1
amusewiki-archive-keyring-trixie 1.0.0
amusewiki-texlive 20260407-1
fonts-antykwa-poltawskiego 101-2
fonts-antykwa-torunska 2.08-2
fonts-fandol 0.03-2
fonts-nowacki 0.995-2
fonts-sourcecodepro 0.00201710+amw2
fonts-source-han-sans-ja 2.004R+amw3
fonts-source-han-sans-ko 2.004R+amw3
fonts-source-han-sans-sc 2.004R+amw3
fonts-source-han-serif-ja 2.000R+amw3
fonts-source-han-serif-ko 2.000R+amw3
fonts-source-han-serif-sc 2.000R+amw3
fonts-sourcesanspro 0.00201710+amw2
fonts-sourceserifpro 0.00201710+amw2
libbytes-random-secure-tiny-perl 1.011-1
libcrypt-perl-perl 0.38
libcrypt-xkcdpassword-perl 0.009-3
libdbix-class-inflatecolumn-authen-passphrase-perl 0.03-2
libdbix-class-passphrasecolumn-perl 0.05-2
libebook-epub-lite-perl 0.71-3
libemail-mime-kit-renderer-tt-perl 1.003-1
libhttp-tiny-ua-perl 0.006-2
liblog-dispatch-file-stamped-perl 0.21-1
libmath-provableprime-perl 0.51-1
libnet-acme2-perl 0.35-1
libpdf-cropmarks-perl 0.11-2
libpdf-imposition-perl 0.26-2
libplack-middleware-etag-perl 0.05-3
libsuperclass-perl 0.003-2
libtext-amuse-compile-perl 1.91-3
libtext-amuse-perl 1.83-2
libtext-amuse-preprocessor-perl 0.67-2
libxml-opds-perl 0.06-2
libx-tiny-perl 0.22-1
      

Bookworm

amusewiki 2.613-1
amusewiki-archive-keyring-bookworm 1.0.0
amusewiki-texlive 20260407-1
fonts-antykwa-poltawskiego 101-2
fonts-antykwa-torunska 2.08-2
fonts-fandol 0.03-2
fonts-nowacki 0.995-2
fonts-sourcecodepro 0.00201710+amw2
fonts-source-han-sans-ja 2.004R+amw3
fonts-source-han-sans-ko 2.004R+amw3
fonts-source-han-sans-sc 2.004R+amw3
fonts-source-han-serif-ja 2.000R+amw3
fonts-source-han-serif-ko 2.000R+amw3
fonts-source-han-serif-sc 2.000R+amw3
fonts-sourcesanspro 0.00201710+amw2
fonts-sourceserifpro 0.00201710+amw2
libbytes-random-secure-tiny-perl 1.011-1
libcrypt-perl-perl 0.38
libcrypt-xkcdpassword-perl 0.009-3
libdbix-class-inflatecolumn-authen-passphrase-perl 0.03-2
libdbix-class-passphrasecolumn-perl 0.05-2
libebook-epub-lite-perl 0.71-3
libemail-mime-kit-renderer-tt-perl 1.003-1
libhttp-tiny-ua-perl 0.006-2
liblog-dispatch-file-stamped-perl 0.21-1
libmath-provableprime-perl 0.51-1
libnet-acme2-perl 0.35-1
libpdf-cropmarks-perl 0.11-2
libpdf-imposition-perl 0.26-2
libplack-middleware-etag-perl 0.05-3
libsuperclass-perl 0.003-2
libtext-amuse-compile-perl 1.91-3
libtext-amuse-perl 1.83-2
libtext-amuse-preprocessor-perl 0.67-2
libxml-opds-perl 0.06-2
libx-tiny-perl 0.22-1
      

Contact and bug reports

Marco Pessotto melmothx -at- gmail -dot- com

Github bug tracker