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 2026). You can still run Amusewiki on such systems using the manual installation.

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

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 http://deb.amusewiki.org/debian/pool/main/a/amusewiki-archive-keyring-trixie/amusewiki-archive-keyring-trixie_1.0.0_all.deb
For Bookworm: 
wget http://deb.amusewiki.org/debian/pool/main/a/amusewiki-archive-keyring-bookworm/amusewiki-archive-keyring-bookworm_1.0.0_all.deb
Then run: 
# apt-get update      
# apt-get install amusewiki-extra-fonts # this is optional
# 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.

The virtual host used by nginx is roughly a blind guess, so probably you will need to put the hostname on /etc/hosts to access it for the initial configuration.

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 credentails to login in 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

# echo 'deb http://deb.amusewiki.org/debian bookworm main' > /etc/apt/sources.list.d/amusewiki.list
    
amusewiki-archive-keyring-trixie 1.0.0
libbytes-random-secure-tiny-perl 1.011-1

Bullseye

# echo 'deb http://deb.amusewiki.org/debian bullseye main' > /etc/apt/sources.list.d/amusewiki.list
    
amusewiki-archive-keyring-bookworm 1.0.0
libbytes-random-secure-tiny-perl 1.011-1

Contact and bug reports

Marco Pessotto melmothx -at- gmail -dot- com

Github bug tracker