[](http://vibed.org)
vibe.d is a high-performance asynchronous I/O, concurrency and web application
toolkit written in D. It already contains many supplemental features such as
database support to be able to offer a complete development environment. For
more specialized needs, there are also many compatible
[DUB packages](https://code.dlang.org/?sort=updated&category=library.vibed)
available.
Visit the website at for more information and
[documentation](https://vibed.org/docs).
[](https://code.dlang.org/packages/vibe-d)
[](https://github.com/vibe-d/vibe.d/actions/workflows/ci.yml)
[](https://ci.appveyor.com/project/s-ludwig/vibe-d/branch/master)
Hello Vibe.d
------------
```d
#!/usr/bin/env dub
/+ dub.sdl:
name "hello_vibed"
dependency "vibe-d" version="~>0.9.0"
+/
import vibe.vibe;
void main()
{
listenHTTP("127.0.0.1:8080", (req, res) {
res.writeBody("Hello Vibe.d: " ~ req.path);
});
runApplication();
}
```
Download this file as `hello.d` and run it with [DUB](https://github.com/dlang/dub):
```
> dub hello.d
```
(or `chmod +x` and execute it: `./hello.d`)
Alternatively, you can quickstart with examples directly on [](https://run.dlang.io/is/qTsfv6).
Project structure
-----------------
The vibe.d project is structured into multiple repositories:
- `vibe-d` (this repository): The high level web and REST framework, HTTP, STMP and Redis/MongoDB functionality
- [`vibe-http`](https://github.com/vibe-d/vibe-http): HTTP client/server implementation including WebSockets, proxy, sessions etc.
- [`vibe-stream`](https://github.com/vibe-d/vibe-stream): Advanced stream types and TLS stream support
- [`vibe-inet`](https://github.com/vibe-d/vibe-inet): Internet standard functionality (URL, form encoding, HTML encoding, ...)
- [`vibe-core`](https://github.com/vibe-d/vibe-core): Fiber based I/O and concurrency implementation
- [`vibe-serialization`](https://github.com/vibe-d/vibe-serialization): Serialization and structured data format support
- [`vibe-container`](https://github.com/vibe-d/vibe-container): Container implementations used throughout the project
- [`vibe-sdl`](https://github.com/vibe-d/vibe-sdl): [SDLang](https://sdlang.org) serialization support based on [`sdlite`](https://github.com/s-ludwig/sdlite)
- [`vibe-compat`](https://github.com/vibe-d/vibe-compat): Legacy functionality
- [`observable`](https://github.com/vibe-d/observable): Observable, signal/slot and reactive value implementations
- [`diet`](https://github.com/rejectedsoftware/diet-ng): pug.js inspired compile-time HTML template system with `vibe.web` integration
- [`eventcore`](https://github.com/vibe-d/eventcore): Low-level abstraction over the operating system's asynchronous I/O facilities
You can find an API overview of the whole project in the [API documentation](https://vibed.org/api/).
Support
-------
Vibe.d supports the 10 latest minor releases of DMD.
For example, if the current version is v2.090.1,
then v2.089.x, v2.088.x, ... v2.080.x are supported.
Note that support for patch release is desireable,
but only support for the last patch in a minor is guaranteed.
Additionally, Vibe.d supports all LDC versions that implement
the version of a supported frontend (e.g. by the previous rule
[LDC v1.20.0](https://github.com/ldc-developers/ldc/releases/tag/v1.20.0)
implements v2.090.1 and would be supported).
Installation
------------
Instead of explicitly installing vibe.d, it is recommended to use
[DUB](https://github.com/dlang/dub) for building vibe.d based
applications. Once DUB is installed, you can create and run a new project
using the following shell commands:
dub init -t vibe.d
cd
dub
Similarly, you can run an example by invoking `dub` from any of the
example project directories.
Note that on non-Windows operating systems, you also need to have
OpenSSL installed - and of course a D compiler. See below
for instructions.
Additional setup on Windows
---------------------------
- Just install DMD using the installer on
- And get the latest [DUB release](https://code.dlang.org/download)
Additional setup on Mac using brew
----------------------------------
If you don't have brew installed, install it according to their [install
instructions]().
You can then also install DUB using brew:
brew install dub
(Note: Install brew only if you do not have macports, as they will conflict)
Install DMD using the installer on .
Optionally, run `./setup-mac.sh` to create a user/group pair for privilege lowering.
Additional setup on Linux (Debian/Ubuntu/Mint)
----------------------------------------------
Install vibe.d's dependencies:
sudo apt-get install libssl-dev
On 32-bit linux: Install DMD-i386
sudo apt-get install g++ gcc-multilib xdg-utils
wget "http://downloads.dlang.org/releases/2.x/2.098.0/dmd_2.098.0-0_i386.deb"
sudo dpkg -i dmd_2.098.0-0_i386.deb
On 64-bit linux: Install DMD-amd64
sudo apt-get install g++ gcc-multilib xdg-utils
wget "http://downloads.dlang.org/releases/2.x/2.098.0/dmd_2.098.0-0_amd64.deb"
sudo dpkg -i dmd_2.098.0-0_amd64.deb
Optionally, run `./setup-linux.sh` to create a user/group pair for privilege lowering.
Additional setup on Linux (generic)
-----------------------------------
You need to have the following dependencies installed:
- [DMD 2.088.1 or greater](http://dlang.org/download)
- [libssl](http://www.openssl.org/source/)
Optionally, run `./setup-linux.sh` to create a user/group pair for privilege lowering.
Additional setup on FreeBSD
---------------------------
Install the DMD compiler and vibe.d's dependencies using portupgrade or a similar mechanism:
sudo portupgrade -PN devel/pkgconf
Optionally, run `./setup-freebsd.sh` to create a user/group pair for privilege lowering.
Switching between OpenSSL versions
----------------------------------
By default, vibe.d is built against OpenSSL 1.1.x. On systems that use the older
1.0.x branch, this can be overridden on the DUB command line using
`--override-config vibe-d:tls/openssl-1.0`. Alternatively, the same can be done
using a sub configuration directive in the package recipe:
SDL syntax:
```
dependency "vibe-stream:tls" version="~>1.0"
subConfiguration "vibe-stream:tls" "openssl-1.0"
```
JSON syntax:
```
{
...
"dependencies": {
...
"vibe-stream:tls": "~>1.0"
},
"subConfigurations": {
...
"vibe-stream:tls": "openssl-1.0"
}
}
```
Finally, there is a "botan" configuration for using the D port of the Botan
library.