PHPackages mrsleeps/vexim-web-ui - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. mrsleeps/vexim-web-ui ActiveProject[Framework](/categories/framework) mrsleeps/vexim-web-ui ===================== VExim Web UI - Laravel UI for VExim2. v2.1.2(2w ago)02[2 issues](https://github.com/MrSleeps/VExim-Web-UI/issues)[3 PRs](https://github.com/MrSleeps/VExim-Web-UI/pulls)GPL-3.0-onlyPHPPHP ^8.4CI passing Since Jun 18Pushed 1w agoCompare [ Source](https://github.com/MrSleeps/VExim-Web-UI)[ Packagist](https://packagist.org/packages/mrsleeps/vexim-web-ui)[ RSS](/packages/mrsleeps-vexim-web-ui/feed)WikiDiscussions main Synced 2w ago READMEChangelog (4)Dependencies (70)Versions (10)Used By (0) [![Logo](public/images/logo.svg)](public/images/logo.svg) VExim Web UI ============ [](#vexim-web-ui) This web app with a catchy name is to manage your [VExim2](https://github.com/vexim/vexim2 "VEXIM2") backend. **The main VExim2 repo is a little behind with pull requests, this Web UI has incorporated some of those outstanding pull requests (after testing, obviously), when installing VExim Web UI it will make changes to your VExim2 databases. But don't worry, it's all done via automatic migrations and *should* be reversible.** For a list of changes we have made to the core VExim2 tables you can [read this](https://github.com/MrSleeps/VExim-Web-UI/blob/main/docs/VEximDBChanges.md) and ff you want to see all database changes, check the database/migrations folder. ### UI Features [](#ui-features) - Modern responsive UI with light and dark modes - Separate web and email accounts (with assignable roles, System admin, domain admin and email only accounts) - Manage accounts, domains, emails, forwarders, fails, whitelist, blacklist - 2FA and Passkeys login - CLI commands - RSpamd support (because **I hate SpamAssassin**) - DKIM support (Can also update your DNS automatically if you use PowerDNS) - Autodiscover support (Autodiscover works by having email client applications retrieve an XML file from the server which describes all the services and their options) - Plugins, enabling us to easily extend the UI (see Plugins below) ### Requirements [](#requirements) - PHP 8.4+ - Mariadb/Mysql - Shell access ### Everyone loves a screenshot [](#everyone-loves-a-screenshot) #### The dashboard [](#the-dashboard) [![Dashboard](docs/screenshots/dashboard.webp)](docs/screenshots/dashboard.webp) #### Email domains [](#email-domains) [![Domains](docs/screenshots/domains.webp)](docs/screenshots/domains.webp) #### Edit account [](#edit-account) [![Emails](docs/screenshots/edit-user.webp)](docs/screenshots/edit-user.webp) ### Things to know before diving in [](#things-to-know-before-diving-in) This is a complete rewrite of the original VEXIM2 php code and does require changes to your main VExim2 database tables (it doesn't overly affect the Exim configs, kept those to a minimum, it's just for the web ui but for various reason they share the same database (mostly because cross-database eloquent relationships in Laravel are an ugly nightmare and not many people have SQL replication setup)). **BACK UP YOUR VEXIM DATABASE BEFORE ATTEMPTING TO INSTALL THIS!** It no longer supports the "siteadmin" login, you will need to create a new system admin user account (does it for you during the install). Nor does it support pipe commands, they're a security nightmare and because of that there is no support for them in this ui (you can still add them manually if you want to open up your server for all kinds of potential trouble - Have a read of [at this comment](https://github.com/vexim/vexim2/pull/300#issuecomment-4692028967) for a tiny insight as to why). I have also only tested this on Debian Bookworm and Trixie. ### How to install [](#how-to-install) Firstly, **BACK UP YOUR VEXIM DATABASE**. Create a new veximweb system user account: `sudo adduser veximweb` You'll need to install php if you haven't already: `sudo apt install -y php8.5 php8.5-bcmath php8.5-cli php8.5-curl php8.5-fpm php8.5-gd php8.5-imap php8.5-intl php8.5-ldap php8.5-mailparse php8.5-mbstring php8.5-mysql php8.5-soap php8.5-xml php8.5-zip` If that fails, install the [Sury php repo](https://deb.sury.org/ "sury php repo") and try again. Now copy the docs/fpm/vexim.conf file to /etc/php/8.5/fpm/pool.d/ If you kept the newly created user account as veximweb you won't need to change anything, if you didn't then you'll need to edit that file. Now restart php8.5-fpm: `service php8.5-fpm restart` Now you need to point your web server to the directory, how you do that is up to you but make sure it uses the php-fpm worker we just installed. An example NGINX config is supplied in docs/nginx. I have made changes to the VExim2 exim config files, again look under docs/exim and install those if they differ from yours (the sql has been modernised, doesn't make a huge change). You will need, at the very least, to install my version of debian-conf.d/main/00\_vexim\_listmacrosdefs, there are a fair few changes in that (DKIM, RSpamd/SpamAssassin). If you are using SpamAssassin, you will need to edit debian-conf.d/main/00\_vexim\_listmacrosdefs and change the stuff right at the bottom ``` # Choose spam scanner - uncomment only ONE of these: SPAM_ENGINE_RSPAMD = yes # SPAM_ENGINE_SPAMASSASSIN = yes ``` *Just note, the whitelist config file will break your Exim if you don't delete the default exim whitelist config*. I realise the Exim config installation explanation is a bit thin on details but I figured you have all installed VExim2, you should know what you are doing! **Using RSpamd?**VExin Web UI supports checking whitelists/blacklists in RSpamd via an API call, this is explained in more detail at the end of this readme. How to install the web ui ------------------------- [](#how-to-install-the-web-ui) Onto installing the web ui. SU (or login) to your newly created user and run `git clone https://github.com/MrSleeps/VExim-Web-UI.git` Rename the directory `mv VExim-Web-UI vexim_web` Now cd into the directory `cd vexim_web/` Copy the example .env file `cp .env.example .env` Now fire up your favourite editor and edit the .env file `nano .env` You will need to update the following: - APP\_URL - DB\_CONNECTION - DB\_HOST - DB\_PORT - DB\_DATABASE - DB\_USERNAME - DB\_PASSWORD - MAIL\_HOST - MAIL\_PORT - MAIL\_USERNAME - MAIL\_PASSWORD - MAIL\_FROM\_ADDRESS - MAIL\_FROM\_SUPPORT\_ADDRESS - MAIL\_FROM\_SUPPORT\_NAME - VEXIM\_GID - VEXIM\_UID - VEXIM\_SYSADMIN\_SET\_GUID (not currently enabled but that's coming very soon) - VEXIM\_MAILMAN\_ENABLED - VEXIM\_ENFORCE\_2FA - VEXIM\_SPAM\_ENGINE - HEALTH\_TO\_ADDRESS (System does basic health checks, this is where you get the report emailed to) Pretty self explanatory, just note that the database user needs to have write access to the VExim2 database, you can make a new sql user by running the commands below: Create the user: `CREATE USER 'newuser'@localhost IDENTIFIED BY 'strongpassword';` Grant permissions to the database (replace database\_name to the one you are using for VExim2): `GRANT ALL PRIVILEGES ON database_name.* TO 'newuser'@localhost WITH GRANT OPTION;` Apply changes: `FLUSH PRIVILEGES;` Now on to the fun stuff. **MAKE SURE YOU HAVE BACKED UP YOUR CURRENT VEXIM DATABASE** In the vexim\_web directory run `./setup-web.sh` This should take you through the install process (it will fail miserably if you haven't updated the env file correctly) and create you a new user. If you are starting with a blank canvas (ie no VExim2 install) it will install the VExim2 tables for you (if you say yes when it asks you that). It will prompt you to create a new user account, be careful, that account has full access to all domains, emails etc. **If this is not a fresh install, you will need to add the DKIM database table, the schema for that is located in the docs/dkim folder.** If that finishes without any errors you can now login via your newly created account. Visit and login.. Things I recommend you do on a new install: Check the settings page, this is where your system settings are (GID, UID etc). Make sure they are correct (it does pick them up from the env variables). Have a look at the email templates under the "Communications" heading, these are what get sent out to users. CLI commands ------------ [](#cli-commands) I have included a basic set of CLI commands that you can use. You can do basic control of users, email accounts and domains (including aliases) using them. Web accounts: ------------- [](#web-accounts) `php artisan vw:users` **Add a new user:** ``` php artisan vw:users add ``` **Delete a user:** ``` php artisan vw:users delete 1 php artisan vw:users delete john@example.com ``` **Search users:** ``` php artisan vw:users search john php artisan vw:users search "john doe" php artisan vw:users search john --role=system_admin php artisan vw:users search john --status=active ``` **List all users:** ``` php artisan vw:users list php artisan vw:users list --role=system_admin php artisan vw:users list --status=active ``` **Show user details:** ``` php artisan vw:users show 1 php artisan vw:users show john@example.com ``` **Activate a user:** ``` php artisan vw:users activate 1 php artisan vw:users activate john@example.com ``` **Deactivate a user:** ``` php artisan vw:users deactivate 1 php artisan vw:users deactivate john@example.com ``` Email accounts -------------- [](#email-accounts) `php artisan vw:email` **Add a new email user:** ``` php artisan vw:email add ``` **Delete an email user:** ``` php artisan vw:email delete user@example.com php artisan vw:email delete 1 ``` **Search email users:** ``` php artisan vw:email search user@example.com php artisan vw:email search user --domain=example.com ``` **List email users:** ``` php artisan vw:email list php artisan vw:email list --domain=example.com php artisan vw:email list --type=local php artisan vw:email list --status=enabled ``` **Show email user details:** ``` php artisan vw:email show user@example.com php artisan vw:email show 1 ``` **Enable an email user:** ``` php artisan vw:email enable user@example.com ``` **Disable an email user:** ``` php artisan vw:email disable user@example.com ``` Domain management ----------------- [](#domain-management) `php artisan vw:domains` **Add a new domain:** ``` php artisan vw:domains add ``` **Delete a domain:** ``` php artisan vw:domains delete 1 php artisan vw:domains delete example.com ``` **Search domains:** ``` php artisan vw:domains search example php artisan vw:domains search example --type=local php artisan vw:domains search example --status=enabled ``` **List all domains:** ``` php artisan vw:domains list php artisan vw:domains list --type=local php artisan vw:domains list --status=enabled ``` **Show domain details:** ``` php artisan vw:domains show 1 php artisan vw:domains show example.com ``` **Activate a domain:** ``` php artisan vw:domains activate 1 php artisan vw:domains activate example.com ``` **Deactivate a domain:** ``` php artisan vw:domains deactivate 1 php artisan vw:domains deactivate example.com ``` \*\* Assign a user to a domain:\*\* ``` php artisan vw:domains assign 1 --user=5 --role=domain_admin php artisan vw:domains assign example.com --user=john@example.com --role=viewer ``` **Unassign a user from a domain:** ``` php artisan vw:domains unassign 1 --user=5 php artisan vw:domains unassign example.com --user=john@example.com ``` Plugins ======= [](#plugins) Plugins extend VExim Web UI by adding extra features, there are currently **4** plugins available. All plugins are installed via the cli, to get a list of available plugins cd into your vexim\_web directory and run `php artisan vw:plugin list` This lists the available plugins. To Install a particular plugin you then need to run `php artisan vw:plugin install mrsleeps/package-name` Obviously replacing the package name with whatever plugin you are trying to install. Once that has run, you should always run `php artisan migrate` To update the database with any new tables/modifications ### RSpamd [](#rspamd) As mentioned earlier, RSpamd is supported (currently for whitelists and blacklists). It does this by calling an API route. To install you need to run: `php artisan vw:plugin install mrsleeps/vexim-web-plugin-rspamd` and then `php artisan migrate` Then have a look in the docs/rspamd folder and copy the files into their respective folders. You will need to edit vexim.conf (in your rspamd modules.local.d directory), add your VExim web ui host () and you need an api key which you get that by going back into your vexim\_web folder and running `php artisan vw:create-rspamd-token user_id` You can get the user\_id of your account by running `php artisan vw:users list --role=system_admin` This gives you an X-API-Key (will look somethinglike: 1|ATA1MiQB5s0YpiP29msV7NxFxqABC5vc2cpBEmMfZVK4Q4Ho). Copy the **whole** of that key and paste it into the api\_key section of the rspamd vexim.conf file (you will need to wrap it in quotes). Restart rspamd and watch your log files! ### PowerDNS [](#powerdns) Automatically add your DKIM values to your dns records via your PowerDNS API. Easy to install: To install you need to run: `php artisan vw:plugin install mrsleeps/vexim-web-plugin-pdns` and then `php artisan migrate` Then you head over to the VExim web ui and add your PowerDNS servers. You will then have to link every domain you want controlled via PDNS by visiting the domain page in the ui (sorry! A command will be in the next release). ### Mailman 3 [](#mailman-3) We have provided a MM3 module that allows you to automatically add/delete mail lists and have basic control of the members of those lists. Sadly, there are no PRs for support MM3 via LMTP so this module is pretty pointless until we figure that out. However, if you want to have a look it's easy to install. To install you need to run: `php artisan vw:plugin install mrsleeps/vexim-web-plugin-pdns` and then `php artisan migrate` Then add the following to your .env file: ``` MAILMAN_HOST=localhost MAILMAN_PORT=8001 ## This is your api port MAILMAN_USERNAME= MAILMAN_PASSWORD= MAILMAN_API_VERSION=3.1 MAILMAN_TIMEOUT=30 ``` Once they are correctly added the Mailman 3 plugin will synch your lists (currently only manually, click the synch button). ### DMARC [](#dmarc) This adds DMARC report collection and display on the VExim Web UI. To install you need to run: `php artisan vw:plugin install mrsleeps/vexim-web-plugin-dmarc` and then `php artisan migrate` For this you need to add a dmarc reporting local account to your VExim database (or you can use any IMAP email address). Add the following to your .env file ``` DMARC_IMAP_HOST= DMARC_IMAP_PORT= DMARC_IMAP_ENCRYPTION= DMARC_IMAP_USERNAME= DMARC_IMAP_PASSWORD= DMARC_IMAP_VALIDATE_CERT=false DMARC_IMAP_DEBUG=false ``` Then for each domain you have you need to add an alias/forwarder to that dmarc address. A cli command is available which will create a dmarc forwarder for every domain that you have, it will forward to the email address in `DMARC_IMAP_USERNAME`. You can do this by running: `php artisan vw:setup-dmarc-aliases` Then you need to change the dns for all the domains (ball ache, I know) to deliver to dmarc@domain ### MTA-STS [](#mta-sts) php artisan vendor:publish --tag=mtasts-config Then edit app/config/mta-sts.php and choose "testing" or "enforce". - testing - does not reject the email - enforce - will reject the email Other things it does -------------------- [](#other-things-it-does) ### autodiscover [](#autodiscover) Ever used Thunderbird and it's automatically found your mail server settings? Probably autodiscover (or magic). Autodiscover is an XML file with the settings for your email account (IMAP, SMTP addresses). To get this working with your domain, you need to setup a website called autodiscover.your-email.domain (for every domain you provide email for, irritating I know). Use the nginx config as an example. Then, add a cname or a record of autodiscover.your-email-domain.com pointing to the server where you have just setup the autodiscover website. Thats pretty much it. Thunderbird always works, Outlook is (unsurprisingly) very hit or miss. Issues? [Post a new one on the git repository](https://github.com/MrSleeps/VExim-Web-UI/issues "Post a new one on the git repository"). ### Health Score 43 — FairBetter than 89% of packages Maintenance97 Actively maintained with recent releases Popularity3 Limited adoption so far Community8 Small or concentrated contributor base Maturity57 Maturing project, gaining track record Bus Factor1 Top contributor holds 88.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~5 days Total 7 Last Release 20d ago Major Versions v1.1.1 → v2.0.0-beta2026-07-02 ### Community Maintainers ![](https://www.gravatar.com/avatar/b0d2338d0efd6e735e169d38dbd5221b70eb0e547f5bb4c98717623163e6374e?d=identicon)[MrSleeps](/maintainers/MrSleeps) --- Top Contributors [![MrSleeps](https://avatars.githubusercontent.com/u/9741713?v=4)](https://github.com/MrSleeps "MrSleeps (40 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)") --- Tags frameworklaraveleximVExim2 ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/mrsleeps-vexim-web-ui/health.svg) ``` [![Health](https://phpackages.com/badges/mrsleeps-vexim-web-ui/health.svg)](https://phpackages.com/packages/mrsleeps-vexim-web-ui) ``` ### Alternatives [nasirkhan/laravel-starter A CMS like modular Laravel starter project. 1.4k2.7k](/packages/nasirkhan-laravel-starter)[unopim/unopim UnoPim Laravel PIM 10.8k2.5k](/packages/unopim-unopim)[aureuserp/aureuserp Open Source ERP Solution built on Laravel for Small and Medium Enterprises (SMEs) and large-scale enterprises. 11.7k1.1k](/packages/aureuserp-aureuserp)[codewithdennis/larament Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow. 4041.8k](/packages/codewithdennis-larament)[ercogx/laravel-filament-starter-kit This is a Filament v5 Starter Kit for Laravel 13, designed to accelerate the development of Filament-powered applications. 461.8k](/packages/ercogx-laravel-filament-starter-kit)[raugadh/fila-starter Laravel Filament Starter. 625.2k](/packages/raugadh-fila-starter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)