On a dedicated web server (recommended way)
To install wallabag itself, you must run the following commands:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
If it's your first installation, you can safely answer "yes" when asking to reset the database.
Now, read the next step to create your virtual host, then access your wallabag.
To define parameters with environment variables, you have to set these variables with
SYMFONY__ prefix, for example,
You can have a look at Symfony documentation.
If you want to use SQLite to store your data, please put
%kernel.root_dir%/../data/db/wallabag.sqlite for the
database_path parameter during installation.
If you're installing Wallabag behind Squid as a reverse proxy, make sure to update your
squid.conf configuration to include
login=PASS in the
cache_peer line. This is necessary for API calls to work properly.
On shared hosting
We provide a package with all dependencies inside. The default
configuration uses MySQL for the database. To add the setting for your database, please edit
app/config/parameters.yml. Beware that passwords must be surrounded by single quotes (').
We have already created a user: the login and password are
With this package, wallabag doesn't check for mandatory extensions used
in the application (theses checks are made during
when you have a dedicated web server, see above).
Execute this command to download and extract the latest package:
wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package
You will find the md5 hash of the latest package on our website.
The static package requires each command to be appended by
--env=prod as the static package is only usable as a prod environment (dev environment is not supported and won't work at all).
Now, read the next step to create your virtual host.
You must create your first user by using the command
php bin/console wallabag:install --env=prod
If an error occurs at this step due to bad settings, you must clear the cache with
php bin/console cache:clear --env=prod before you try again the previous command.
Then you can access your wallabag.
Usage of wallabag.it
wallabag.it is a paid service to use wallabag without installing it on a web server.
This service always ships the latest release of wallabag. You can create your account here. Try it for free: you'll get a 14-day free trial with no limitation (no credit card information required).
Installation with Docker
We provide you a Docker image to install wallabag easily. Have a look at our repository on Docker Hub for more information.
Command to launch container
docker pull wallabag/wallabag
Installation on Cloudron
Cloudron provides an easy way to install webapps on your server with a focus on sysadmin automation and keeping apps updated. wallabag is packaged as a Cloudron app and available to install directly from the store.
Installation on YunoHost
YunoHost provides an easy way to install webapps on your server with a focus on sysadmin automation and keeping apps updated. wallabag is packaged as an official YunoHost app and is available to install directly from the official repository.
Installation on alwaysdata
alwaysdata's Marketplace allows to easily install wallabag (and many other applications) on a Public or Private Cloud.
Installation on Synology
The SynoCommunity provides a package to install wallabag on your Synology NAS.